OpenClaw 安装教程：onboard 向导、API Key 与首次启动
OpenClaw 安装 OpenClaw 安装 OpenClaw onboard OpenClaw 首次启动 OpenClaw API Key OpenClaw doctor
适合谁
第一次部署 OpenClaw 的个人用户或独立开发者
完成安装、onboard 向导和第一次环境自检，避免卡在第一步。
交付物
学完后你会留下什么
一套可启动的 OpenClaw 本地环境、一份已写入的基础配置，以及一条可复用的初始检查命令清单。
开始前确认
前置条件
- 一台可运行终端命令的 macOS 或 Linux 设备
- 已经准备好你要接入的模型或服务 API Key
- 有权限写入本机配置目录并重启 shell
你会学到
OpenClaw 安装
完成安装、onboard 向导和第一次环境自检，避免卡在第一步。
安装路径图
从安装到可运行，只看这 4 步
搜索 install、onboard、doctor 的用户，最需要的是顺序和停损点，而不是更多概念页。
- 01
安装 CLI
先让 `openclaw` 命令可执行，再谈 channels 和 tools。
先确认 PATH 已生效
- 02
运行 onboard
把 API Key 和最小配置写到能启动的状态，不要一开始就塞满能力。
先配关键凭据，不求一步到位
- 03
执行 doctor
把环境、依赖、权限和配置错误先清掉，避免后面报错全变表象。
红色错误先清零
- 04
进入 Dashboard
确认服务能稳定起来，再进入 Dashboard / pairing / channel 路线。
此时才值得看界面和接入口
教程内搜索
支持桌面与移动端。回车可直接搜索。
为什么这篇值得先看
搜索“OpenClaw 安装”的用户，大多不是想看概念，而是想知道安装脚本、onboard 向导和首次验证顺序。把第一步走对，后面的 Dashboard、pairing 和 channels 才不会连环报错。
先抓住这 3 个关键点
- 安装不是终点，
openclaw onboard才是把配置写到可运行状态的关键一步。 - 第一次启动前先准备好 API Key，比装完后反复改配置省时间得多。
- 完成安装后立刻跑
openclaw doctor，能提前发现权限、依赖和路径问题。
实操步骤
- 先用官方安装脚本完成 CLI 安装，再确认 shell 已刷新，终端能识别
openclaw命令。 - 运行
openclaw onboard，按向导写入最小可运行配置，不要一开始就塞很多渠道或插件。 - 把你真正会用到的 API Key 填完整，宁可少配几个服务，也别留空关键字段。
- 执行
openclaw doctor，先把红色报错清零，再进入 Dashboard 或下一篇 pairing 教程。
配置或命令示例
curl -fsSL https://install.openclaw.sh | sh
openclaw onboard
openclaw doctor常见坑
- 安装成功但命令找不到，通常是 shell 没重载或 PATH 还没更新。
- onboard 先跳过关键凭据，后面会在 Dashboard、channels 或 browser 配置里反复返工。
- 一上来同时接 WhatsApp、Telegram、Browser，排错面会变得非常大。
完成检查
- 终端能正常返回
openclaw命令，不再出现 command not found。 - onboard 已写出基础配置，doctor 不再报致命错误。
- 你已经知道下一步该去看 Dashboard、doctor 还是 pairing。
为什么建议把这篇收藏起来
- 以后每次换机器、重装系统或拉新环境，都会回到这一步。
- 安装阶段决定了后续排错成本，是最值得收藏的一篇基础文。
官方资料
继续深挖时，先看这些官方页面
本页内容已按官方文档和产品能力重写，下面这些链接适合你做版本核对和参数确认。
常见问题
你大概率还会继续搜这几个问题
把高频疑问写在教程页内，既减少跳出，也让这篇内容更适合收藏回看。
OpenClaw 安装后第一条命令应该是什么？
先跑 openclaw onboard，再用 openclaw doctor 看配置和依赖是否完整。
API Key 一定要在安装前准备好吗？
不一定，但如果没有关键凭据，onboard 无法帮你把首次启动路径跑完整。
继续学习
下一步推荐
入门内容优先沿 01 → 02 → 03 推进，再补一篇桥接内容。