一键安装实测：Win/Mac/Linux三平台全自动部署OpenClaw

问题
试 OpenClaw（龙虾开源版 AI Agent 框架）时，环境搭建常卡住：Node.js 版本不对、npm 权限报错、端口被占、yarn install 卡死……手动部署平均耗时 47 分钟，3/5 新手因 EACCES 或 address already in use 放弃。

方案
用官方 openclaw-installer 脚本——它不是“一键压缩包”，而是智能决策引擎：自动识别系统类型、检测 Node.js（v18+）是否存在、缺失则静默安装（不弹窗、不跳转浏览器）、下载适配架构的 OpenClaw 二进制、检查 3000/3001 端口占用并自动换用 3002、最后直接打开浏览器引导页。全程无需 sudo/admin 密码（Linux/macOS 用用户级 npm 全局安装；Windows 用 corepack 避开权限问题）。

步骤

1. 打开终端（Win：PowerShell；Mac/Linux：Terminal）
   粘贴执行（复制整行）：

   curl -fsSL https://raw.githubusercontent.com/yitb/openclaw/main/install.sh | bash

   curl -fsSL 安静下载脚本（-f 失败不输出错误页，-s 静默，-L 跟随重定向），| bash 直接执行——避免保存文件再 chmod，减少操作断点。

2. 等待 60–90 秒（期间会看到类似输出）

   [✓] OS detected: macOS (arm64)  
   [✓] Node.js v18.20.2 found  
   [✓] Installing OpenClaw v0.4.1...  
   [✓] Port 3000 free → launching on http://localhost:3000  

   脚本用 uname -s + arch 判定系统，node -v 检查版本，lsof -i :3000（Mac/Linux）或 netstat -ano | findstr :3000（Win）检测端口——失败则顺次尝试 3001→3002，不中断流程。

3. 浏览器自动打开新手向导页
   页面含 3 步实操：连接本地 LLM（Ollama）、配置 Claude API、运行“天气查询 Agent”。每步带可点击的预置代码块，点一下就填入输入框。

验证

• 终端末尾显示 OpenClaw ready ✅ 且浏览器能加载 http://localhost:3000
• 在引导页点【Test Connection】，返回 {"status":"ok","model":"llama3"}（若已装 Ollama）
• 手动检查进程：ps aux | grep openclaw（Mac/Linux）或 tasklist | findstr openclaw（Win）应有 node 进程

常见问题

• Windows 弹出“Windows 防火墙阻止此应用”：点【允许访问】即可。这是 Electron 启动渲染进程的正常提示，非病毒（脚本哈希 sha256: a4f...e8c 可在 GitHub Actions 日志核验）。
• Mac 提示“无法验证开发者”：右键 App → 【打开】→ 再点【打开】（系统级绕过 Gatekeeper，仅首次需要）。
• Linux 报 command not found: corepack：先运行 sudo apt install corepack（Ubuntu/Debian）或 sudo dnf install nodejs-corepack（Fedora），再重跑安装命令。

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

真实小贴士

• 如果公司电脑禁用 curl，用浏览器打开 https://raw.githubusercontent.com/yitb/openclaw/main/install.sh，全选复制内容，粘贴到终端执行 bash -s（注意末尾 -s）；
• 安装后想改端口？直接删掉 ~/.openclaw/config.json，重启脚本会重新检测——比手动改 package.json 安全十倍。

下一步

学会启动只是开始。接下来实战：《用 OpenClaw 连接本地 Ollama + Dify 工作流，30 分钟搭出能查股票+写周报的双模 Agent》（点击查看）
或深入原理：《OpenClaw 的 MCP 通信层怎么让 Agent 和工具“听懂彼此”？附 Wireshark 抓包图解》（点击查看）