这篇教程按官方文档的最短路径整理，目标是让你尽快把 OpenClaw 跑起来，并确认控制台、渠道与网关都工作正常。
适用场景
- 你第一次接触 OpenClaw。
- 你希望按官方推荐方式安装，而不是自己拼装运行环境。
- 你想先跑通一个最小可用流程，再继续配置模型、渠道和远程访问。
先确认环境要求
根据官方安装文档，当前推荐环境如下：
- Node 24 为推荐版本。
- Node 22 LTS 仍受支持，但最低要求是
22.16+。 - 支持 macOS、Linux 和 Windows。
- Windows 官方强烈建议在 WSL2 中运行 OpenClaw。
如果你不确定本机状态，可以先执行：
bash
node -v
npm -v
方式一：使用官方安装脚本
这是官方推荐方式，会自动处理 Node 检测、CLI 安装和新手引导。
macOS / Linux / WSL2：
bash
curl -fsSL https://openclaw.ai/install.sh | bash
Windows PowerShell：
powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
如果你只想先安装，不立即跑 onboarding，可以使用：
macOS / Linux / WSL2：
bash
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Windows PowerShell：
powershell
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
方式二：使用 npm 全局安装
如果你已经自己管理 Node 环境，也可以直接安装 CLI：
bash
npm install -g openclaw@latest
openclaw onboard --install-daemon
如果安装 sharp 时失败，官方给出的处理方式是强制使用预构建二进制：
bash
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
运行 onboarding
官方首页给出的最短路径是：
bash
openclaw onboard --install-daemon
这个步骤会引导你完成初始设置，并安装 Gateway 服务。
如果你后面还需要补跑引导，也可以再次执行：
bash
openclaw onboard
登录渠道并启动 Gateway
官方首页的快速开始流程使用 WhatsApp 作为示例：
bash
openclaw channels login
openclaw gateway --port 18789
说明：
openclaw channels login用于完成渠道登录或配对。openclaw gateway --port 18789会启动本地 Gateway。- 默认控制台地址就是
http://127.0.0.1:18789/。
打开控制台
Gateway 启动后，你可以直接打开：
text
http://127.0.0.1:18789/
如果你看到 unauthorized，不要手动猜 token，直接执行：
bash
openclaw dashboard
官方说明是，这个命令会打印并尽可能自动打开带 token 的链接；UI 首次加载后会移除查询参数里的 token，并保存到本地浏览器存储。
安装完成后做一次健康检查
官方安装页建议至少跑这三个命令：
bash
openclaw doctor
openclaw status
openclaw dashboard
它们分别用于：
openclaw doctor：检查配置和运行环境问题。openclaw status：查看 Gateway 状态。openclaw dashboard：重新打开控制台。
如果终端提示找不到 openclaw
官方给出的快速诊断命令是：
bash
node -v
npm -v
npm prefix -g
echo "$PATH"
如果 $(npm prefix -g)/bin 不在你的 PATH 中，可以把它加入 shell 启动文件：
bash
export PATH="$(npm prefix -g)/bin:$PATH"
改完后重新打开一个终端，或刷新 shell 缓存。
下一步建议
完成最小安装后，建议按这个顺序继续：
- 配置一个模型提供商。
- 选择 Telegram 或 WhatsApp 作为首个消息渠道。
- 打开 Dashboard 确认聊天和会话都正常。
- 如果你准备长期运行，再配置远程访问、Tailscale 或服务器部署。