入门概述
OpenClaw 提供两种新手引导路径。两者都会配置身份认证、Gateway（网关）以及可选的聊天频道——区别仅在于您与设置过程的交互方式不同。
我应该使用哪种路径？
Section titled “我应该使用哪种路径？”| CLI 新手引导 | macOS 应用新手引导 | |
|---|---|---|
| 平台 | macOS、Linux、Windows（原生或 WSL2） | 仅限 macOS |
| 界面 | 终端向导 | 应用中的引导式 UI |
| 最适合 | 服务器、无头模式、完全控制 | Mac 桌面、可视化设置 |
| 自动化 | 用于脚本的 --non-interactive | 仅限手动 |
| 命令 | openclaw onboard | 启动应用 |
大多数用户应从 CLI 新手引导 开始——它适用于所有地方并为您提供 最大的控制权。
新手引导配置的内容
Section titled “新手引导配置的内容”无论您选择哪种路径，新手引导都会设置：
- 模型提供商和身份验证 —— 所选提供商的 API 密钥、OAuth 或设置令牌
- 工作区 —— 用于代理文件、引导模板和内存的目录
- Gateway(网关) —— 端口、绑定地址、身份验证模式
- 频道（可选）——内置且绑定的聊天频道，例如 BlueBubbles、Discord、飞书、Google Chat、Mattermost、Microsoft Teams、Telegram、WhatsApp 等
- 守护进程（可选）—— 后台服务，使 Gateway(网关) 自动启动
CLI 新手引导
Section titled “CLI 新手引导”在任何终端中运行：
openclaw onboard添加 --install-daemon 以在一并安装后台服务。
完整参考：新手引导 (CLI)
CLI 命令文档：openclaw onboard
macOS 应用新手引导
Section titled “macOS 应用新手引导”打开 OpenClaw 应用。首次运行向导会通过可视化界面引导您完成相同的步骤。
完整参考：新手引导 (macOS 应用)
自定义或未列出的提供商
Section titled “自定义或未列出的提供商”如果您的提供商未在新手引导中列出，请选择 自定义提供商 并 输入：
- API 兼容性模式（OpenAI 兼容、Anthropic 兼容或自动检测）
- 基础 URL 和 API 密钥
- 模型 ID 和可选别名
多个自定义端点可以共存——每个都有自己的端点 ID。