OpenClaw 一键安装指南：三步跑通你的第一个AI Agent（Windows/macOS/Linux全适配）

卡在安装？这不是你的问题

想试试 OpenClaw——那个能读网页、填表单、点按钮的 AI 数字员工，结果卡在第一步：Node.js 版本不对、npm 权限报错、git clone 后依赖装不上……还得配 Python、改 PATH、手动启服务。光搭环境就耗掉一整个下午。

这不该是常态。

官方一键脚本真能“全自动”

OpenClaw 提供了 install.sh（macOS/Linux）和 install.ps1（Windows），不是简化流程，而是全程接管：

✅ 自动识别系统：Win10/Win11、macOS（Intel/M1/M2/M3）、Ubuntu/Debian/CentOS
✅ 检查 Node.js：没装？自动下载并设为默认（LTS v20.x）；装了旧版？静默升级，不碰你原有项目
✅ 拉取最新稳定版、装依赖、生成配置、开放端口
✅ 最后直接打开浏览器，启动交互式新手向导——你只用点鼠标，不用敲命令

这才是开箱即用。

三步走完

第一步：运行脚本

打开终端（macOS/Linux）或 PowerShell（Windows，必须右键 → “以管理员身份运行”）：

# macOS/Linux 用户
curl -fsSL https://raw.githubusercontent.com/OpenClaw/openclaw/main/install.sh | bash

# Windows 用户（PowerShell 中执行）
iwr -useb https://raw.githubusercontent.com/OpenClaw/openclaw/main/install.ps1 | iex

为什么必须用这个地址？
脚本托管在 GitHub 官方仓库，每次运行都拉取最新逻辑（比如上周加了 Apple Silicon 的 Rosetta 兼容检测）。用 curl 或 iwr 直接执行，省去下载再运行的步骤——少一步，少一个出错点。

第二步：等它跑完（通常 2–5 分钟）

你会看到类似输出：

[✓] Detected: macOS Sonoma (ARM64)  
[✓] Node.js v20.11.1 installed  
[✓] Cloning OpenClaw v0.8.3...  
[✓] Installing dependencies...  
[✓] Config written to ~/.openclaw/config.json  
[✓] Server started on http://localhost:3000  
→ Launching onboarding guide in your browser...

为什么不用你手动 npm install？
脚本内部用 pnpm（比 npm 快 2 倍、磁盘占用少 60%），跳过平台无关依赖（如 Linux 上不装 fsevents），避免卡死。所有操作隔离在独立目录，不影响你已有的 Node 项目。

第三步：跟着向导做第一件事

浏览器自动打开 http://localhost:3000，页面包含：

🔹 带动画的欢迎页
🔹 三个按钮：“试填登录表单”、“抓取天气预报”、“自动下载PDF”
🔹 点任意一个，OpenClaw 就会真实启动 Chrome（无痕模式）、访问目标网站、定位输入框、填测试数据、截图反馈——你只管看、点头。

为什么向导里全是真实任务？
不是“Hello World”，而是你明天就要用的场景：抢课、查快递、填报销单。每步操作都带实时日志（左下角小窗口），你能立刻看到它在“点击哪里”“等待什么元素”，不是黑盒。

验证是否真跑起来了

✅ 打开任务管理器（Win）或 Activity Monitor（Mac），node 进程 CPU <5%，内存稳定在 300MB 左右
✅ 关闭浏览器后，在终端按 Ctrl+C 可干净退出服务
✅ 再次运行 openclaw start（脚本已注册全局命令），秒启
✅ 在另一台 M1 Mac 上重装——无需改参数，结果完全一致

👉 Binance · OKX · Gate.io · HTX · Bitget

常见问题

Q：Windows 提示“无法运行脚本”？
A：PowerShell 默认策略限制。只需在管理员 PowerShell 里运行一次：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

（脚本本身不修改系统策略）

Q：卡在 “Installing dependencies…” 超过 8 分钟？
A：大概率网络问题。国内用户加 -m cn 参数提速：

curl -fsSL https://raw.githubusercontent.com/OpenClaw/openclaw/main/install.sh | bash -s -- -m cn

（自动切到淘宝 npm 镜像）

Q：浏览器打不开，或显示 “Connection refused”？
A：检查 3000 端口是否被占（比如另一个 React 项目）。临时换端口：

openclaw start --port 4000

然后访问 http://localhost:4000

接下来做什么

你现在有一个随时待命的 AI 自动化工具。推荐下一步：

➡️ 《用 OpenClaw 自动填 12306 登录表单》实战教程 —— 把向导里的“试填登录表单”拆成可复用脚本
➡️ 《给 OpenClaw 接入你自己的 ChatGPT API》 —— 替换默认模型，支持中文长思考
➡️ 《把 OpenClaw 打包成桌面应用（.exe/.dmg）》 —— 发给爸妈，双击就能用

安装只是开始。你刚省下的 90 分钟，足够让它帮你做完三件琐事。