初始设置
运行 NanoClaw 初始设置。处理依赖安装、身份验证、容器配置和服务注册。
功能特性
- 如果缺失,自动安装 Node.js、pnpm 和 Docker
- 构建智能体容器镜像
- 设置 OneCLI 保险库并注册你的 Anthropic 凭据
- 配对你的第一个频道(Telegram、Discord、WhatsApp 或本地 CLI)
- 通过 launchd 或 systemd 注册并启动后台服务
- 运行完整的验证流程并进行首次对话,确认一切正常
前置条件
- macOS 或 Linux
- Node.js 20+ 和 pnpm 10+(缺失时自动安装)
- Docker(缺失时自动安装)
安装
/setup 工作原理
/setup 技能会将你引导至真正的入口:在终端中运行 bash nanoclaw.sh。该脚本负责完整的端到端设置——从全新克隆到一个可以向其发消息的命名智能体,无需手动编辑任何配置文件。请直接运行它,而不要在 Claude 会话内运行:它需要交互式提示以及真实的 shell I/O 来完成 Node/pnpm 引导、Docker、OneCLI 和容器构建。
脚本会依次完成以下步骤:
环境。 检查基础条件——Node.js 20+ 和 pnpm 10+——缺失则自动安装,然后拉取依赖。
容器镜像。 验证 Docker 是否已安装(未安装则自动安装),并构建每个智能体会话运行所依赖的智能体容器镜像。
OneCLI 保险库。 安装并配置 OneCLI Agent Vault,即负责将原始 API 密钥隔离在容器之外的凭据代理。
Anthropic 凭据。 将你的 Claude Code OAuth 令牌或 Anthropic API 密钥注册到 OneCLI。
挂载白名单。 NanoClaw 的容器默认是隔离的——智能体只能访问你明确允许的目录。此步骤配置主机上的哪些目录可以在容器内使用。
服务。 将 NanoClaw 注册为后台服务,使其自动启动并保持运行。在 macOS 上使用 launchd,在 Linux 上使用 systemd。注册后立即启动服务。
CLI 智能体。 创建你的第一个智能体——一个可以从命令行与之对话的本地”终端智能体”。
时区。 自动检测你的时区以确保调度行为正确,如果检测结果不明确则向你确认。
频道配对。 可选地配对你的第一个消息频道——Telegram、Discord 或 WhatsApp——你也可以继续使用本地 CLI,之后再添加频道。
验证与首次对话。 最终检查确认所有组件正常工作,然后带你进入与新智能体的首次对话。
如果某个步骤中途失败,脚本会就地提供 Claude 辅助的恢复流程,并从中断处继续。
设置完成后
设置完成后,NanoClaw 将在后台运行。发送到已注册聊天的消息会被接收,由 Claude 在隔离容器中处理,然后通过同一频道发回响应。
要之后添加更多频道,请运行各频道的专属技能(/add-telegram、/add-slack 等)。要修改行为,使用 /customize。要诊断问题,使用 /debug。
使用技巧
- 如果设置被中断或某个步骤报错,重新运行
bash nanoclaw.sh会从中断处继续。 - 设置会安装并使用 Docker。在 macOS 上,你可以在之后通过独立的
/convert-to-apple-container技能(以skill/apple-container分支形式分发)切换到 Apple Container——它不是设置过程中提供的选项。 - 服务注册步骤可以跳过。如果你更喜欢手动运行,可以使用
pnpm start启动 NanoClaw(先运行pnpm run build)。