安装命令执行完成
没有在 Node、权限、依赖下载这些环节中途卡死。
一句话总结
最稳的起步方式永远是：先用官方推荐命令完成安装和 onboarding，再通过 Gateway 状态和 Dashboard 页面验证第一次可用闭环。
Quickstart
目标只有一个：先把 OpenClaw 跑起来。
这篇不追求讲全原理，只负责帮你完成第一次可用闭环。对大多数用户来说，最好的起步方式不是先研究 Skill，也不是先接 5 个渠道，而是先完成安装、onboarding、Gateway 检查和 Dashboard 打开。
适合第一次安装
先跑通，再细学
4 步最小闭环
Before You Start
开始前准备好这几样
大多数安装问题都不是出在命令本身，而是环境准备没到位。
操作系统
macOS、Linux，或者 Windows + WSL2。Windows 用户优先走 WSL2，这是最稳的官方推荐路径。
Node.js
需要 22 或更高版本。多数情况下官方安装脚本会帮你处理，不用先手动折腾。
网络
安装阶段至少要能正常访问 OpenClaw 官网、GitHub 和 npm，国内网络慢时建议先准备代理或镜像。
目标心态
这一步先追求“跑通”，不是一步到位接模型、接渠道、装一堆 Skill。
4 Steps
最小可用闭环：4 步就够了
只要这 4 步走通，你就已经跨过了最难的第一关。
01
安装 OpenClaw
先用官方安装脚本把基础环境和 CLI 装好，不要一开始就上源码路线。
02
运行 onboarding
让系统完成初始配置、工作区初始化和服务安装，少走弯路。
03
检查 Gateway 状态
确认最核心的网关服务已经起来，不然 Dashboard 和后续渠道都会受影响。
04
打开 Dashboard
看到控制台页面并能进入第一个会话，就算第一次跑通成功。
Step By Step
照着做就能跑通的教程流程
这一段不再讲“命令清单”，而是按真正动手时的顺序来写。你只需要一条一条执行，不要跳步。
第 1 步：打开终端，进入正确环境
macOS 和 Linux 直接打开终端即可。Windows 用户请先进入 WSL2 的 Ubuntu 终端，不要在原生 PowerShell 里直接照抄这套主路线。
第 2 步：执行官方安装命令
把下面这条命令完整复制到终端里执行：
curl -fsSL https://openclaw.ai/install.sh | bash
第 3 步：安装完成后，继续执行 onboarding
安装脚本结束后，继续在同一个终端里执行：
openclaw onboard --install-daemon
第 4 步：检查 Gateway 是否正常运行
onboarding 完成后，先不要急着去接渠道，先确认最核心的网关服务已经起来：
openclaw gateway status
第 5 步：打开 Dashboard
最后执行下面这条命令：
openclaw dashboardhttp://127.0.0.1:18789/Success Check
怎样才算“已经跑通”
不要只看命令有没有报错，真正的成功标准更具体。
onboarding 能正常结束
说明系统的最基本配置已经建立起来，而不是只装了一个壳。
Gateway 状态正常
这代表核心网关已经在运行，后续 Dashboard、渠道接入都会建立在它上面。
浏览器能打开 Dashboard
默认地址通常是 http://127.0.0.1:18789/，能打开控制台就说明闭环成立。
If Something Fails
如果这一步没跑通，先别乱跳教程
新手最容易犯的错误，是安装没成功就去看渠道接入、模型接入和 Skill 教程，结果越看越乱。
Windows 用户优先看 WSL2
如果你在原生 Windows 环境里卡住，先切回 Windows（WSL2 推荐）。
如果是系统环境问题
回到 安装总览与环境要求，先确认操作系统、Node 和网络准备。
如果是 Docker 路线
不要和本地安装混着查，直接看 Docker-CN 一键部署。
如果想看别人怎么踩坑
先去 社区安装经验分享，通常比你自己乱试更快。
After That
跑通以后，下一步看什么
第一次可用不是终点，而是你真正开始进入系统的起点。
先补首次配置细节
如果你想把 onboarding 背后的模型、Gateway、工作区理解清楚，先看这篇。
先学 Dashboard 怎么用
适合已经能打开控制台，但还不会建立会话和看状态的用户。
先接一个真实渠道
如果你的目标是飞书、钉钉或 Telegram 助手，下一步就该去渠道接入。
先理解 Gateway 与 Workspace
适合想先把系统结构搞清楚，再继续扩展的人。