install.sh
macOS / Linux / WSL 的主力安装车。大多数人走它。
Install 导读
安装脚本到底在背后做了什么？
OpenClaw 提供三套安装脚本，分别对应 macOS/Linux/WSL 和 Windows。先搞清楚你该用哪个：`install.sh` 适合大多数交互式安装，`install-cli.sh` 不依赖 root，`install.ps1` 是 Windows 专属。最容易踩坑的是——如果从 OpenClaw 仓库内部运行脚本，它会询问你是用本地检出还是全局安装；没有 TTY 时默认走 npm 并给出警告，选错安装方法会直接退出码 2。
先讲这一页到底在解决什么
安装脚本到底在背后做了什么？
OpenClaw 提供三套安装脚本，分别对应 macOS/Linux/WSL 和 Windows。先搞清楚你该用哪个：`install.sh` 适合大多数交互式安装，`install-cli.sh` 不依赖 root，`install.ps1` 是 Windows 专属。最容易踩坑的是——如果从 OpenClaw 仓库内部运行脚本，它会询问你是用本地检出还是全局安装；没有 TTY 时默认走 npm 并给出警告，选错安装方法会直接退出码 2。
第一站
🧑🔧 三位安装师傅，分工其实很清楚
别把三份脚本看成三套世界观，它们只是服务不同场景。
install-cli.sh
像把 Node 和 OpenClaw 全塞进你自己的小柜子里，不去碰系统级安装。
install.ps1
Windows 版安装车。会尽量帮你补 Node、补 PATH，再把 OpenClaw 装进去。
一句话
不是三套产品，而是三位面向不同地面的搬家师傅。
第二站
🚚 install.sh 这位师傅，最像“先检查你家有没有缺工具，再开始搬家”
它是普通用户最常碰到的那位。
🔍 先看 Node 在不在
像搬家公司先检查你家电压够不够。缺了就帮你补。
📦 再决定 npm 还是 git
像决定是去正式商店搬整箱，还是直接去源码仓库拉最新零件。
🧭 最后可顺手跑 onboarding
像家具搬完以后，顺手带你绕房子走一圈，把灯和门都试一遍。
curl ... install.sh | bash -s -- --dry-run像先让搬家公司把搬家清单念给你听，不真的下手搬。
第三站
🗄️ install-cli.sh 则像“我不要动整栋楼的公共设施，我要一套自己的小柜子”
这就是它为什么特别强调本地 prefix。
📁
~/.openclaw像你自己房间里的一只柜子。Node、CLI、包装器都尽量放进来。
🚫 不靠 root
像不碰楼管钥匙，不去动系统全局安装区。
--prefix /opt/openclaw像告诉搬家工“别放默认小柜子，搬到我指定的大柜子里”。
--json像让安装车边干边吐结构化播报，方便自动化系统记笔记。
第四站
🪟 Windows 那位师傅，也是在做同样的事，只是会先找哪条路能把 Node 搬进来
官方写得很实在：它会先试 winget，再试 Chocolatey，再试 Scoop。
🪜 先找工具链
像搬家工先看看小区允许哪家货梯进门，哪条路通就走哪条。
🛣️ PATH 处理
装完以后还得把路牌挂上，不然你虽然搬进来了，系统却还是认不出 openclaw。
iwr -useb https://openclaw.ai/install.ps1 | iex像叫 Windows 版安装车直接开工。
-DryRun像先看工单，不下锤子。
第五站
🤖 CI and troubleshooting 那些段落，说白了就是“让安装车少聊天、可重复、好排错”
这些内容特别适合自动化环境。
--no-prompt --no-onboard像告诉安装车：“别现场问我问题，按单子默默干完就行。”
OPENCLAW_INSTALL_METHOD=git像在工单左上角先写好“今天走 git 仓库路线”。
🪤 Git / PATH / EACCES
这些典型报错，不是 OpenClaw 自己在发疯，往往是系统级搬运环境没铺平。
🎈 收尾一句
这页最值得记住的，不是参数表，而是三位安装师傅分别适合什么地面。