NanoClaw – 轻巧易懂的专属 Claude AI 助手

您的专属 Claude 助手 NanoClaw 容器中安全运行。它轻巧易懂,并能根据您的个人需求灵活定制。还是首个支持 Agent Swarms(智能体集群) 的 AI 助手。可轻松组建智能体团队,在您的聊天中高效协作。

据作者介绍,OpenClaw 是一个令人印象深刻的项目,愿景宏大。但我无法安心使用一个我不了解却能访问我个人隐私的软件。 OpenClaw 有 52+ 个模块、8 个配置管理文件、45+ 个依赖项,以及为 15 个渠道提供商设计的抽象层。其安全性是应用级别的(通过白名单、配对码实现),而非操作系统级别的隔离。所有东西都在一个共享内存的 Node 进程中运行。

NanoClaw 用一个您能在 8 分钟内理解的代码库,为您提供了同样的核心功能。只有一个进程,少数几个文件。智能体(Agent)运行在具有文件系统隔离的真实 Linux 容器中,而不是依赖于权限检查。

20260227-8

设计哲学

  • 小巧易懂: 单一进程,少量源文件。无微服务、无消息队列、无复杂抽象层。让 Claude Code 引导您轻松上手。
  • 通过隔离保障安全: 智能体运行在 Linux 容器(在 macOS 上是 Apple Container ,或 Docker)中。它们只能看到被明确挂载的内容。即便通过 Bash 访问也十分安全,因为所有命令都在容器内执行,不会直接操作您的宿主机。
  • 为单一用户打造: 这不是一个框架,是一个完全符合我个人需求的、可工作的软件。您可以 Fork 本项目,然后让 Claude Code 根据您的精确需求进行修改和适配。
  • 定制即代码修改: 没有繁杂的配置文件。想要不同的行为?直接修改代码。代码库足够小,这样做是安全的。
  • AI 原生: 无安装向导(由 Claude Code 指导安装)。无需监控仪表盘,直接询问 Claude 即可了解系统状况。无调试工具(描述问题, Claude 会修复它)。
  • 技能(Skills)优于功能(Features): 贡献者不应该向代码库添加新功能(例如支持 TG)。相反,他们应该贡献像 /add-telegram 这样的 Claude Code 技能,这些技能可以改造您的 fork 。最终,您得到的是只做您需要事情的整洁代码。
  • 最好的工具套件,最好的模型: 本项目运行在 Claude Agent SDK 之上,这意味着您直接运行的就是 Claude Code 。工具套件至关重要。一个低效的工具套件会让再聪明的模型也显得迟钝,而一个优秀的套件则能赋予它们超凡的能力。 Claude Code (在我看来) 是市面上最好的工具套件。

快速开始

git clone https://github.com/qwibitai/nanoclaw.git
cd nanoclaw
claude

然后运行 /setup。 Claude Code 会处理一切:依赖安装、身份验证、容器设置、服务配置。

系统要求

  • macOS 或 Linux
  • Node.js 20+
  • Claude Code
  • Apple Container (macOS) 或 Docker (macOS/Linux)

功能支持

  • WhatsApp 输入/输出 - 通过手机给 Claude 发消息
  • 隔离的群组上下文 - 每个群组都拥有独立的 CLAUDE.md 记忆和隔离的文件系统。它们在各自的容器沙箱中运行,且仅挂载所需的文件系统。
  • 主频道 - 您的私有频道(self-chat),用于管理控制;其他所有群组都完全隔离
  • 计划任务 - 运行 Claude 的周期性作业,并可以给您回发消息
  • 网络访问 - 搜索和抓取网页内容
  • 容器隔离 - 智能体在 Apple Container (macOS) 或 Docker (macOS/Linux) 的沙箱中运行
  • 智能体集群(Agent Swarms) - 启动多个专业智能体团队,协作完成复杂任务(首个支持此功能的个人 AI 助手)
  • 可选集成 - 通过技能添加 Gmail (/add-gmail) 等更多功能

使用方法

使用触发词(默认为 @Andy)与您的助手对话:

@Andy 每周一到周五早上 9 点,给我发一份销售渠道的概览(需要访问我的 Obsidian vault 文件夹)
@Andy 每周五回顾过去一周的 git 历史,如果与 README 有出入,就更新它
@Andy 每周一早上 8 点,从 Hacker News 和 TechCrunch 收集关于 AI 发展的资讯,然后发给我一份简报

在主频道(您的 self-chat)中,可以管理群组和任务:

@Andy 列出所有群组的计划任务
@Andy 暂停周一简报任务
@Andy 加入"家庭聊天"群组

定制

没有需要学习的配置文件。直接告诉 Claude Code 您想要什么:

  • "把触发词改成 @Bob"
  • "记住以后回答要更简短直接"
  • "当我说早上好的时候,加一个自定义的问候"
  • "每周存储一次对话摘要"

或者运行 /customize 进行引导式修改。

代码库足够小, Claude 可以安全地修改它。

下载地址