nanocoai/nanoclaw

NanoClaw – 安全、容器隔离的 AI 助手

它是什么

• 一个开源框架，允许你在独立的 Docker 容器中运行 AI 代理（Claude、OpenAI、Ollama 等）。每个代理都有自己的文件系统、内存和凭据，因此宿主机与模型的执行环境保持隔离。
• 设计精简且易于理解：单个 Node.js 进程编排一切，核心代码仅存在于少数几个文件中。

核心能力

功能	描述
代理级容器隔离	每个代理都在其自己的 Linux 容器中运行；只有你明确挂载的目录对它可见。
多渠道消息传递	内置 Slack、Discord、Telegram、WhatsApp、iMessage、Microsoft Teams、Matrix、Google Chat、Webex、Linear、GitHub、WeChat、电子邮件（通过 Resend）以及本地 CLI 的适配器。通过 /add-<channel> 技能按需添加新适配器。
凭据网关	API 密钥永远不会触及容器。出站请求通过凭据网关服务（默认为 OneCLI 的 Agent Vault）进行代理，该服务为每个代理注入正确的密钥并强制执行速率限制。
代理模板	从存储在 templates/ 或公共模板库中的模板快速启动一个即用型代理。
定时任务	定义循环作业（例如每日简报），容器仅在需要时执行这些作业，并可选择通过脚本门控进行保护。
混合 AI 原生工作流	安装和错误恢复均已脚本化，但当步骤需要判断时，系统会移交给 Claude Code（Anthropic 的“代码助手”），它可以自动诊断并继续执行。
零配置定制	无需编辑庞大的配置文件，你只需告诉 Claude Code 你的需求（例如更改触发词），它就会为你修补源代码。
跨模型支持	Claude 是默认提供程序，但你可以通过简单的 /add-<provider> 命令添加 OpenAI Codex、通过 OpenCode 使用 OpenRouter、Cursor 的本地 SDK 或任何 Ollama 模型。

安装与快速入门

git clone https://github.com/nanocoai/nanoclaw.git nanoclaw-v2
cd nanoclaw-v2
bash nanoclaw.sh   # 安装 Node、pnpm、Docker（如果需要），注册 Anthropic 凭据，构建第一个代理容器，并配对一个渠道（Slack、Telegram 等）

脚本会引导你完成每一步；如果出现故障，会自动调用 Claude Code 进行调试并恢复。

如何与代理交互

• 选择一个触发词（默认为 @Andy）。
• 在任何连接的渠道中发送自然语言命令，例如：

  @Andy send an overview of the sales pipeline every weekday morning at 9 am (has access to my Obsidian vault folder)
  @Andy review the git history for the past week each Friday and update the README if there’s drift
  

• 使用聊天命令管理群组、任务和渠道连接，例如 @Andy list all scheduled tasks 或 @Andy join the Family Chat group。

扩展 NanoClaw

• 技能 (Skills) – 新功能以技能而非核心功能的形式添加。技能位于其自己的文件夹 (payload/) 中，并通过斜杠命令 (/add-telegram, /add-opencode 等) 安装。
• 渠道 (Channels) – 渠道适配器位于专门的 channels 分支上；你可以 fork 仓库，添加自定义适配器，并将其复制到你自己的安装中。
• 提供程序 (Providers) – 替代的 LLM 后端以相同方式添加，保持主代码库最小化。

安全模型

• 操作系统级隔离 – Docker 容器为每个代理提供自己的 PID、网络命名空间和文件系统视图。
• 凭据处理 – 密钥仅存储在宿主机上，并在请求时由凭据网关注入；容器永远看不到原始密钥。
• 无用户账户 – NanoClaw 不创建云账户。唯一的出站连接是连接到可选的社区门户以获取福利（例如，加固的预构建镜像或托管的 Slack 应用）。所有诊断信息都是匿名的，可以通过 NANOCLAW_NO_DIAGNOSTICS=1 禁用。

典型用例

• 个人生产力助手，可以读取/写入私有库中的文件、安排报告并与版本控制交互。
• 安全的自托管聊天机器人，可以浏览网页、获取数据并代表用户行事，而无需暴露 API 密钥。
• 多用户团队机器人，每个团队成员拥有自己隔离的代理，但共享一个公共渠道（例如 Slack 工作区）。
• 实验平台，用于尝试不同的 LLM 提供程序，同时保持运行时环境完全一致。

社区与支持

• Discord 社区: https://discord.gg/VDdww8qS42
• 文档网站: https://docs.nanoclaw.dev
• 公共模板库: https://github.com/nanocoai/nanoclaw-templates

许可证

• MIT – 个人、学术或商业用途免费。

---

NanoClaw 旨在为高级用户提供一个透明、容器隔离的 AI 助手，他们可以理解、审计和定制它，而无需处理庞大的单体代码库。