引导向导参考

这是 openclaw onboard CLI 向导的完整参考。高层概览见引导向导。

流程详情（本地模式）

步骤 1：现有配置检测

如果 ~/.openclaw/openclaw.json 存在，选择保留 / 修改 / 重置。重跑向导不会擦除任何东西，除非你选择重置或传 --reset。

步骤 2：模型/认证

支持 Anthropic API key、Anthropic OAuth、Anthropic token（粘贴 setup-token）、OpenAI Code 订阅、OpenAI API key、xAI (Grok) API key、OpenCode、Ollama、Vercel AI Gateway、Cloudflare AI Gateway、MiniMax、Synthetic、Moonshot、Kimi Coding 等多种认证方式。选择默认模型时优先选择你提供商栈中最强的最新一代模型。

步骤 3：工作空间

默认 ~/.openclaw/workspace（可配置）。播种 agent 引导仪式所需的工作空间文件。

步骤 4：Gateway

端口、绑定、认证模式、tailscale 暴露。建议即使在 loopback 也保持 Token 认证。

步骤 5：频道

WhatsApp（可选 QR 登录）、Telegram、Discord、Google Chat、Mattermost、Signal、BlueBubbles（推荐用于 iMessage）、iMessage（遗留）。DM 安全默认为配对模式。

步骤 6：Web 搜索

选择提供商：Perplexity、Brave、Gemini、Grok 或 Kimi（或跳过）。

步骤 7：Daemon 安装

macOS 用 LaunchAgent，Linux 用 systemd 用户单元。运行时选择：Node（推荐）。Bun 不推荐。

步骤 8：健康检查

启动 Gateway 并运行 openclaw health。

步骤 9：技能（推荐）

读取可用技能，选择节点管理器（npm / pnpm），安装可选依赖。

步骤 10：完成

摘要 + 后续步骤。

非交互模式

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback \
  --install-daemon \
  --daemon-runtime node \
  --skip-skills

加 --json 获取机器可读摘要。提供商专属命令示例见 CLI 自动化。

向导写入的内容

~/.openclaw/openclaw.json 中的典型字段：agents.defaults.workspace、模型/提供商配置、gateway.*、频道配置、skills.install.nodeManager、向导元数据等。