先确认当前版本要求

怎么选环境

为什么先讲 macOS 和 Windows

因为这两条路径覆盖了最常见的第一批用户，而且最容易从“能启动”推进到“能用”。Linux、国内云和本地模型路径当然重要，但不想一开始就把选择题拉得过宽。

本机本地部署时，先做最小准备

如果你现在只想先把 OpenClaw 在自己电脑上跑起来，最省时间的顺序通常是：

1. 先安装 Node.js ≥ 22（推荐 Node 24）
2. 再打开终端确认 node -v 返回 v22 以上版本
3. 用官方一键脚本安装，或走 npm 路线
4. 跑通之后再接模型、渠道和技能

官方中文安装入口：

• OpenClaw 官方中文安装教程

常见的三种安装方式，怎么选

第一次安装通常有三条最常见的路。选择的关键不是“哪条最强”，而是“哪条最适合你当前阶段”。

{`# macOS / Linux
curl -fsSL \\
  https://openclaw.ai/install.sh | bash
Windows PowerShell
iwr -useb \
https://openclaw.ai/install.ps1 | iex
或者 npm 路线
npm install -g openclaw@latest
openclaw onboard --install-daemon`}

{`docker pull openclaw/openclaw:latest
docker run -d \\
  --name openclaw \\
  -v ~/.openclaw:/root/.openclaw \\
  openclaw/openclaw:latest`}

{`git clone \\
  https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build
openclaw onboard --install-daemon`}

如果你还没有明确理由，先用一键脚本或 npm 路线起步。

安装前先做三项检查

{`node -v
npm -v
docker --version
git --version`}

{`npm config set registry https://registry.npmmirror.com/`}

直接复制这套“安装前最小检查”

如果你现在就准备开始动手，可以先把下面这组内容直接贴到自己的备忘录里，按顺序跑一遍：

安装前最小检查

1. 打开终端 / PowerShell
2. 运行：
   node -v
   npm -v
   docker --version
   git --version
3. 如果 npm 下载明显很慢，再决定要不要切镜像：
   npm config set registry https://registry.npmmirror.com/
4. 打开官方安装文档，确认当前版本要求
5. 先选一条最短路径，不要同时试多种安装方式
6. 想清楚失败时怎么回滚：目录在哪、配置在哪、日志在哪

如果你更想直接复制命令，先用这一组最小检查：

node -v
npm -v
docker --version
git --version

初始化第一轮，一般只先收这几件事

安装完成后，别急着改所有配置。第一轮初始化建议按以下顺序来：

1. 先运行初始化向导
2. 先选一条模型路线
3. 先填一组 API Key
4. 先接一个消息平台
5. 先把权限收在沙盒模式

最常见的起点命令就是：

openclaw onboard --install-daemon

向导里真正要做的，不是把所有选项都点一遍，而是先完成这几项：

• 至少选一个模型提供商
• 至少填一组 API Key
• 至少选一个消息平台
• 建议先把权限收在沙盒模式

第一次启动后，先做最小自测

很多人装完就直接开始长对话，这样很难判断到底哪一层已经跑通。更稳的做法是先做最小自测：

openclaw --version
openclaw gateway status
openclaw dashboard

Dashboard 默认地址：http://127.0.0.1:18789/

然后只检查三件事：

• 命令能不能正常启动 → 应该看到版本号和服务状态
• Dashboard 能不能打开 → 浏览器访问应显示控制面板首页
• 当前配置是不是已经被正确写入 → config list 应列出你刚才填写的模型和渠道信息

如果 openclaw 命令返回 command not found，说明安装没成功或 PATH 没配对。先回到上面的安装步骤重新确认。

模型没准备好时，先把入口收齐

很多人第一次不是卡在安装，而是装完之后发现没有可用模型。对中文用户来说，比较常见的准备入口包括：

• Kimi Coding Plan
• MiniMax Coding Plan
• 智谱 GLM Coding
• 火山方舟 Coding Plan
• 阿里云 Coding Plan

这一步的目标不是一上来比较谁最强，而是先找一个你能获得、能支付、也能稳定维护的模型入口。

中文用户最常见的两条组合路线

如果你更偏中文团队场景，实操里常见的组合通常是这两条：

这两条路线都不是要你一次性把所有配置做满，而是先把“服务启动、模型可用、消息能收发”这三件事跑通。

如果你不想自己维护环境，可以先看托管路线

除了本机本地部署和自己买服务器，中文用户现在还有一条更省心的起步路线：直接用飞书妙搭或 ArkClaw 这类托管方案，把 OpenClaw 先跑起来，再回头补理解。

这类路线更适合：

• 你主要就是想先在飞书里用起来
• 你不想先管服务器、依赖和网关运维
• 你更希望先体验 7 x 24 在线和官方/平台插件能力

它们的核心价值不是“更自由”，而是：

• 更快上线
• 更少环境维护
• 更适合验证飞书工作流是否真有价值

如果你现在最在意的是零门槛体验，而不是完全自己维护环境，这类路线往往比本地部署更适合做第一步。

跑坏了先别重装，先这样排查

很多第一次安装失败的情况，其实不需要立刻删掉重装。你可以先按这个顺序做最小排查：

1. 如果当前对话已经很乱，先用 /new 开一个新对话
2. 执行诊断命令，看当前环境到底坏在哪
3. 只有在确认能自动修复时，再尝试 repair

openclaw doctor
openclaw doctor --repair

如果你想给自己留一句最实用的排障顺序，先记住这一条：

先 /new，再 doctor，再 repair。
只有 doctor 和 repair 都救不回来时，再考虑重装。

如果你只是某一项配置没跑通，先诊断通常比直接重装更省时间。

如果你更想按任务推进，而不是按零散命令推进，下一步建议直接去看 OpenClaw 实战练习路线。

安装完成后别急着庆祝

安装成功只是第一步。下一步更重要的是：

1. 接一个实际渠道
2. 装几项基础技能

安装后第一步，不是急着上功能，而是先把配置收稳

很多“装好了但不好用”的问题，不是安装本身错了，而是安装后没有先把下面几件事收住：

• gateway.auth.mode
• token / password 认证方式
• 至少一个可用模型入口
• 更新通道
• openclaw doctor

如果你现在已经装好，但还没有把这些内容确认过，先去：

• 安装后第一步

3. 用一个真实任务验证链路

如果你只停在“服务起起来了”，其实还没有真正开始用。