Appearance
Onboarding 概述
OpenClaw 提供两种 onboarding 路径。两者都会配置认证、Gateway 和可选频道，区别只在于交互方式。
我该选哪种？
| CLI onboarding | macOS 应用 onboarding | |
|---|---|---|
| 平台 | macOS、Linux、Windows（原生或 WSL2） | 仅 macOS |
| 界面 | 终端向导 | 应用内图形引导 |
| 适合 | 服务器、无头环境、完全控制 | Mac 桌面、可视化设置 |
| 自动化 | --non-interactive 支持脚本化 | 仅手动 |
| 命令 | openclaw onboard | 启动应用 |
大多数用户应从 CLI onboarding 开始——它在任何平台都能运行，也给你最大的控制权。
Onboarding 会配置什么
无论选择哪种路径，onboarding 都会完成以下配置：
- 模型提供商与认证 — 你选择的提供商的 API Key、OAuth 或设置 token
- 工作区 — 智能体文件、bootstrap 模板和记忆的目录
- Gateway — 端口、绑定地址、认证模式
- 频道（可选）— WhatsApp、Telegram、Discord 等
- 守护进程（可选）— 后台服务，让 Gateway 自动启动
CLI onboarding
在任意终端执行：
bash
openclaw onboard添加 --install-daemon 参数可同步安装后台服务，一步搞定。
完整参考文档：Onboarding（CLI） CLI 命令文档：openclaw onboard
macOS 应用 onboarding
打开 OpenClaw 应用，首次运行向导会以图形界面引导你完成同样的步骤。
完整参考文档：Onboarding（macOS 应用）
自定义或未列出的提供商
如果你的提供商不在 onboarding 列表中，选择 Custom Provider 并填写：
- API 兼容模式（OpenAI 兼容、Anthropic 兼容，或自动检测）
- Base URL 和 API Key
- 模型 ID 和可选别名
多个自定义端点可以共存——每个端点有独立的 endpoint ID。