NanoClaw

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

NanoClaw 安全地运行在容器中,旨在让您理解并根据自身需求定制。

GitHub 上的星标

为什么选择 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 与 OpenClaw 有什么不同?

NanoClaw(也称为 Nano Claw)采用了根本不同的方法。OpenClaw 是一个大型框架,拥有数千个源文件和数十个依赖项,而 NanoClaw 是一个轻量级的个人 AI 代理,仅基于 15 个源文件构建,您可以一次性阅读并理解。NanoClaw 使用操作系统级别的容器隔离(Docker 或 Apple Container)来沙箱化每个代理会话,而不是依赖应用层级的权限检查。如果您正在寻找一个安全、最小化的 OpenClaw 替代方案,可以完全审计和定制,NanoClaw 正是为此而设计的。

NanoClaw 安全吗?

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

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 代理应该是根据您确切需求定制的可用软件,而不是一个通用的配置框架。