运行 NanoClaw
轻量级 TypeScript 内核，一种安装方式。克隆，运行 claude，使用 /setup。
checklist 系统要求
Node.js 20+（推荐 LTS 版本）
macOS 或 Linux。Windows 通过 WSL2 可能可用，但非官方支持。
512MB+ 内存。轻量级运行时，无需重度编译。
约 50MB 安装空间（node_modules）。容器镜像额外约 500MB。
必需：Apple Container (macOS) 或 Docker (macOS/Linux)。必需：Claude Code CLI。
需要互联网连接以调用 Anthropic API。不支持离线模式。
克隆仓库并使用 Claude CLI 启动。几分钟即可运行。
One-Liner
Requires Claude CLI. All platforms.
git clone https://github.com/qwibitai/NanoClaw.git && cd NanoClaw && claude Step-by-Step
Clone first, then configure. More control.
git clone https://github.com/qwibitai/NanoClaw.git cd NanoClaw && npm install # Run claude and use /setup for guided configuration # Or edit .env and src/index.ts directly verified 验证安装
运行以下命令确认 NanoClaw 已正确安装。
node -e "console.log(require('./package.json').version)" 应输出已安装的版本号。
npm test 运行测试套件 (vitest) 以验证依赖和核心功能。
claude 打开 Claude Code。在会话中运行 /setup 进行引导配置。
settings 初始配置
Claude Code 通过 /setup 处理配置。以下是它配置的内容。
安装依赖
Claude Code 运行 npm install 并构建容器镜像 (nanoclaw-agent:latest)，预装 Chromium、agent-browser 和 Claude Code。
认证
在 .env 中设置 ANTHROPIC_API_KEY，或通过 Claude Code OAuth 认证。密钥在运行时传递给容器，绝不加载到 process.env 中。
连接 WhatsApp
运行 'npm run auth' 通过二维码配对。WhatsApp 是内置渠道。之后可通过技能添加 Telegram、Discord 或 Slack (/add-telegram, /add-discord, /add-slack)。
启动代理
运行 'npm start' 启动 NanoClaw。它会连接 WhatsApp，启动消息轮询循环，并开始在隔离容器中处理消息。
.env — NanoClaw 不使用配置文件。要修改，告诉 Claude Code 你想要什么。代码库足够小，Claude 可以安全地修改它。
system_update_alt 升级 NanoClaw
保持 NanoClaw 更新以获取最新功能、集成和安全补丁。
cd NanoClaw && git pull && npm install cd NanoClaw && git pull && docker compose up --build 查看 github.com/qwibitai/nanoclaw/releases 的更新日志了解每个版本的新内容。
build 故障排除
常见问题及解决方法。