Sep 19, 2026

NanoClaw:把个人 AI 助理装进容器,在聊天应用里随时唤起

这个 31k 星的项目是有意做小的 OpenClaw 替代方案:每个 agent 独占一个 Docker 容器,出现在 WhatsApp、Telegram、Slack 等聊天应用里,且从不经手你的原始 API 密钥。

#tutorial#agent-tools#deployment

住在聊天应用里的个人助理 agent,通常意味着把账户钥匙交给一个庞大而不透明的代码库。NanoClaw——31k 星——给出另一种方案:单进程、寥寥数个源文件,每个 agent 都被关进自己的 Linux 容器。

为什么这个 Skill 重要

README 的动机一节把拒绝的对象写得很明白。按作者的说法,OpenClaw 有接近五十万行代码、53 个配置文件、70 多个依赖,安全停留在应用层而非真正的操作系统级隔离。NanoClaw 保留了核心功能——一个你可以发消息的 agent——同时减轻信任问题:agent 只能看到显式挂载的目录;出站请求经由 OneCLI 的 Agent Vault 在请求时注入凭证,agent 从不持有原始 API 密钥。

渠道按需以 skill 形式安装:WhatsApp、Telegram、Discord、Slack、Microsoft Teams、iMessage、Matrix、Google Chat、Webex、Linear、GitHub、微信,以及经 Resend 的邮件。运行 /add-telegram,对应的 skill 只把你需要的模块复制进你的 fork。定制同理——没有配置文件,你直接告诉 Claude Code 要改什么,或运行 /customize。

安装

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

脚本会把一台全新的机器一路带到「可以发消息的命名 agent」:缺 Node、pnpm、Docker 就安装;向 OneCLI 注册你的 Anthropic 凭证;构建 agent 容器;配对第一个渠道——Slack、Telegram、Discord、WhatsApp、iMessage 或本地 CLI。某一步失败时,它会交给 Claude Code 诊断并从断点恢复。系统要求为 macOS、Linux 或经 WSL2 的 Windows;/customize、/debug 与 /add-<channel> 系列 skill 需要 Claude Code。

实战:安排一份晨间简报

  1. 设置完成后,在配对的渠道里用触发词(默认 @Andy)给 agent 发消息。
  2. 布置周期任务:
@Andy every Monday at 8am, compile news on AI developments from Hacker News and TechCrunch and message me a briefing
  1. 在聊天里管理它:@Andy list all scheduled tasks across groups,然后 @Andy pause the Monday briefing task。

宿主进程的 60 秒轮询会在任务到期时唤醒容器;可选的前置脚本检查(script gates)让它在没有实际工作时继续沉睡。

实战:加第二个渠道或换模型

/add-telegram 加渠道;/add-opencode 接入 OpenRouter、Google、DeepSeek 等更多后端;/add-ollama-provider 接本地开放权重模型。渠道适配器在仓库的 channels 分支,提供商在 providers 分支;对应的 skill 只把你点名的模块复制进 fork。提供商可按 agent 分组配置,同一套安装里不同 agent 可以跑在不同后端上。

技巧

  • 没有监控面板——调试方式就是「问 Claude Code」:「调度器为什么没跑?」这类问题是受支持的调试入口。
  • NanoClaw 默认不需要用户账户,只上报匿名的安装诊断;NANOCLAW_NO_DIAGNOSTICS=1 连这个也能关掉。
  • 用 bash nanoclaw.sh --uninstall 做外科手术式卸载;它按 agent 分组逐一确认,并提供 --dry-run 预览。
  • 整个架构在 README 里就是一行:聊天应用、宿主进程、入站数据库、容器(Bun、Claude Agent SDK)、出站数据库、投递。

何时不用这个 Skill

Windows 原生环境不支持(仅 WSL2),且必须有 Docker,这不是零依赖安装。它也是消息优先的个人助理运行时,不是编辑器里的编码 agent。「定制即改码」的哲学是双刃剑:定制意味着在你自己的 fork 里改代码,并由你维护。


查看 排行榜 了解更多 skill。