Skip to content
Agents tracked: 501 Releases (7d): 777 Agent status: no reported issuesSince last limit reset: Claude 10d · Codex 8d For AI agents: Markdown Updated Nov 21, 2026

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.

General-purpose AI agents Open-source containerised personal AI agentOpen source · MITFree to start

Use it in: CLI Slack, Teams, Telegram Self-hosted Works with: MCP Local models Own API key Multi-agent Headless / CI

Price
Free (OSS)
free and open source
Popularity
#24 in General
Gid Score 28 / 100 · #180 of 255 ranked AI agents
Trend
Gaining stars
about +7 GitHub stars a day
Development
Updated recently
latest 2026.11.0, yesterday
Community
31.1K GitHub stars
public signals

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

MakerNanoCo
TypeOpen-source containerised personal AI agent
First releasedJanuary 2026
LicenseMIT
InterfacesCLI, Messaging apps, Self-hosted
Main languageTypeScript
Open issues and PRs1,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

Full monthly summary

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.

Action needed: OneCLI installs must upgrade the OneCLI gateway to exactly 1.42.0.
  • 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.

Compare NanoClaw with another agent

vs
# 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 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
Muse NewMeta
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

All AI agent news

  1. Release GitHub Releases

    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

2026.11.0
  • 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.
2026.10.0
  • [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
2.4.0
  • [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…
2.3.0
  • [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.
2.2.0
  • 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.
2.1.54
  • [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

Full pricing history →

NanoClaw plan pricesfrom archived copies of the official pricing page
Cheapest paid planMost expensive self-serve plan
Token prices of Anthropic modelsnewest Anthropic model in each family, output price per 1M tokens
Anthropic OpusAnthropic SonnetAnthropic Haiku

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.

GitHub starsrunning total 31.1K
Hacker News mentionsposts and comments, rolling 7-day total 0 this week
Website rankTranco list; a lower rank means more traffic #310,346

Download the raw daily series: nanoclaw.csv

Gid Score breakdown

Adoption17
Community62
Attention0
Momentum50

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

NumberLatest readingLast checked
GitHub starsNov 21, 2026Nov 21, 06:26 UTC
Website rank (Tranco)Nov 20, 2026Nov 21, 06:32 UTC
Hacker News mentionsNov 20, 2026Nov 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:

AgentGid: #24 in General Gid Score: 28/100

[![AgentGid: #24 in General](https://agentgid.com/badges/nanoclaw-rank.svg)](https://agentgid.com/agents/nanoclaw/)
[![Gid Score: 28/100](https://agentgid.com/badges/nanoclaw-score.svg)](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.