NanoClaw

您的个人 AI 代理。 安全。轻量。属于您。

NanoClaw 官方网站——安全的个人 AI 代理。 NanoClaw 安全地运行在容器中,旨在让您理解并根据自身需求定制。

GitHub 上 25.6k+ 颗星

为什么选择 NanoClaw?

NanoClaw 以一个您真正能理解的代码库,提供相同的核心功能。

NanoClaw
OpenClaw
源文件 15 3,680
代码行数 ~3,900 434,453
依赖项 <10 70
配置文件 0 53
理解所需时间 8 分钟 1–2 周
安全模型 操作系统级容器隔离 应用层级检查
架构 单进程 + 隔离容器 单进程,共享内存

支持的功能

NanoClaw 开箱即用支持的一切,没有您不需要的。

💬

即时通讯应用

WhatsApp、Telegram 等。通过您已经在使用的应用,从手机向您的 NanoClaw 代理发消息。

🔒

容器隔离

代理运行在 Apple Container(macOS)或 Docker 中。它们只能看到您明确挂载的内容。

🐝

代理集群 新功能

NanoClaw 可以启动专业代理团队,协作完成复杂任务。首个支持此功能的个人 AI。

🧠

分组记忆

每个群组拥有独立的 CLAUDE.md 记忆、隔离的文件系统,并在自己的容器沙箱中运行。

定时任务

运行 Claude 并回复您的定期任务。晨间简报、每周回顾等。

🧩

技能系统

无需臃肿即可扩展功能。通过技能添加 Gmail、Telegram 或自定义功能。

AI 原生配置

无需安装向导。Claude Code 全程引导:依赖项、认证、容器、服务。

🌐

网络访问

NanoClaw 可以搜索网络、获取内容并浏览页面来研究任何事物。

架构

NanoClaw 是单个 Node.js 进程。代理在隔离容器中运行。15 个源文件。

消息输入
WhatsApp / Telegram
SQLite
存储与去重
群组队列
每组 FIFO
容器
Claude Agent SDK
响应
流式返回

单进程

一个 Node.js 进程轮询消息、管理队列、启动容器并处理 IPC。没有微服务,没有消息代理。

按组隔离

每个群组拥有自己的容器、文件系统、IPC 命名空间和 Claude 会话。群组之间无法访问彼此的数据。

并发控制

GroupQueue 限制并发容器数量(默认:3)。每组 FIFO 排序,失败时使用指数退避重试。

通过文件系统的 IPC

容器通过每个群组目录中的 JSON 文件与主机通信。主机轮询、验证授权、执行并清理。

关键文件

index.ts — 编排器——轮询循环、消息处理、代理调用
container-runner.ts — 启动具有隔离挂载的容器,流式输出
group-queue.ts — 每组 FIFO 队列,具有并发限制和指数退避重试
ipc.ts — 处理容器 IPC 请求并进行授权检查
db.ts — SQLite——消息、会话、群组、任务、路由状态
task-scheduler.ts — Cron、定时和一次性计划任务执行

理念

塑造 NanoClaw 每个决策的原则。

🔍

小到足以理解

NanoClaw 是一个进程,几个源文件。小到您可以阅读并理解整个代码库。

🛡️

通过隔离保障安全

代理运行在 Linux 容器中。它们只能看到明确挂载的内容。Bash 是安全的,因为它在容器内部运行。

👤

为单用户打造

NanoClaw 不是一个庞大的框架。它是适合您确切需求的可用软件。Fork 它,让 Claude Code 按您的需求调整。

🤖

AI 原生

无需安装向导;Claude Code 引导配置。无需仪表盘;询问 Claude。无需调试工具;描述问题即可。

🧩

技能优于功能

贡献者添加 Claude Code 技能(如 /add-telegram)来改造您的安装。最终您会得到干净的代码,完全按您所需运行。

最佳框架,最佳模型

运行在 Claude Agent SDK 上,意味着您直接运行 Claude Code。框架至关重要。好的框架赋予智能模型超能力。

3 行命令开始使用 NanoClaw

克隆 NanoClaw,进入目录,让 Claude 处理其余一切。

终端
$ 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

媒体报道

常见问题

什么是 NanoClaw?

NanoClaw 是一个轻量级、开源的个人 AI 代理,运行在你自己的机器上。它可以连接 WhatsApp、Telegram、Slack、Discord 和 Signal 等消息应用,每个代理会话都在隔离的容器(Docker 或 Apple Container)中运行,并且仅由 15 个源文件构建,你可以在一次阅读中全部读完。它基于 Claude Agent SDK 构建,专为希望完全拥有和控制自己 AI 助手的用户设计。

NanoClaw 与 OpenClaw 有什么不同?

OpenClaw 是一个单体框架,包含数千个源文件和数十个依赖项。NanoClaw 采用相反的方法:约 15 个源文件、单个 Node.js 进程,以及通过容器实现的真正操作系统级隔离,而非应用层的权限检查。如果你想要一个可以完全审计、理解和定制的工具,NanoClaw 正是为此而生。

NanoClaw 安全吗?

安全性是核心设计原则。每个代理会话都在隔离的 Linux 容器中运行,拥有独立的文件系统、IPC 命名空间和进程空间。代理只能访问明确挂载的目录,不会隐式访问您的系统。由于整个代码库只有约 3,900 行代码分布在 15 个文件中,您可以切实地审计软件的所有行为。这种容器级隔离与小型可审计代码库的结合,使 NanoClaw 成为运行 AI 代理最透明、最安全的方式之一。

使用 NanoClaw 需要会编程吗?

不需要。NanoClaw 采用 AI 原生的设置流程,Claude Code 会交互式地处理安装、配置和后续更改。你运行 /setup 技能并按提示操作。如果之后想自定义行为,只需用自然语言描述你的需求,Claude Code 会为你修改代码。不过,你需要熟悉终端操作和运行 git clone 之类的命令。

NanoClaw 是免费的吗?

NanoClaw 本身完全免费,基于 MIT 许可证开源。但它运行在 Claude Agent SDK 上,需要 Claude API 密钥或 Claude Code 订阅。费用取决于你的使用量。NanoClaw 在设计上尽量减少 token 消耗,但底层 AI 的使用由 Anthropic 计费。

NanoClaw 支持哪些即时通讯应用?

NanoClaw 开箱即用支持 WhatsApp,并可通过技能系统扩展支持 Telegram、电子邮件和其他渠道。添加 Telegram 只需运行 /add-telegram 技能,它会引导您完成全部设置。架构设计使消息通道模块化,因此您可以同时运行一个或多个通道,每个通道都有独立的配置。

支持哪些容器运行时?

NanoClaw 同时支持 Apple Container 和 Docker。在 macOS 上,Apple Container 提供针对 Apple silicon 优化的快速轻量沙箱,Docker 也可作为替代方案。在 Linux 上,自动使用 Docker。在初始 /setup 过程中,您可以根据平台和偏好选择运行时。

NanoClaw 能在 Linux 上运行吗?

可以。NanoClaw 可在 macOS 和 Linux 上运行。在 Linux 上,Docker 作为容器运行时使用,在安装过程中自动配置。系统要求为 Node.js 20 或更高版本、Claude Code 和容器运行时(Linux 上为 Docker)。/setup 技能会处理您平台的所有依赖检查和配置。

如何安装和配置 NanoClaw?

NanoClaw 采用 AI 原生安装流程。克隆仓库并运行 Claude Code 后,您运行 /setup 技能,它会引导您完成依赖安装、消息通道认证、容器运行时配置和后台服务启动。无需手动编辑配置文件。Claude Code 以交互方式处理整个安装过程。后续如需更改,您可以描述需求,Claude Code 会直接在代码库中进行修改。

NanoClaw 与其他 AI 代理框架相比如何?

大多数 AI 代理框架是为构建产品的团队设计的。它们庞大、复杂,需要大量投入才能理解。NanoClaw 是为希望完全拥有和控制个人 AI 助手的个人设计的。它作为单个 Node.js 进程运行,使用真正的容器隔离而非应用级沙箱,并且小到可以完全理解。它运行在 Claude Agent SDK 上,让您无需抽象层即可直接使用 Claude 的能力。

NanoClaw 是开源的吗?

是的。Nano Claw 在 MIT 许可证下完全开源。整个代码库可在 GitHub 上获取,欢迎贡献。项目鼓励 Fork 和定制。其理念是,您的个人 AI 代理应该是根据您确切需求定制的可用软件,而不是一个通用的配置框架。