OpenClaw 新手引导 onboarding 全流程：从 API Key 到网关上线

安装完成后，官方推荐的第一条命令就是新手引导。它会把你需要决策的事项全部变成选择题，跑完即拥有一个在运行的网关。

启动引导

openclaw onboard --install-daemon

--install-daemon 参数表示顺带把守护进程装上（macOS 是 LaunchAgent，Linux 是 systemd 用户服务），这样网关会常驻并开机自启。官方文档给出的预期是：快速路径约五分钟。

引导中会遇到的决策点

• 选模型提供商：Anthropic、OpenAI、Google 等，随后粘贴对应的 API Key。官方建议选最新一代中能力最强的模型——工具型智能体对模型能力敏感。
• 配置网关：绑定地址、端口（默认 18789）、控制界面访问凭据，引导会给默认值，初学者照单全收即可。
• 接第一个渠道（可选）：引导里可以直接配 Telegram 等渠道，也可以跳过以后再说。
• 装技能与插件（可选）：首次引导可能下载技能列表，嫌慢可以全跳过，之后用 openclaw configure 回来补。

跳过了怎么办

引导是可重入的：任何时候运行 openclaw configure 都能回到引导式配置，补齐渠道、模型或守护进程。已显式设置过的选项（比如私信会话隔离策略）不会被引导覆盖。

引导后的三个确认动作

1. openclaw gateway status ——确认网关在监听。
2. openclaw dashboard ——浏览器里打开控制界面，能看到聊天窗口就说明全链路通了。
3. 在控制界面的聊天框里发一条消息，收到回复即完成首次闭环。

如果某一步报错，先跑 openclaw doctor，它会验证并修复大部分常见配置问题（详见 诊断命令）。

相关阅读：常驻后台、第一次对话。