新手引导五分钟走完：从选模型到进入聊天

新手引导是官方设计的主入口，目标五分钟内让你跟自己的助理聊上第一句。

跑向导

openclaw onboard --install-daemon

向导会依次带你完成：

1. 选模型提供商：Anthropic、OpenAI、Google 等，也可以先选一个再随时换。
2. 填 API 密钥：向导会提示输入；用订阅账号的话也有对应的 OAuth 登录路径。
3. 配置网关：端口、守护进程安装；跳过的话后面还能补。
4. 选聊天渠道：Telegram 一个机器人令牌就能通，向导里按需安装，也可以先跳过。
5. 可选步骤：Skills、插件、网络下载等耗时项——都允许跳过，稍后用 openclaw configure 回来补。

耗时会因什么变长

官方提示：提供商登录、渠道配对、守护进程安装、网络下载、Skills 或可选插件都可能拉长引导时间。赶时间就全跳可选步骤，先把第一条消息发出去。

引导完成后验证

openclaw gateway status   # 网关在监听 18789
openclaw dashboard        # 打开浏览器 Control UI

Control UI 的聊天框里输入一句话，收到回复即整条链路通了。

常见卡点

• 没有 API 密钥：先看模型选择，或直接用订阅登录（见订阅登录）。
• 手机端想一步到位：引导里生成的 Setup Code / 二维码就是给手机用的，见手机配对。
• 中途出错：跑 openclaw doctor 修复迁移配置后重新引导，幂等。

引导完成后，进入手机配对。