新手引导概览
OpenClaw 有两种新手引导路径。两者都会配置认证、Gateway 网关以及 可选的聊天渠道——区别只在于你与设置流程交互的方式不同。我应该使用哪种路径？
| CLI 新手引导 | macOS 应用新手引导 | |
|---|---|---|
| 平台 | macOS、Linux、Windows（原生或 WSL2） | 仅 macOS |
| 界面 | 终端向导 | 应用内引导式 UI |
| 最适合 | 服务器、无头环境、完全控制 | 桌面 Mac、可视化设置 |
| 自动化 | 可用于脚本的 --non-interactive | 仅手动 |
| 命令 | openclaw onboard | 启动应用 |
新手引导会配置什么
无论你选择哪种路径，新手引导都会设置：- 模型提供商和认证——为你选择的提供商配置 API 密钥、OAuth 或 setup token
- 工作区——用于存放智能体文件、bootstrap 模板和 memory 的目录
- Gateway 网关——端口、绑定地址、认证模式
- 渠道（可选）——内置和内置插件聊天渠道，例如 BlueBubbles、Discord、Feishu、Google Chat、Mattermost、Microsoft Teams、 Telegram、WhatsApp 等
- 守护进程（可选）——后台服务，使 Gateway 网关自动启动
CLI 新手引导
在任意终端中运行：--install-daemon 可一步同时安装后台服务。
完整参考：新手引导（CLI）
CLI 命令文档：openclaw onboard
macOS 应用新手引导
打开 OpenClaw 应用。首次运行向导会通过可视化界面引导你完成相同的步骤。 完整参考：新手引导（macOS 应用）自定义或未列出的提供商
如果你的提供商未列在新手引导中，请选择 Custom Provider 并输入：- API 兼容模式（兼容 OpenAI、兼容 Anthropic，或自动检测）
- Base URL 和 API 密钥
- 模型 ID 和可选别名