Onboarding path
第一批正式内容先做一件事：按官方路径把 CLI、daemon 和 Dashboard 跑通。
本页按 2026-03-13 交叉核对官方中文文档与官方仓库整理，不追求一次讲完所有玩法，先把最短、最稳、最容易验证的起步链路讲清楚。
快速提示
当前优先推荐 Node.js 22 或 24 作为运行时基线
首轮目标是跑通 `onboard -> dashboard -> gateway status -> doctor` 这条最短链路
Windows 起步优先 WSL2；不装 WSL2 时至少使用 Git Bash
你将获得
内容风格
少废话，先给结果
先告诉你该做什么、会遇到什么，再给出最短可用路径。
阅读体验
能看懂，也能照着做
重点信息会被拆成清单、步骤和提示，减少第一次上手的理解成本。
页面重点
先把关键问题讲清楚
System routes
官方起步路径要先讲“用什么环境”，再讲“敲什么命令”。
这三张卡片不是泛泛的系统入口，而是把官方文档里真正会影响首次成功率的环境建议和验证动作收拢成一页。
Official path
Windows 优先用 WSL2；不装 WSL2 时至少用 Git Bash 起步
官方安装文档给 Windows 的建议很明确：WSL2 是首选路径；如果你暂时不装 WSL2，也不要直接拿默认 CMD 当主要环境。
推荐环境
WSL2 优先，Git Bash 次之。
前置条件
Node.js 22 或 24，并先确认 `node -v` 与 `npm -v` 正常。
起步命令
`npm install -g @openclaw/cli` 后执行 `openclaw onboard --install-daemon`。
验证目标
能打开 Dashboard，并让 `openclaw gateway status` 返回正在运行。
macOS 先走 CLI + daemon + dashboard 这条官方最短路径
macOS 不要一上来就分散配置多套 provider 或多组工具。先把 CLI、daemon、Dashboard 三件事按官方起步顺序跑通。
推荐环境
本机终端 + Node.js 22 或 24。
前置条件
全局安装 CLI 前，先确认 npm 全局安装目录和 PATH 没问题。
起步命令
`npm install -g @openclaw/cli`，然后 `openclaw onboard --install-daemon`。
验证目标
执行 `openclaw dashboard` 后能进入 onboarding，并成功发起第一轮会话。
Linux 直接按官方 CLI 流程走，但先把健康检查放到前面
Linux 通常最容易进入“命令看起来都能跑，但外部服务或 daemon 状态不对”的假成功。先做健康检查，再继续接模型和插件。
推荐环境
标准 shell + Node.js 22 或 24。
前置条件
安装 CLI 后优先跑 daemon，再确认 gateway 状态与 doctor 报告。
起步命令
`openclaw onboard --install-daemon` 之后，先跑 `openclaw doctor`。
验证目标
Dashboard 可打开、gateway 在线、doctor 没有阻断项，再继续加模型或第三方能力。
First run
第一次起步只做一件事：跑通官方最短链路，不扩权，不抢进度。
真正会让新手失焦的，不是命令多少，而是没有按顺序验证运行时、daemon、Dashboard 和健康检查。
Gateway 状态先通，再谈模型和工具
用 `openclaw gateway status` 看 daemon 是否在线。gateway 不通时继续配 provider，排错会越来越乱。
Dashboard 能打开 onboarding，才算真正进入官方起步路径
官方 Getting Started 把 Dashboard 当成首轮交互入口。只装了 CLI 但还没打开 Dashboard，不算完成第一轮起步。
Doctor 没有阻断项，才值得继续接外部服务
如果 doctor 已经提示外部服务或环境异常，先修阻断项，而不是靠继续装插件或放宽权限碰运气。
Common errors
首批排错内容先解决最常见的五个官方起步问题。
这一页暂时不追求“最全报错库”，而是优先覆盖最容易让新手在第一天卡住的运行时、终端环境、daemon、doctor 和 Bun 限制。
Node 版本不在 22 / 24 范围内
官方安装文档把 Node.js 22 和 24 作为当前推荐基线。版本不对时，CLI 能装上也不代表行为稳定。
Windows 直接在默认终端里跑，导致路径和权限判断混乱
官方文档对 Windows 起步更推荐 WSL2；不走 WSL2 时，也建议至少用 Git Bash，不要把默认终端当主环境。
daemon 没装好或 gateway 没跑起来，就开始配后续能力
如果 `openclaw onboard --install-daemon` 和 `openclaw gateway status` 这两步没通过，先别继续配模型、插件和外部服务。
外部服务不通，却没有先跑 doctor 做健康检查
`openclaw doctor` 和 `openclaw doctor --verify-external-services` 是第一层排错入口，不要直接跳进长链路日志。
需要 WA / Telegram 工具，却误用了 Bun 路径
官方安装文档明确说明：WA 和 Telegram 工具当前不支持 Bun。涉及这些能力时，优先按 Node 路径安装。
Official sources
这一页只优先采信官方文档与官方仓库能交叉验证的信息。
当前起步路径、验证命令和排错顺序，都优先来自 OpenClaw 官方中文文档；站内如果后续写到更细的模型、插件或 Fast Mode 配置，也会沿用同一套来源优先级。
官方文档 · 安装指南
用于 Node.js 22 / 24、Windows WSL2 / Git Bash 建议，以及 Bun 限制的核对。
https://docs.openclaw.ai/zh-CN/install?platform=linux
官方文档 · Getting Started
用于 `openclaw onboard --install-daemon`、Dashboard 与 gateway 起步路径。
https://docs.openclaw.ai/zh-CN/start/getting-started
官方文档 · Doctor & Health Check
用于首轮排错与外部服务验证命令。
https://docs.openclaw.ai/zh-CN/config/doctor-and-health-check