Onboarding 向导参考

openclaw onboard 的完整参考文档。

向导步骤

1. 检测现有配置：选择保留/更新/重置
2. Model/Auth：配置 Anthropic/OpenAI/Ollama 等 provider 和 API key
3. 工作区：默认 ~/.openclaw/workspace，初始化 bootstrap 文件
4. Gateway：端口、绑定地址、认证模式（推荐 Token）
5. Channels：WhatsApp/Telegram/Discord/Signal/iMessage 等
6. Web 搜索：Brave/DuckDuckGo/Exa/Perplexity 等
7. 守护进程安装：macOS LaunchAgent / Linux systemd
8. 健康检查：启动 Gateway 并运行 openclaw health
9. Skills：安装可选依赖
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 获取机器可读输出。

Gateway 向导 RPC

Gateway 通过 RPC 暴露 onboarding 流程（wizard.start、wizard.next、wizard.cancel、wizard.status），供 macOS 应用和 Control UI 渲染步骤。

向导写入的配置字段

• agents.defaults.workspace、agents.defaults.model
• gateway.*（模式、绑定、认证）
• channels.telegram.botToken、channels.discord.token 等
• skills.install.nodeManager
• wizard.lastRunAt、wizard.lastRunVersion

相关页面

• ref-agents-default
• gateway-configuration