引导式配置

概述

openclaw onboard 是安装 OpenClaw 后必须运行的引导配置命令。它通过交互式向导，一步步引导你完成首次配置，让 OpenClaw 真正可以工作。

启动向导

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 在后台持续运行：

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)

# 查看状态
launchctl list | grep openclaw

# 手动停止
launchctl stop com.openclaw.gateway

# 手动启动
launchctl start com.openclaw.gateway

Linux (systemd)

# 查看状态
systemctl status openclaw

# 手动停止
sudo systemctl stop openclaw

# 手动启动
sudo systemctl start openclaw

# 查看日志
journalctl -u openclaw -f

重新运行向导

如果需要修改配置，可以随时重新运行向导：

openclaw onboard

向导会检测到已有配置，让你选择是重新配置还是在现有基础上修改。

下一步

• 5 分钟上手 --- 发送你的第一条消息
• 频道配置 --- 添加更多聊天频道
• 模型供应商 --- 配置或切换 AI 模型