引导向导（CLI）
Onboarding Wizard（引导向导）是设置 OpenClaw 的推荐方式。它会以交互式问答引导你完成所有必要配置，无需手动编辑配置文件。
启动向导
bash
openclaw onboard安装守护服务
如果你希望 Gateway（网关）在后台自动运行，添加 --install-daemon 参数：
bash
openclaw onboard --install-daemonQuickStart 与 Advanced 模式
向导启动后，你会看到两种模式选择：
| 模式 | 适合人群 | 说明 |
|---|---|---|
| QuickStart | 新手 / 快速体验 | 仅配置核心选项，最快完成 |
| Advanced | 高级用户 | 完整配置所有选项，包括渠道、技能等 |
QuickStart 模式
QuickStart 模式只会引导你完成模型认证和 Gateway（网关）配置，其他选项使用默认值。你随时可以通过重新运行向导来补充配置。
向导配置的 7 个步骤
无论选择哪种模式，向导最多涵盖以下 7 个步骤：
步骤 1：Model / Auth（模型与认证）
配置你的 AI 模型提供商和 API 密钥。
? Select your model provider:
❯ OpenAI
Anthropic
OpenAI-compatible (自定义端点)
Anthropic-compatible (自定义端点)
Auto-detect (自动检测)向导会引导你输入 API Key 并验证连通性。
支持的模型提供商
- OpenAI — GPT-4o、GPT-4、GPT-3.5 等
- Anthropic — Claude 3.5 Sonnet、Claude 3 Opus 等
- OpenAI-compatible — 兼容 OpenAI API 的第三方服务（如 DeepSeek、通义千问）
- Anthropic-compatible — 兼容 Anthropic API 的第三方服务
- Auto-detect — 自动检测端点类型
步骤 2：Workspace（工作空间）
设置 Agent（智能体）的工作空间路径，所有 Agent 的身份文件、记忆和技能都存储在此。
? Workspace directory: (~/.openclaw/workspace)步骤 3：Gateway（网关）
配置 Gateway（网关）的监听地址和端口。
? Gateway host: (127.0.0.1)
? Gateway port: (18789)步骤 4：Channels（渠道）
配置消息渠道接入，如 WhatsApp、Telegram、Discord 等。
? Configure a messaging channel? (Y/n)
? Select channel type:
❯ WhatsApp (via Evolution API)
Telegram
Discord
Slack
MatrixQuickStart 模式下
此步骤在 QuickStart 模式中会跳过，你可以稍后通过重新运行向导或手动编辑配置来添加渠道。
步骤 5：Daemon（守护服务）
选择是否安装后台守护服务，让 Gateway（网关）以系统服务方式运行。
? Install gateway as a background daemon? (Y/n)- macOS — 安装为 launchd 用户服务
- Linux — 安装为 systemd 用户服务
- Windows (WSL2) — 安装为 systemd 用户服务（WSL2 环境）
步骤 6：Health Check（健康检查）
向导完成配置后会自动进行健康检查，验证：
- ✅ 配置文件写入成功
- ✅ API 密钥有效
- ✅ Gateway（网关）可以启动
- ✅ 渠道连接正常（如已配置）
步骤 7：Skills（技能）
配置初始启用的 Skill（技能），可以选择预置的技能包或手动选择：
? Install default skill pack? (Y/n)添加新的 Agent（智能体）
初始化完成后，你可以随时添加新的 Agent（智能体）：
bash
openclaw agents add此命令会启动一个简化向导，引导你为新 Agent 配置：
- Agent 名称和身份
- 使用的模型
- 可用的技能
- 工作空间子目录
重新运行向导
你可以随时重新运行向导来修改配置：
bash
openclaw onboard关于 --reset 参数
默认情况下，重新运行向导不会清除现有配置，只会更新你选择修改的部分。如果你需要从头开始：
bash
openclaw onboard --reset--reset 会清除所有现有配置并重新开始。请谨慎使用。
向导完成后
向导完成后，你将获得：
- ✅ 已配置的模型认证
- ✅ 运行中的 Gateway（网关）
- ✅ 初始化的工作空间
- ✅ 可选的渠道接入和守护服务
常用参数
| 参数 | 说明 |
|---|---|
--install-daemon | 同时安装守护服务 |
--reset | 清除现有配置，重新开始 |
--quick | 直接进入 QuickStart 模式 |
--advanced | 直接进入 Advanced 模式 |
下一步
Agent 引导了解 Agent 首次运行时的引导仪式
→macOS 应用初始化macOS 应用的图形化初始化流程
→渠道配置接入更多消息渠道
→