引导式配置
概述
openclaw onboard 是安装 OpenClaw 后必须运行的引导配置命令。它通过交互式向导，一步步引导你完成首次配置，让 OpenClaw 真正可以工作。
启动向导
bash
openclaw onboard向导流程
openclaw onboard 会依次引导你完成以下配置：
1. 选择 AI 模型
向导会列出支持的模型供应商，选择一个并填入 API Key：
? 选择模型供应商:
❯ DeepSeek（推荐入门，便宜好用）
OpenAI (GPT-4o)
Anthropic (Claude)
Ollama（本地模型，免费）
OpenRouter（聚合网关）
其他 OpenAI 兼容服务不知道选哪个？
推荐 DeepSeek，充值 10 元即可长期使用。详见 模型供应商 页面。
2. 配置 API Key
根据所选供应商，输入对应的 API Key：
? 输入你的 DeepSeek API Key: sk-xxxxxxxxxxxx
✓ API Key 验证成功3. 设置消息频道
选择你希望通过哪个平台与 OpenClaw 对话：
? 选择消息频道:
❯ Telegram（推荐，配置最简单）
微信
飞书
Discord
Slack
稍后配置向导会根据你的选择，给出该频道的具体配置步骤。
4. 启动 Gateway 并验证
配置完成后，向导会启动 Gateway 并发送测试消息验证连接：
✓ Gateway 已启动，监听 ws://127.0.0.1:18789
✓ 测试消息发送成功
🎉 配置完成！现在可以通过 Telegram 和你的 AI 助理对话了。同时安装守护进程
使用 --install-daemon 参数可以在完成配置的同时安装守护进程，让 Gateway 在后台持续运行：
bash
openclaw onboard --install-daemon守护进程说明
守护进程安装后，Gateway 会在系统启动时自动运行，无需手动启动。
| 操作系统 | 守护进程方式 | 管理命令 |
|---|---|---|
| macOS | launchd | launchctl list | grep openclaw |
| Linux | systemd | systemctl status openclaw |
安装守护进程后，Gateway 持续在 ws://127.0.0.1:18789 监听，等待来自各频道的消息。
macOS (launchd)
bash
# 查看状态
launchctl list | grep openclaw
# 手动停止
launchctl stop com.openclaw.gateway
# 手动启动
launchctl start com.openclaw.gatewayLinux (systemd)
bash
# 查看状态
systemctl status openclaw
# 手动停止
sudo systemctl stop openclaw
# 手动启动
sudo systemctl start openclaw
# 查看日志
journalctl -u openclaw -f重新运行向导
如果需要修改配置，可以随时重新运行向导：
bash
openclaw onboard向导会检测到已有配置，让你选择是重新配置还是在现有基础上修改。