这两天看到不少人刚接触 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 其实都不会太难。