星标数:31113★ Fork数:12641 《nanoclaw:运行在容器中的轻量级 AI 助手》
NanoClaw 是一款 AI 助手,它让各个智能体(agent)在各自独立的容器中安全运行。项目轻量、易于理解,并且可以完全按照你的需求进行定制。

作者选择创建 NanoClaw,是因为 OpenClaw 虽然功能强大,但代码量庞大(接近 50 万行代码、53 个配置文件、70 多个依赖),且安全措施停留在应用层(白名单、配对码),而非真正的操作系统级隔离——所有内容都运行在同一个 Node 进程中并共享内存。
NanoClaw 提供了同样的核心功能,但代码库小到足以让人理解:一个进程和少量文件。智能体运行在各自的 Linux 容器中,拥有文件系统隔离,而不仅仅是依赖权限检查。
主要特点
- 多渠道消息——支持 WhatsApp、Telegram、Discord、Slack、Microsoft Teams、iMessage、Matrix、Google Chat、Webex、Linear、GitHub、WeChat 以及通过 Resend 收发邮件;通过 /add-<channel> 技能按需安装,可同时运行一个或多个渠道。
- 容器隔离——智能体被沙箱化在 Docker 容器中(支持 macOS/Linux/WSL2),只能看到显式挂载的内容,Bash 命令在容器内而非宿主机上执行。
- 凭证安全——智能体从不持有原始 API 密钥;出站请求经由凭证网关路由,在请求时注入凭证,并执行按智能体的策略和速率限制。
- 每个智能体独立工作区——每个智能体组拥有自己的 CLAUDE.md、自己的记忆、自己的容器,以及你允许的挂载内容。
- 定时任务——由智能体执行的周期性任务,可选脚本门控(script gates),在没有工作时避免唤醒智能体。
- Agent 模板——通过 ncl groups create –template <ref> 从可复用的包中生成一个可直接运行的智能体(指令 + MCP 工具 + 技能,不含密钥)。
快速开始
git clone https://github.com/nanocoai/nanoclaw.git nanoclaw-v2
cd nanoclaw-v2
bash nanoclaw.sh
nanoclaw.sh 会引导你从一台全新机器走到一个可以发消息的具名智能体:安装缺失的 Node、pnpm 和 Docker,安装凭证网关并注册你的 Anthropic 凭证,构建智能体容器,并配对第一个渠道(Slack、Telegram、Discord、WhatsApp、iMessage 或本地 CLI)。如果某一步失败,会自动调用 Claude Code 诊断并从中断处恢复。
📊 本项目 GitHub 星标数:31113。最后更新:2026-11-12,发布:2026-11-12。项目地址:https://github.com/nanocoai/nanoclaw
