Repository navigation
Releases
Releases · jc-morales-dev/NovaClaw
v0.1.1
NovaClaw v0.1.0 — a coding agent that runs on your phone
NovaClaw runs a full coding agent on your Android phone — embedded Linux (Termux bootstrap) + Node.js inside the APK, with a native function-calling agent, a real PTY terminal, and phone capabilities as tools. Everything on-device except the model API call. Bring your own key.
This is an early release. One person has used it — the author — on one device (OPPO CPH2557, Android 15, arm64). Expect rough edges on other phones, and please open an issue when you hit one.
Install
- Download
app-arm64-release.apkbelow. - Enable "install from unknown sources" on your phone.
- Install it. First launch downloads the base system once (~300 MB: Linux + Node) — use Wi-Fi.
- Open Settings → AI Model and paste your own API key.
Requires Android 8+ on arm64. Not on Google Play.
What it does
- Coding agent that verifies its own work: it edits, then runs the compiler or linter before calling it done
- Real terminal (PTY over WebSocket) —
vim,htop,tail -fall work - File tools, grep, web fetch and multi-source web research with citations
- Reads PDF, Word, Excel, PowerPoint and ZIP
- Phone tools behind explicit Android permissions: camera (takes a photo and sees it), GPS, contacts, calendar
- Providers: Anthropic, OpenAI, Google Gemini, OpenRouter, NVIDIA, OpenCode Zen — or sign in with your ChatGPT account, no API key needed
- MCP servers (stdio + HTTP) to plug in external tools
Security
The agent can run arbitrary code on your phone, so:
- Every shell command asks for your approval. There is no unattended path. An earlier allowlist design was bypassable — the agent could write a script and run it with an allowlisted binary — so it was removed rather than patched.
- Your API key never reaches the processes the agent spawns. Shell commands, the terminal, hooks and MCP servers all get an environment with credentials stripped. Approving one command cannot cost you your key.
- Loopback-only server with per-install token auth. No key is embedded in the binary.
Notes
targetSdk 34, running the embedded Linux under proot bundled as a native library — no root, no legacytargetSdk 28trick.- The APK bundles third-party binaries (proot under GPLv2, the Termux bootstrap) — see
THIRD-PARTY-LICENSES.mdfor the obligations that apply if you redistribute it.