快速上手
假设你已经完成安装，本篇带你在 5 分钟内跑通第一个 AI 对话。
1
运行交互式引导
onboard 命令会引导你完成模型认证、渠道登录和 Daemon 安装：
openclaw onboard --install-daemon引导过程中你需要选择一个 AI 模型供应商（如 Anthropic、OpenAI）并输入 API Key。 Key 会保存到 ~/.openclaw/.env，不会写入配置文件。
2
确认网关运行
openclaw gateway status正常情况下你会看到 Gateway 的 PID、端口（默认 18789）和运行时间。 如果未启动，运行 openclaw gateway 前台启动，或 openclaw gateway install 注册为系统服务。
3
打开 Control UI
openclaw dashboard浏览器会自动打开 http://127.0.0.1:18789，这就是 OpenClaw 的 Web 控制台。 你可以在这里聊天、修改配置、查看会话。
4
登录第一个渠道
以 Telegram 为例（最简单的渠道）：
- 在 Telegram 中找到
@BotFather，创建一个 Bot 并获取 Token - 运行登录命令：
openclaw channels login telegram按提示输入 Bot Token。登录成功后，向你的 Bot 发消息即可收到 AI 回复。
WhatsApp 需要扫码配对，Discord 需要创建 Bot Application——具体步骤见 渠道接入。
5
验证对话
通过已登录的渠道向 Bot 发送一条消息，或在 Control UI 的 WebChat 中直接对话。
如果没有收到回复，按以下顺序排查：
# 综合状态
openclaw status --all
# 渠道连接检查
openclaw channels status --probe
# 模型认证检查
openclaw models status
# 查看实时日志
openclaw logs --follow关键环境变量
| 变量 | 默认值 | 说明 |
|---|---|---|
| OPENCLAW_HOME | ~/.openclaw | 配置与数据根目录 |
| OPENCLAW_STATE_DIR | $HOME/.openclaw | 运行时状态目录 |
| OPENCLAW_CONFIG_PATH | ~/.openclaw/openclaw.json | 配置文件路径 |
最佳实践
- API Key 放在
~/.openclaw/.env，不要硬编码进openclaw.json - 首次使用先单渠道验证，确认模型回复正常后再接入更多渠道
- 生产环境建议安装 Daemon（
--install-daemon）确保 Gateway 自启 - 遇到问题先跑
openclaw doctor，它能自动修复大多数配置错误