初始设置

工作原理

/setup 技能是启动 NanoClaw 的入口。它引导你从全新克隆到完全运行的智能体的每一个步骤，无需手动编辑任何配置文件。

设置分为八个阶段：

阶段 1 —— 引导启动。 技能检查是否已安装 Node.js 22+，并运行 npm install 拉取依赖。如果 Node.js 缺失或版本过旧，它会准确告诉你需要安装什么。

阶段 2 —— 环境检查。 如果是首次设置，此阶段直接通过。如果之前运行过设置，技能会检测你现有的 WhatsApp 认证、已注册的群组和环境变量，以避免覆盖任何内容。

阶段 3 —— 容器运行时。 你可以在 Docker 和 Apple Container 之间选择。在 macOS 上，Apple Container 提供针对 Apple Silicon 优化的快速轻量沙箱。在 Linux 上，Docker 是默认选项。技能会验证运行时是否已安装并正常工作，如果未安装则提供安装指引。

阶段 4 —— Claude 身份验证。 NanoClaw 基于 Claude Agent SDK 运行，需要 Claude Code OAuth 令牌或 Anthropic API 密钥。技能会检查你是否已配置，未配置则提示你进行设置。

阶段 5 —— 频道设置。 在这一步你选择要连接的消息频道。技能会显示可选列表——WhatsApp、Telegram、Slack、Discord——并将你选择的每个频道委托给对应的频道技能处理。你可以先设置一个频道，之后再添加更多。

阶段 6 —— 挂载白名单。 NanoClaw 的容器默认是隔离的——智能体只能访问你明确允许的目录。技能让你配置主机上的哪些目录可以在容器内使用。你可以在此添加项目目录、文档文件夹或凭据路径等。

阶段 7 —— 服务注册。 技能将 NanoClaw 注册为后台服务，使其自动启动并保持运行。在 macOS 上使用 launchd，在 Linux 上使用 systemd。注册后立即启动服务。

阶段 8 —— 验证。 最终检查确认所有组件正常工作：服务正在运行、容器运行时可访问、Claude 身份验证有效、至少一个消息频道已连接。如果有任何失败，技能会提供针对性的故障排除步骤。

设置完成后

设置完成后，NanoClaw 将在后台运行。发送到已注册聊天的消息会被接收，由 Claude 在隔离容器中处理，然后通过同一频道发回响应。

要之后添加更多频道，请运行各频道的专属技能（/add-telegram、/add-slack 等）。要修改行为，使用 /customize。要诊断问题，使用 /debug。

使用技巧

• 你可以随时重新运行 /setup。它会检测现有配置并跳过已完成的阶段。
• 如果你使用搭载 Apple Silicon 的 macOS，推荐使用 Apple Container 运行时——对于此用途，它比 Docker 更快更轻量。
• 服务注册步骤是可选的。如果你更喜欢手动运行，可以跳过此步骤并使用 npm start 启动 NanoClaw。