NanoClaw 安装使用教程

📖 项目简介

NanoClaw 是 OpenClaw 的轻量级替代品，代码量极小（仅几个源文件），却提供了真正的操作系统级安全隔离。每个 AI Agent 都运行在独立的 Linux 容器中，文件系统完全隔离，只能访问你明确挂载的目录。

与 OpenClaw 的近 50 万行代码、53 个配置文件、70+ 依赖不同，NanoClaw 小到你可以完全看懂整个代码库，并且基于 Claude Agent SDK 构建，是全球首个支持 Agent Swarms（智能体集群）的个人 AI 助手。

💡

GitHub 地址： https://github.com/qwibitai/nanoclaw

🔒 NanoClaw vs OpenClaw 安全对比

对比维度	OpenClaw	NanoClaw
代码量	~50万行	几个源文件
安全模型	应用层白名单/配对码	OS级容器隔离
进程架构	单Node进程共享内存	每个Agent独立容器
文件隔离	权限检查	挂载点隔离
Bash安全	主机执行	容器内执行
依赖数量	70+	极少
配置文件	53个	无（代码即配置）

✨ 核心亮点

🐳

容器级隔离

Agent运行在独立容器中，文件系统和进程完全隔离

💬

多渠道连接

支持 WhatsApp、Telegram、Slack、Discord、Gmail

🤖

Agent 集群

全球首个支持 Agent Swarms 的个人AI助手

🔧

极致可定制

代码小到完全看懂，用代码修改而非配置文件

💻 环境要求

操作系统：macOS 或 Linux
Node.js：20+ 版本
Claude Code：需提前安装（获取地址）
容器运行时：Apple Container（macOS）或 Docker（macOS/Linux）

⚠️

注意：Windows 用户需通过 WSL2 + Docker 使用。

🚀 安装步骤

Fork 并克隆仓库

使用 GitHub CLI 一键操作：

                        bash
                        gh repo fork qwibitai/nanoclaw --clone
cd nanoclaw
                    

或手动操作：在 GitHub 上点击 Fork 按钮，然后克隆你的仓库

                        bash
                        git clone https://github.com/你的用户名/nanoclaw.git
cd nanoclaw
                    

启动 Claude Code

在项目目录中运行：

                        bash
                        claude
                    

运行自动设置

在 Claude Code 提示符中输入 /setup，Claude 会自动处理所有配置：

安装依赖
配置认证
设置容器环境
配置服务

✅

AI 原生安装：无需安装向导，Claude Code 会引导你完成所有设置步骤。

💬 使用方法

使用触发词（默认 @Andy）与你的 AI 助手对话：

                示例
                @Andy 每个工作日早上9点发送销售管线概览
@Andy 每周五检查git历史并更新README
@Andy 每周一早上8点汇编AI发展新闻简报
            

管理命令（主频道）

                示例
                @Andy 列出所有定时任务
@Andy 暂停周一简报任务
@Andy 加入家庭聊天群组
            

自定义行为

无需配置文件，直接告诉 Claude Code 你想要什么：

"把触发词改成 @小助手"
"记住以后回复要更简短"
"添加每周对话摘要存储"

🏗️ 架构说明

                架构流
                Channels --> SQLite --> Polling loop --> Container (Claude Agent SDK) --> Response
            

单 Node.js 进程运行。频道通过 Skills 添加，启动时自注册。Agent 在隔离的 Linux 容器中执行，只有挂载的目录可访问。每个群组独立的消息队列和并发控制，通过文件系统进行 IPC 通信。

❓ 常见问题

Q: 为什么选择容器隔离而不是应用层权限？

应用层权限（白名单、配对码）只是软件层面的检查，存在被绕过的风险。容器隔离是操作系统级别的安全边界，即使 Agent 执行恶意代码，也只在容器内部运行，无法访问宿主机。

Q: 可以在 Linux 上运行吗？

可以。Docker 是默认的容器运行时，在 macOS 和 Linux 上都可以使用。运行 /setup 即可。

Q: 支持第三方模型吗？

支持。NanoClaw 支持任何兼容 Claude API 的模型端点。在 .env 文件中设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 即可使用 Ollama、Together AI 等模型。

Q: 如何调试问题？

直接问 Claude Code！描述你遇到的问题，Claude 会帮你诊断和修复。这就是 NanoClaw 的 AI 原生理念。