常见问题
关于 NanoClaw 及其工作原理的常见问题。
NanoClaw 是一个轻量级、开源的个人 AI 助手,基于 Anthropic Claude Agent SDK 构建。代理运行在隔离的 Linux 容器中(macOS 上使用 Apple Container,macOS/Linux 上使用 Docker)。内置 WhatsApp,其他渠道通过技能添加。具备持久化 SQLite 记忆、定时任务、网页访问、浏览器自动化和代理集群功能。
运行 'git clone https://github.com/qwibitai/NanoClaw.git && cd NanoClaw && claude',然后在 Claude 会话中使用 /setup。Claude Code 处理依赖、认证、容器配置和服务配置。需要 Node.js 20+ 和 Claude Code。
NanoClaw 小巧到一目了然——单进程,几个源文件,无微服务。与臃肿的框架不同,你可以通读整个代码库。代理运行在真正的 Linux 容器中,具备文件系统隔离,而非应用层权限检查。
NanoClaw 完全基于 Anthropic Claude Agent SDK 运行。Claude Code 全局安装在每个容器内,处理所有 AI 交互。SDK 内部管理模型选择——NanoClaw 设计上仅支持单一供应商。
WhatsApp 是内置渠道(通过 Baileys 库,二维码配对)。Telegram、Discord 和 Slack 可通过 Claude Code 技能添加——运行 /add-telegram、/add-discord 或 /add-slack。技能会修改你 fork 的源代码以添加干净、专用的渠道支持。
安全是核心设计原则。代理运行在 Linux 容器中(macOS 上使用 Apple Container,macOS/Linux 上使用 Docker),具备文件系统隔离——而非应用层权限检查。密钥通过 stdin JSON 传递,绝不加载到 process.env 中。挂载白名单带符号链接逃逸检测。容器以非 root 用户运行,项目源码只读挂载。
NanoClaw 使用 SQLite (better-sqlite3) 进行持久化存储——消息、群组、会话、定时任务和路由状态。每个群组还有独立的 CLAUDE.md 文件用于群组级记忆,挂载到其容器中。无需外部数据库。
可以。NanoClaw 运行在 macOS 和 Linux 上——任何能运行 Node.js 20+ 和 Docker 的地方。轻量级 TypeScript 内核可在低资源设备上运行,包括树莓派。需要容器运行时(Apple Container 或 Docker)和 Anthropic API 密钥。
代理集群让 NanoClaw 启动专业代理团队协作处理复杂任务。NanoClaw 是首个支持代理集群的个人 AI 助手,基于 Claude Code 的 agent-teams 能力构建。
项目在 github.com/qwibitai/nanoclaw 以 MIT 许可证开源。查看 README 了解贡献指南。欢迎所有贡献。
内置工具由容器内运行的 Claude Code 提供:shell 命令、文件读写、网页搜索、网页浏览 (Chromium) 和代理委派(集群)。宿主进程提供定时任务 (cron)、持久化 SQLite 记忆和 WhatsApp 消息。通过添加技能扩展功能。
支持。每个代理容器预装 Chromium 和 agent-browser 用于浏览器自动化。Claude Code 可以在沙箱容器内搜索网页和浏览页面以获取实时信息。
官方且唯一可信的仓库是 github.com/qwibitai/nanoclaw。社区 Discord 是 discord.gg/VDdww8qS42。
macOS 和 Linux。需要 Node.js 20+ 和容器运行时——macOS 上使用 Apple Container,macOS/Linux 上使用 Docker。Windows 非官方支持,但可能通过 WSL2 配合 Docker 使用。
NanoClaw 通过 Claude Agent SDK 专用 Anthropic Claude。在 .env 文件中设置 ANTHROPIC_API_KEY,或通过 Claude Code OAuth 认证。不支持多供应商——SDK 内部处理模型选择。
GitHub 仓库 (github.com/qwibitai/nanoclaw) 中的 README 是主要文档来源。docs/ 目录包含架构规范、安全模型和调试清单。代码库足够小,你可以让 Claude Code 带你浏览。
官方渠道:Discord (discord.gg/VDdww8qS42) 和 GitHub (github.com/qwibitai/nanoclaw)。查看 README 了解所有社区链接。