夜雨聆风摘要：安装OpenClaw真正的坑不在技术，在顺序。三大平台详细步骤，含报错速查。
你在群里问了一句"OpenClaw 怎么装"，三个人给你发了三条命令，一条也没跑通。
这不是你的问题。
OpenClaw 的官方文档写得相当克制——信息都在，但不告诉你哪步容易翻车，也不告诉你 Windows 和 Mac 的坑完全不同。
315K GitHub Star 的项目，装上它的人反而是少数。
本文把三个平台的安装流程全部跑了一遍，踩了坑写下来，希望你能直接用。
先说清楚：OpenClaw 到底装的是什么
很多人把 OpenClaw 理解成一个聊天 App，装上去就能用。
这个理解有一半是对的，有一半会让你找不着北。
OpenClaw 本质是一个本地运行的 AI Gateway——一个网关服务，持续在你电脑后台跑着，把消息从 Telegram、微信、飞书等平台转发给大模型，再把回复送回来。
所以你装的不是一个"软件"，是一个后台服务 + 命令行工具的组合。
这一点搞清楚，后面的步骤就不会迷路了。
它需要的东西只有两个：
- Node.js 22+
（运行环境，像 Java 之于很多软件） - 模型 API Key
（大脑来源，OpenRouter 免费注册就有）
其他的，安装脚本全部自动搞定。
macOS：最简单，但有一个必须注意的地方
打开终端（Cmd + 空格 搜 Terminal），粘贴这一行：
curl -fsSL https://openclaw.ai/install.sh | bash
脚本会自动检测你有没有 Node.js，没有就帮你装，然后安装 OpenClaw CLI，最后启动配置向导。
全程 3-5 分钟，中间不需要你做任何事。
跑完之后你会看到一个配置向导（onboard）。这里是第一个容易犯错的地方：
向导会问你选 QuickStart 还是 Advanced。
选 QuickStart。Advanced 不是给你准备的，那是给已经跑过一遍的人用的。
向导的关键步骤：
安全确认 → 选 Yes 配置模式 → 选 QuickStart 模型提供商 → 选 Custom Provider
然后填入（以 OpenRouter 免费模型为例）：
API Base URL：https://openrouter.ai/api/v1
API Key：sk-or-v1-你的密钥
Model ID：stepfun/step-3.5-flash:free
向导后面还会问渠道配置、技能配置。**全部先跳过**，后面再配。
最后验证一下：
openclaw --version
openclaw status
看到 Gateway running，就装好了。
macOS 最常见的坑： 装完之后跑 openclaw 提示"命令未找到"。解决方法：
export PATH="$(npm prefix -g)/bin:$PATH"
把这行加到 ~/.zshrc 文件末尾，重新开终端就好。
Windows：强烈建议用 WSL2，原因只有一个
Windows 原生安装（PowerShell）能跑，但你会在文件路径、换行符这些地方持续踩坑。
如果你只是想快速试一下，用 PowerShell：
以管理员身份打开 PowerShell，先跑这条（允许执行脚本）：
Set-ExecutionPolicy-ExecutionPolicy RemoteSigned -Scope CurrentUser
然后：
iwr-useb https://openclaw.ai/install.ps1 | iex
等它跑完，配置向导和 macOS 一样。
但如果你打算长期用，还是装 WSL2。
WSL2 就是 Windows 里面跑一个 Linux，OpenClaw 在 Linux 环境下更稳定，报错更少。
装 WSL2 只需要三步：
以管理员身份打开 PowerShell，运行 wsl --install重启电脑 开始菜单搜"Ubuntu"，打开后设置用户名密码
之后在 Ubuntu 终端里，用 macOS 那条脚本安装 OpenClaw 即可：
curl -fsSL https://openclaw.ai/install.sh | bash
Windows 最容易遇到的问题：
装完跑 openclaw 提示"命令未找到"——这是 PowerShell 的执行权限问题，重新以管理员身份运行那条 Set-ExecutionPolicy 命令，然后重开终端。
Linux / VPS：推荐在干净镜像上安装
和 macOS 一样的脚本：
curl -fsSL https://openclaw.ai/install.sh | bash
如果你是在 VPS 上部署，有一条最重要的建议：
不要用第三方"一键镜像"，用干净的 Ubuntu LTS 基础镜像。
第三方镜像版本不可控，一键镜像里的 Node.js 版本经常不对（OpenClaw 需要 Node 22+），装完就各种奇怪报错。
干净 Ubuntu 22.04 + 官方脚本 = 最稳定的组合。
VPS 上还需要考虑：
要远程访问控制面板，建议用 Tailscale，比直接暴露端口安全 Gateway 以 systemd 服务运行，开机自启，不需要保持 SSH 连接
配置 API Key：零成本起步的方案
OpenClaw 本身免费开源，但它需要连接一个模型来获得"智能"。
最省事的起步方案：OpenRouter 的免费模型。
打开 openrouter.ai，用 Google 账号注册 右上角头像 → Settings → API Keys → Create 复制以 sk-or-v1-开头的密钥（只显示一次，立刻保存）
免费模型（带 :free 后缀）日常用完全够。Step 3.5 Flash、Gemma 3 这些都不要钱。
想用 DeepSeek、Kimi 等国内模型的，在向导里填入：
API Base URL：https://api.siliconflow.cn/v1
API Key：sk-你的密钥
Model ID：deepseek-ai/DeepSeek-V3
硅基流动新注册送 16 元额度，DeepSeek V3 约合 800-1500 次对话。
验证安装：三条命令看懂状态
openclaw --version # 确认 CLI 已安装
openclaw status # 查看 Gateway 是否在运行
openclaw chat # 开始第一次对话
如果 openclaw status 显示 Gateway running，在浏览器打开：
http://localhost:18789
这是控制面板，可以可视化管理你的 Agent、查看对话历史。
试着输入：“你好，请介绍一下你自己”
龙虾回复了，安装就成功了。
常见报错速查
openclaw: command not found → PATH 没有配置好。运行：
export PATH="$(npm prefix -g)/bin:$PATH"
并加到 ~/.zshrc 或 ~/.bashrc。
API key not found → 重新跑配置向导：openclaw onboard
sharp build errors（安装时报错） → 系统已安装的 libvips 版本冲突，改用 npm 的 legacy 模式：
npm install -g openclaw --ignore-scripts
安装脚本下载慢或超时 → 手动下载脚本到本地后执行：
curl -fsSL https://openclaw.ai/install.sh -o install.sh
bash install.sh
机器人回复极慢 → 换速度更快的模型，如 deepseek-ai/DeepSeek-V3 或 stepfun/step-3.5-flash:free
装完之后：三件必做的事
1. 安装 Gateway 服务（让它开机自启）
openclaw gateway install
这样你不需要每次手动启动，后台服务随系统启动。
2. 跑一次 doctor（健康检查）
openclaw doctor
它会检查配置文件、服务状态，发现问题直接告诉你怎么修。
3. 升级方式记住
以后有新版本，直接重跑安装脚本就行：
curl -fsSL https://openclaw.ai/install.sh | bash
脚本会自动检测并原地升级，不会清空你的配置。升级后记得运行 openclaw doctor 和 openclaw gateway restart。
安装 OpenClaw 唯一难的地方，是你不知道"装的是什么"。
搞清楚它是一个后台 Gateway 服务，选对平台，用官方脚本——大多数人 5 分钟以内能跑起来。
真正有意思的部分从这里才开始：接入 Telegram、配置飞书、给龙虾装技能……那些留到下一篇讲。
你在安装过程中卡在了哪一步？
留言告诉我，下期专门做一期「OpenClaw 报错100问」。
觉得有用的话，点个在看，下次还会第一时间收到。
