这两天看到不少人刚接触 OpenClaw，第一步就被卡住了。
有的人是安装命令跑完以后，终端里还是找不到 openclaw；有的人是 Windows PowerShell 直接拦脚本；还有的人其实已经装好了，但后面模型没配通，就误以为是安装失败。
所以我干脆把安装这件事整理成一篇更完整的保姆帖。
这篇不讲太多抽象概念，就讲一件事：
怎么从一台普通电脑开始，把 OpenClaw 安装好，并且知道出问题时先查哪一层。
先把最关键的两条官方安装命令放前面。
Windows 用这个：
powershell -c "irm https://openclaw.ai/install.ps1 | iex"
macOS / Linux 用这个：
curl -fsSL https://openclaw.ai/install.sh | bash
如果你只想先看最短流程，可以直接记住下面这几步：
- 打开正确的终端
- 跑官方安装命令
- 关闭终端再重新打开
- 执行
openclaw --version
- 再执行
openclaw --help
- 如果命令有了但功能还没跑通，再去看模型配置和网络问题
下面我按平台慢慢写。
第一步：安装前先确认两件事，不然后面很容易误判
第一件事，是你的网络至少要能访问 OpenClaw 官网安装脚本。
Windows 可以先试：
irm https://openclaw.ai/install.ps1
macOS / Linux 可以先试：
curl -I https://openclaw.ai/install.sh
如果这里就超时、报证书错误、连接失败，那先不要急着怀疑 OpenClaw 本体。
这种情况本质上是：你的机器现在拿不到安装脚本。
第二件事，是你要先搞清楚自己当前的目标。
如果你只是想先装上看看，那目标应该是“先跑通命令”；
如果你是想后面接模型、接工具、接 Telegram、接 Discord、做自动化，那安装之后还有很多配置工作，不要把“安装成功”和“整体都能用”混成一回事。
第二步：Windows 用户这样装，最稳
如果你是 Windows，建议尽量用 PowerShell 或 Windows Terminal 里的 PowerShell。
先执行官方安装命令：
powershell -c "irm https://openclaw.ai/install.ps1 | iex"
跑完以后，不要立刻就在当前窗口继续折腾。
我建议你直接：
- 关掉当前 PowerShell
- 重新打开一个新的 PowerShell 窗口
- 再执行：
openclaw --version
如果这里能正常输出版本号，说明安装层面大概率已经没问题了。
然后继续执行：
openclaw --help
如果帮助信息也正常，说明至少命令本身已经进入可执行环境，下一步就不该再纠结“到底装没装上”，而应该去看后续配置。
第三步：macOS / Linux 用户这样装，通常更顺一点
macOS 和 Linux 直接执行官方脚本：
curl -fsSL https://openclaw.ai/install.sh | bash
安装完成后，同样建议你：
- 关闭当前终端
- 再开一个新的终端窗口
- 执行：
openclaw --version
如果能看到版本号，再执行：
openclaw --help
这两步通过以后，至少可以说明：
安装脚本已经跑完，而且 openclaw 命令已经能被当前终端识别。
第四步：很多人其实不是没装上，而是终端还没认到命令
这是最常见的情况之一。
你明明已经执行了安装脚本，但输入：
openclaw --version
却看到类似这种提示：
Windows
openclaw : 无法将“openclaw”项识别为 cmdlet、函数、脚本文件或可运行程序的名称
macOS / Linux
command not found: openclaw
这时候先别急着重装。
优先做三件事：
1）关闭当前终端，再开一个新的
这个动作非常重要，很多 PATH 或 shell 环境更新都不是立刻在当前窗口生效的。
2）重新执行
openclaw --version
3）如果还是不行，再判断是不是环境变量没生效
这类问题通常说明：
- 安装脚本执行过了
- 但当前 shell 还没有加载对应环境
- 或者终端环境本身比较混乱
这个时候最不该做的，就是立刻重复安装很多遍。
先定位比乱重装有用得多。
第五步：Windows 最常见的几个坑
1）PowerShell 不允许执行脚本
有些 Windows 机器会看到类似报错：
无法加载文件 xxx.ps1，因为在此系统上禁止运行脚本
这通常不是 OpenClaw 特有问题，而是 PowerShell 执行策略 本身的限制。
你可以先看一下当前策略：
Get-ExecutionPolicy
如果这里限制比较严格，那后面就要根据你机器的实际安全策略来处理。
尤其是公司电脑，不建议为了省事直接粗暴放开所有脚本权限。
2）irm 拉不到安装脚本
这种情况一般表现为：
- 超时
- 连接失败
- TLS / 证书报错
- 没有返回内容
这时候优先查这些：
- 你的网络能不能访问
https://openclaw.ai/
- 系统时间是不是异常
- 有没有代理 / VPN / 安全软件在拦请求
- PowerShell 当前网络环境是否受限
本质上这不是“安装程序坏了”，而是“脚本都没拿到”。
3）脚本跑完了，但 openclaw 还是找不到
这时优先怀疑：
- 当前终端没刷新
- PATH 还没生效
- 终端环境本身有历史遗留问题
最简单有效的动作还是：
- 关窗口
- 重新打开 PowerShell
- 再跑
openclaw --version
第六步：macOS / Linux 最常见的几个坑
1）curl 拉不到安装脚本
先直接试：
curl -I https://openclaw.ai/install.sh
如果这一步就失败，那先查网络、DNS、代理、证书。
因为脚本没拿到，后面当然不会成功。
2）安装看起来完成了，但命令还是不存在
很多时候是因为你当前 shell 没刷新。
先别上来就怀疑安装脚本。
建议直接：
- 关闭终端
- 重新打开终端
- 再执行：
openclaw --version
如果你本身比较熟悉命令行，也可以顺手看一下自己当前 shell：
echo $SHELL
因为有些情况下，安装脚本写入的环境文件和你实际在用的 shell 不是同一套。
3）安装已经成功，但后面调用不稳定
这类问题很多人也会算到“安装失败”头上，其实不准确。
如果你已经能正常执行：
openclaw --version
openclaw --help
那安装层面通常就已经过了。
后面如果出问题，更应该看的是：
第七步：装好以后，先用这两个命令判断“安装到底过没过”
我自己现在判断一个人是否“已经装好了 OpenClaw”，基本先看这两个命令：
openclaw --version
openclaw --help
为什么是这两个？
因为：
openclaw --version 能证明命令存在openclaw --help 能证明命令本身可以正常执行，不只是 PATH 偶然碰上了
如果这两步都过了，接下来你再遇到问题，就不应该继续围着“安装”打转了，而应该去排查下一层。
第八步：很多“安装失败”其实是模型没配通
这一点真的太常见了。
很多人安装脚本跑完、命令也有了，但一用就报错，于是下意识觉得：
- 是不是刚才没装好
- 是不是版本不对
- 是不是我的系统不兼容
但实际更常见的是这些问题：
- API key 填错
- 模型服务地址不对
- 模型名写错
- 第三方接口并不完全兼容
- 当前网络能访问官网，但访问不了模型接口
所以如果你现在的状态是：
openclaw --version 正常openclaw --help 正常- 但真正运行时出错
那就先别反复重装，优先去查：
- 模型 key
- 模型服务地址
- 模型名称
- 网络连通性
- 服务商兼容性
这一层和安装本身不是一回事。
第九步：最适合新手的正确顺序，其实很简单
如果你是第一次用 OpenClaw，我真心建议按这个顺序来，不容易乱。
第一步
按官方命令安装：
Windows：
powershell -c "irm https://openclaw.ai/install.ps1 | iex"
macOS / Linux：
curl -fsSL https://openclaw.ai/install.sh | bash
第二步
重开终端，执行：
openclaw --version
第三步
再执行：
openclaw --help
第四步
确认你后面要接的模型配置已经准备好。
第五步
先做最小测试，不要一上来就折腾复杂工作流。
比如先确认：
第六步
最后再去碰更复杂的东西，比如：
- workspace
- tools
- skills
- Telegram / Discord / Webhook
- 多 Agent / 多会话
你后面排查问题会轻松很多。
第十步：我自己给新手的一个很实际建议
不要把“安装成功”理解成“我已经能做所有事情了”。
更准确一点的理解应该是：
- 脚本安装成功，只代表程序装进来了
openclaw --version 和 openclaw --help 正常，只代表命令层面通了- 真的能稳定使用，还取决于后面的模型、网络、配置和使用方式
所以最稳的思路一直都是：
先装好
再确认命令可用
再确认模型可用
最后再做复杂玩法
如果你按这个顺序走，Windows、macOS、Linux 其实都不会太难。
