NanoClaw 是什么?3.1 万星的 OpenClaw 精简版,把每个 Agent 关进独立容器(基础篇)

NanoClaw 是什么?3.1 万星的 OpenClaw 精简版,把每个 Agent 关进独立容器(基础篇)

OpenClaw 今年火到 39.4 万星,但它的代码量也一起火:43.4 万行运行时 TypeScript、3,680 个文件、53 个配置文件、70 多个直接依赖,所有东西跑在一个 Node 进程里共享内存,安全靠应用层的白名单和配对码。有个在 Wix 写了七年代码的工程师 Gavriel Cohen 看不下去,1 月 31 日扔出一个重写版:同样连 WhatsApp、Telegram、Slack,同样有记忆和定时任务,但只有约 2.9 万行代码,每个会话单独塞进一个 Docker 容器。半年多,这个叫 NanoClaw 的项目攒到 3.1 万星、1.27 万 fork。

NanoClaw 是什么:一个能被读完的个人 Agent

一句话:它是跑在你自己机器上的个人 AI 助手,你用聊天软件跟它说话,它在容器里干活。

  • 体量:31,098 星、12,661 fork、MIT 协议、TypeScript,2026 年 1 月 31 日创建,最新正式版 v2026.10.0(10 月 9 日),9 月 23 日刚发过 v2.4.0。
  • 渠道:WhatsApp、Telegram、Slack、Discord、Microsoft Teams、iMessage、Signal、Matrix、Google Chat、Webex、Linear、GitHub、微信,邮件走 Resend。全装或只装一个都行。
  • 模型:默认跑 Anthropic 官方 Agent SDK(也就是 Claude Code 那套工具链),Codex、OpenCode、Cursor、Ollama 按 agent group 单独配。
  • 文档:官方有中文 README,站点 docs.nanoclaw.dev。

有个数字比星数更能说明它的分发方式:fork/star 比 40.7%。OpenClaw 是 21%。README 里写得很直白:「你 fork 一份,让 Claude Code 按你的需求改」。它不追求大而全,只做成一份你能改得动的代码。

它到底怎么跑:一个宿主,一堆容器

官方架构页把结构压成一句话:一个 Node 宿主、每个活跃会话一个 Docker 容器、一对 SQLite 队列在边界上搬消息。

拆开看是四层:

  1. 渠道层进来一条消息,宿主进程按会话路由,写进 inbound.db,然后唤醒对应的容器。
  2. 容器层里跑 Bun 和你选的 provider,模型这一轮的实际动作(读写文件、跑命令、调工具)全在容器内完成,它只能看见你显式挂载进去的目录。
  3. 回复写进 outbound.db,宿主轮询取走,再按原渠道流式推回去。
  4. 凭证根本不进容器:出站 HTTPS 走 OneCLI 的 Agent Vault,请求时才注入密钥,并按 agent 做策略和限流。
NanoClaw 运行架构:Node 宿主进程经 SQLite 队列唤醒会话容器,模型调用经 Agent Vault 注入凭证
一个宿主进程、每会话一个容器、一对 SQLite 队列,凭证走网关不进容器

再往上一层是 agent group:每个组有自己的 CLAUDE.md、自己的记忆树、自己的容器和挂载列表。组和组之间默认不通,除非你手动接线。v2 把隔离方式做成按渠道可选:一个渠道一个私有 agent、多个渠道共用一个 agent 共享记忆,或者合成一个跨平台的会话。

渠道和模型供应商都不是主干代码,而是「技能」:跑 /add-telegram、/add-codex,技能会把对应的模块拷进你的 fork。主干只留注册表和基础设施,你不会背上一堆没用到的集成。

上手:一条脚本,剩下交给 Claude Code

要求不低:Node 22+、git、Docker(macOS 用 Apple 容器或 Docker,Windows 走 WSL2)、大约 4GB 内存,默认占 3000 端口做 webhook。

git clone https://github.com/nanocoai/nanoclaw.git nanoclaw-v2
cd nanoclaw-v2
bash nanoclaw.sh

nanoclaw.sh 会替你装 Node、pnpm、Docker,装一个凭证网关并把 Anthropic 凭证注册进去,构建 agent 镜像,再配对第一个渠道(Slack、Telegram、Discord、WhatsApp、iMessage 或本地 CLI)。哪一步失败,它会自动叫 Claude Code 来诊断、从断点续跑,安装流程本身就是「脚本走大路,判断交给 Agent」。

装完用触发词说话,默认是 @Andy:

@Andy 每个工作日早上 9 点给我一份销售管道概览(可以读我的 Obsidian 目录)
@Andy 每周五看一遍这周的 git 历史,README 有漂移就更新

它没有配置文件。想改触发词、改回复风格、加个问候语,直接让 Claude Code 改代码。这是它最反常识的一条:配置即代码,因为代码小到改起来不怕。v1 升 v2 用仓库里的 migrate-v2.sh,会迁移状态、群组目录、会话数据和定时任务,但不会自动切换系统服务,切不切你自己定。

实话:三个代价,别只看星数

第一,社区规模撑不起它的 issue 量。 现在挂着一千多个 open issue,贡献者 132 人,但近期提交高度集中在两三个维护者身上。发版节奏不算慢,稳定版大约两周一发,可你遇到的问题大概率得自己动手。

第二,热度已经过了峰值。 上线一周破 7,000 星,3 月破 2 万星并完成 Docker 集成,但最近一个月只涨了两百来个星。这不影响它能不能用,只说明「社区帮你踩坑」这件事别抱太大期望。

第三,安全方案自己也会翻车。 2026.10.0 是第一个改用日历版本号的版本,同时要求 OneCLI 网关必须升到 1.42.0,修的是一个凭证注入绕过;1.43 及以上反而会破坏凭证分配,暂时不支持。容器隔离把爆炸半径压小了,但边界上的凭证网关是新的一层,也就成了新的攻击面。

还有两点要有心理准备:默认绑 Anthropic,想用国产模型得走 OpenCode 或 Ollama 技能,不是开箱即用;开源核心是 MIT,但加固镜像、托管 Slack app 这些 perks 要注册免费账号,商业闭环已经开始搭了。

适合谁:有一台常开的小主机或 NAS,想在微信、Telegram 里直接使唤 Agent,又不愿意把整台机器的权限交给一个四十多万行、自己读不完的项目。不适合谁:要企业多租户、要现成可视化后台、要开箱即用中文界面的团队。

Agent 这半年的竞争点已经从「能不能干活」挪到「干砸了炸多大」。NanoClaw 的答案很土:把每个会话关进一个盒子,盒子里只有你挂进去的东西。功能列表谁都能抄,这个盒子不好抄。

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注