nanocoai/nanoclaw
⭐ 28,735 · TypeScript · GitHub 仓库
一个轻量级的OpenClaw替代方案，运行于容器中以增强安全性。支持连接WhatsApp、Telegram、Slack、Discord、Gmail等即时通讯应用，具备内存管理、定时任务功能，并可直接运行于Anthropic的Agents SDK之上。
ai-agents ai-assistant claude-code claude-skills openclaw
一句话总结
NanoClaw：一个轻量级、容器隔离的AI智能体平台，任何开发者都能完全理解并自定义。
🔥 核心能力与独特卖点
- 容器隔离智能体，实现真正安全 — 每个智能体运行在独立的Docker容器中，具备操作系统级别的文件系统隔离，而非仅应用层级的权限检查。这使得即使是直接的bash访问也安全无虞，从根本上解决了需要执行代码或访问文件的AI助手的核心安全问题。
- 多通道消息，按需安装 — 通过
/add-<channel>技能连接WhatsApp、Telegram、Discord、Slack、Gmail等十余个平台。通道按分支安装，保持代码库精简，避免配置膨胀。 - AI原生自定义，零配置文件 — 无需YAML或JSON配置文件。你只需告诉Claude Code你的需求（例如"将触发词改为@Bob"），小巧的代码库便能让安全修改成为可能。这是传统配置管理方式的范式转变。
- 定时任务与智能体专属记忆 — 可设置周期性任务让Claude运行并回传消息，每个智能体拥有独立的记忆和工作区，配有专属的
CLAUDE.md文件。实现无需人工干预的持久化自主工作流。 - 独特卖点： NanoClaw小巧到单个开发者就能完全理解和自定义，同时仍是一个生产就绪的多通道AI助手。它是反框架的存在：可理解、安全、可直接修改。
技术架构
| 组件 | 技术栈 | 角色 |
|---|---|---|
| 主机进程（路由器） | Node.js, TypeScript | 编排每会话的智能体容器，路由消息 |
| 智能体容器 | Docker, Bun, Claude Agent SDK | 每个智能体运行在隔离的Linux容器中 |
| 消息队列 | SQLite（inbound.db，outbound.db） | 每个会话两个文件，每个文件只有一个写入者，避免跨挂载冲突 |
| 凭证安全 | OneCLI的Agent Vault | 在请求时注入凭证，强制执行每智能体策略和速率限制 |
| 消息通道 | WhatsApp, Telegram, Discord, Slack等 | 通过技能按需安装；每个通道是一个独立分支 |
数据流： 消息应用 → 主机进程 → inbound.db（SQLite）→ 智能体容器 → outbound.db（SQLite）→ 主机进程 → 消息应用。不使用IPC或stdin管道，彻底消除跨挂载冲突问题。
快速入门指南
bash
git clone https://github.com/qwibitai/nanoclaw.git nanoclaw-v2
cd nanoclaw-v2
bash nanoclaw.sh从v1迁移：
bash
git clone https://github.com/qwibitai/nanoclaw.git nanoclaw-v2
cd nanoclaw-v2
bash migrate-v2.sh前置条件： Docker（macOS/Linux/WSL2），Claude Code用于自定义和错误恢复。
优点、缺点与使用场景
优点
- 代码库易于理解 — 小到单个开发者就能完全掌握和自定义，与庞杂的AI智能体框架形成鲜明对比。
- 真正的操作系统级隔离 — 基于容器的安全性远强于应用层级的权限检查。
- 无配置膨胀 — AI原生自定义消除了复杂配置文件的需求。
- 天生精简 — 基于技能的按需功能安装，每个分支只包含所需内容。
- 广泛的消息支持 — 开箱即用，覆盖几乎所有主流消息平台。
缺点
- 依赖Docker — 仅支持macOS、Linux或通过WSL2的Windows，无原生Windows支持。
- 依赖Claude Code — 自定义和错误恢复依赖于Claude Code，形成了对Anthropic工具的依赖。
- 非即插即用 — 非技术用户会在安装、Docker配置和代码修改上遇到困难。
- 主分支刻意精简 — 用户需自行安装技能才能获得功能，可能会让期待开箱即用全功能体验的用户感到意外。
不适合谁使用？
- 非技术用户，他们需要带图形界面的即用型AI助手，不愿使用命令行。
- 仅限Windows的用户，无法或不愿使用WSL2来支持Docker。
- 需要托管SaaS解决方案的团队 — 这是自托管、DIY工具，而非托管服务。
- 偏好配置文件而非AI驱动代码修改的用户。
- 需要集中管理的企业团队 — 每个分支相互独立，没有用于集群管理的管理面板。
理想使用场景
- 独立开发者，想要一个完全可定制、安全、自己拥有并理解的AI助手。
- 高级用户，熟悉Docker和TypeScript，希望将AI集成到所有消息平台中。
- 注重隐私的个人，需要操作系统级隔离来处理访问敏感文件或执行命令的AI智能体。
- 黑客和极客，希望使用定时任务和多通道消息构建自定义AI工作流。
- 开源爱好者，想要分支、修改并贡献于不断发展的生态系统。
社区与活跃度
NanoClaw 火爆异常，已斩获 28,735颗星 — 这明确表明开发者社区对轻量级、安全的AI智能体框架替代方案有着强烈需求。该项目维护活跃（最近更新于2026年5月），并围绕其容器隔离架构建立了显著的发展势头。基于技能的分支模型鼓励社区贡献，而易于理解的代码库降低了新贡献者的门槛。如果你一直在等待进入AI智能体领域的信号，这就是了。