- Each agent gets only the keys you give it. OneCLI moves to 1.45, where new agent groups get only their model key and other keys go to the groups you choose.
- Agents can create other agents from templates. Ask for one in chat, or pick one from ncl templates list or the public library.
- Cursor is an agent provider. Run /add-cursor, or pick Cursor in setup, and your agents run on Cursor's Agent SDK.
- Cards can show KPI fields, a table and charts. Agents put them in send_card cards, and Slack draws them natively.
- Newer models. Locally built agent images run Claude Code 2.1.321 with Claude Haiku 5.5 and know Claude Fable 5.2. Codex groups signed in with ChatGPT can use GPT-6.2 Astra and GPT-6.2 Sol.
- [BREAKING] Chat SDK channels move to adapter 4.41.1, which fixes Telegram messages with links that were never delivered.
NanoClaw by NanoCo
A small TypeScript assistant that runs each agent in its own Linux container and connects to messaging apps such as Slack, Telegram, WhatsApp and Discord, with per-agent memory and scheduled tasks; built on the Claude Agent SDK with optional other providers.
Use it in: CLI Slack, Teams, Telegram Self-hosted Works with: MCP Local models Own API key Multi-agent Headless / CI
On this page
Usage data: latest readings Nov 20 to Nov 21, 2026, last checked Nov 21, 06:32 UTC. Date of each number
What NanoClaw does
NanoClaw is an open-source containerised personal AI agent from NanoCo, first released in January 2026. You use it through a command-line tool, messaging apps and self-hosted. Its documentation covers MCP servers, subagents or parallel agents, a non-interactive mode for scripts and CI, your own API key and local models. It can run models from Anthropic, OpenAI, OpenRouter, Google and DeepSeek. It is free and open source (MIT); you pay only for the models it calls.
Key facts
| Maker | NanoCo |
|---|---|
| Type | Open-source containerised personal AI agent |
| First released | January 2026 |
| License | MIT |
| Interfaces | CLI, Messaging apps, Self-hosted |
| Main language | TypeScript |
| Open issues and PRs | 1,059 |
Pricing
Free MIT-licensed software; model usage is billed by the chosen provider.
Source: official pricing page, checked Oct 6, 2026. Prices change often; confirm before you buy.
NanoClaw pricing history since 2024 · Compare prices of all agents
Quick answers
- Free to start?Yes
- Open source?Yes (MIT)
- Where you use itCLI, Messaging apps, Self-hosted
- Supports MCP?Yes
- Model providersanthropic, openai, openrouter, google, deepseek, local
- Subagents / multi-agent?Yes
- Runs in scripts / CI?Yes
- Feature comparisonAll agents
- Closest alternativeOpenClaw · all alternatives
What's new in NanoClaw: October 2026
October brought security updates, improved proxy handling, and better visibility into what's happening during failures. The release channels system now lets you control update timing across your installations.
- OneCLI gateway users must upgrade to 1.42.0 to close a credential-injection security bypass.
- Update channels let you choose stable, beta, or edge per installation, with tracking in upgrade-state.json.
- Failed Claude runs now show clear error messages telling you what went wrong and who can fix it.
- Keyless models can now reach Iron Proxy over plain HTTP on the same machine.
1 release this month · summarised from the official release notes · all months
Get started with NanoClaw
Setup instructions are in the official documentation.
NanoClaw alternatives
Best NanoClaw alternatives compared · All general-purpose AI agents
| # | Agent | Gid Score | Downloads 7d | 7d | 30d | Stars | Latest release | Price | |||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 8 |
OpenClawOpenClaw Foundation (nonprofit); created by Peter Steinberger |
70 | 2.8M | down 8.7% | down 27.1% | 395K+123/day | 2026.11.62d ago | Free (OSS) | |||
| 11 |
DeepSeek HarnessDeepSeek |
67 | 676K | down 14.9% | up 59.0% | 285K+622/day | — | Free | |||
| 14 |
Hermes AgentNous Research |
63 | 56.8K | down 26.1% | — | 265K+297/day | 0.23.3yesterday | Free (OSS) | |||
| 42 |
ManusButterfly Effect Pte. Ltd. (Manus AI), Singapore |
50 | — | — | — | — | — | $20/mo | |||
| 58 |
Cloudflare OSCloudflare |
46 | — | — | — | 11.8K+9/day | — | Free (OSS) | |||
| 63 |
|
452/4 | — | — | — | — | — | Free | |||
Ratings from people who use NanoClaw
No ratings yet. Used NanoClaw? Rate it and say what it is good and bad at.
NanoClaw news
-
NanoClaw 2026.11.0 released
Each agent gets only the keys you give it. OneCLI moves to 1.45, where new agent groups get only their model key and other keys go to the groups you choose.; Agents can create other agents from templates. Ask for one in chat, or pick one from ncl templates…
What changed: recent NanoClaw releases
4 stable releases in the last 90 days · Monthly summary · Full changelog
- [BREAKING] OneCLI installs: upgrade the OneCLI gateway to exactly 1.42.0, which closes a credential-injection bypass.
- /update-nanoclaw now installs the newest release, not the tip of main. The channel is set by NANOCLAW_UPDATE_CHANNEL in .env: stable (the default) follows releases, edge follows main as before…
- Iron Proxy installs: rerun the Iron setup once after updating. It rebuilds the proxy on upstream v0.52.0 (expired proxy certificates are regenerated, host rules match case-insensitively), moves…
- Updates follow release channels. Choose stable, beta or edge per install; the channel and the exact release are recorded in data/upgrade-state.json, so support can see what an install tracks.
- With Iron Proxy, a keyless model on the same machine works over plain HTTP. Enter and restart.
- The service can reach the internet through an outbound proxy. It now uses HTTPS_PROXY, HTTP_PROXY or ALL_PROXY and NO_PROXY from your setup shell or .env.
Earlier releases
- [BREAKING] Custom source that composes agent instructions must move to the new module.
- [BREAKING] Forks that merge upstream by hand must install their credential gateway before restarting.
- Claude groups with no model set move to Opus 5.5, which changes cost and usage-limit burn. API-key installs move from Opus 5, and Pro and Team Standard installs from Sonnet.
- Codex groups with no model set start new threads on gpt-6-astra. /add-codex now pins @openai/codex 0.155.1, whose default replaces 0.146.0's gpt-5.6-sol.
- Claude agents default to a concise tone. A Claude group whose settings do not set an output style now starts with Concise.
- Existing OpenCode installs must refresh the skill payload. The optional /add-opencode skill now uses the native provider contracts and the new contract refuses the old payload: re-run…
- [BREAKING] A new Slack experience — per-agent provisioned Slack apps, agent spawning from Slack, and UX improvements — is available to classic single-bot Slack installs.
- /add-codex now pins @openai/codex 0.146.0. The previous pin (0.138.0) defaults to GPT-5.4, which OpenAI retires from Codex on 2026-08-31 — codex-provider agents ride the CLI default model, so…
- [BREAKING] Agent mailbox access now goes through storage-neutral host and runner registries.
- Scheduled-task lifecycle semantics are stricter. Deleting an isolated task cascades its session state, updates refuse already-due runs, recurring selection uses the active series snapshot, and…
- [BREAKING] The container runtime moves behind the session driver seam. Session containers are composed as a validated, admission-checked spec and realized by a selectable driver (src/drivers/.
- Host restarts now adopt running sessions instead of restarting them. A service restart no longer kills in-flight agent work.
- Stamped plugins update in place through ncl groups create --template <ref>. When a group already carries the template's plugin, the same command becomes an in-place update instead of minting a…
- [BREAKING] Agent templates are now Agent Plugins 1.0.0 directories. plugin.json replaces context/instructions.md as the required file; MCP servers move to a spec-shaped mcp.json.
- Plugin MCP servers may declare a working directory. cwd in mcp.json (fixed forms ./p, ${PLUGIN_ROOT}[/p], ${PLUGIN_DATA}[/p]) now launches the server in that directory instead of being skipped…
- Setup can stamp the first agent from a template. The wizard offers the NanoClaw template library (or local templates/) when creating the first agent.
- Remote MCP servers can use Streamable HTTP. Register them with ncl groups config add-mcp-server --name <name> --url <url> or the existing admin-approved add_mcp_server tool.
- [BREAKING] Host modules now use one lifecycle registry. Custom modules that import onShutdown() or getShutdownCallbacks() from response-registry.ts must move to the host lifecycle API.
- [BREAKING] iMessage unified into one imessage channel with two backends via /add-imessage: Local (this Mac's chat.db via the Chat SDK) or Hosted (native Photon via spectrum-ts, no Mac relay).
- [BREAKING] Provider-agnostic memory. All providers now share one OKF v0.1-compatible memory/ tree, while persona lives in instructions.prepend.md.
- New groups can inherit an instance-wide default provider. DEFAULT_AGENT_PROVIDER sets the provider used when a new agent group is created without an explicit provider.
- [BREAKING] Channel install skills are now the single source of truth. The setup wizard installs channels by applying the same /add-<channel> SKILL.md a coding agent would follow — a deterministic…
- One guard for privileged actions. Every privileged action crossing the container or channel boundary now passes through guard() before execution: allow, hold, or deny.
- [BREAKING] whatsapp-formatting and slack-formatting moved from trunk to the channels branch.* They now install with their channel, so installations without those channels no longer carry…
NanoClaw prices over time
NanoClaw popularity and usage data
The GitHub repository has 31.1K stars, 254 of them added in the last 30 days. The latest stable release is 2026.11.0, published Nov 20, 2026; there was 1 stable release in the past 30 days. It was mentioned in 5 Hacker News posts and comments over the last 30 days.
Download the raw daily series: nanoclaw.csv
Gid Score breakdown
Gid Score shows public popularity and activity (usage, GitHub stars, mentions, growth), not the quality of the product. Each component is scored 0 to 100 from public signals; a dash means no data for it. How the Gid Score works.
How fresh these numbers are
| Number | Latest reading | Last checked |
|---|---|---|
| GitHub stars | Nov 21, 2026 | Nov 21, 06:26 UTC |
| Website rank (Tranco) | Nov 20, 2026 | Nov 21, 06:32 UTC |
| Hacker News mentions | Nov 20, 2026 | Nov 21, 06:27 UTC |
We fetch every source once a day. Registries publish downloads and page views a day or two late, so their latest reading trails the check. A reading more than 4 days old is marked out of date; the Gid Score still uses it until a newer one arrives.
NanoClaw FAQ
How much does NanoClaw cost?
Free MIT-licensed software; model usage is billed by the chosen provider.
Is NanoClaw open source?
Yes. NanoClaw is open source, released under the MIT license.
How popular is NanoClaw?
The GitHub repository has 31.1K stars, 254 of them added in the last 30 days. The latest stable release is 2026.11.0, published Nov 20, 2026; there was 1 stable release in the past 30 days. It was mentioned in 5 Hacker News posts and comments over the last 30 days.
What is the latest version of NanoClaw?
The latest stable release we track is 2026.11.0, published on Nov 20, 2026.
What are the alternatives to NanoClaw?
The closest alternatives in the same category by Gid Score are OpenClaw, DeepSeek Harness, Hermes Agent, Manus.
For the makers of NanoClaw badges, corrections
Add a live badge to your README or site:
[](https://agentgid.com/agents/nanoclaw/)
[](https://agentgid.com/agents/nanoclaw/)
Something wrong or outdated on this page? Send a correction with a link to the official source. More for makers.
Where these numbers come from
GitHub: nanocoai/nanoclaw. Site rank: nanoclaw.dev on the Tranco list. See data sources for how each one is collected.
Product facts and pricing were checked against: github.com, nanoclaw.dev.