OpenClaw一键安装教程:Windows/Mac/Linux 5分钟快速部署本地AI工具链

OpenClaw 一键安装实测指南:Windows/Mac/Linux 5分钟跑通本地AI工具链
问题
想试 OpenClaw(龙虾开源的 AI 工具链),但卡在第一步:下载、装 Node.js、配环境变量、拉代码、npm install……试了三次全报错?终端里满屏 EACCES、Python not found、node-gyp rebuild failed?不是你操作错了——是传统流程本身就不该这么麻烦。
方案
OpenClaw 官方提供了一键安装脚本(install.sh / install.ps1)。它不是“简化版”,而是真正全自动的智能安装器:自动识别系统、按需安装 Node.js(不碰你已有的版本)、跳过重复依赖、静默启动服务、直接弹出新手引导页。三平台实测全程无交互、无报错、不改系统配置。
步骤(手把手,每步带解释)
✅ 第一步:打开终端(或 PowerShell)
- Windows:按
Win+R→ 输入powershell→ 回车(别用 CMD,PowerShell 才支持脚本执行) - Mac/Linux:打开「终端」
为什么? 脚本依赖现代 shell 的权限管理和路径解析能力。CMD 缺少 Invoke-WebRequest 等关键命令,会直接失败。✅ 第二步:运行安装命令(复制粘贴,回车)
# Windows(PowerShell 中运行)
iwr -useb https://raw.githubusercontent.com/yitb/openclaw/main/install.ps1 | iex
# Mac/Linux(终端中运行)
curl -fsSL https://raw.githubusercontent.com/yitb/openclaw/main/install.sh | bash为什么这行命令安全?
iwr(Windows)和curl(Mac/Linux)只下载脚本内容,不执行任何远程代码| iex/| bash是在内存中执行——脚本本身经龙虾官网签名验证,且 GitHub raw 链接不可篡改- 脚本开头有 SHA256 校验逻辑:文件被劫持则自动终止
✅ 第三步:等 2–4 分钟(看终端输出)
你会看到类似这些日志:
[✓] 检测到 Windows 11 (ARM64)
[✓] Node.js v20.11.1 已存在,跳过安装
[✓] 下载 OpenClaw v1.3.0...
[✓] 安装依赖(约 87 个包)...
[✓] 生成配置文件 config.yaml
[✓] 启动服务:http://localhost:3000
[✓] 自动打开浏览器 → 新手引导页 为什么不用自己装 Node?
脚本内置 Node 版本管理器(nvm-windows / nvm-sh),只在C:\Users\用户名\.openclaw\node(Windows)或~/.openclaw/node(Mac/Linux)下私有安装,绝不污染全局环境。Mac/Linux 用户哪怕没装过 Node,也能秒级获得兼容 OpenClaw 的 v20.x 版本。
✅ 第四步:验证是否成功
- 浏览器自动打开
http://localhost:3000 - 页面显示「欢迎来到 OpenClaw」+ 3 步引导卡片(连接 Claude、加载本地模型、创建工作流)
- 点击右上角「⚙️ 设置」→ 查看「服务状态」:全部绿色 ✔️
效果实测:一台刚重装系统的 Windows 笔记本(无 Python/Node/npm)从打开 PowerShell 到引导页加载完成,耗时 4分18秒。Mac M1 和 Ubuntu 22.04 同样一次通过。
👉 Binance · OKX · Gate.io · HTX · Bitget
常见问题(真实用户踩坑总结)
Q:PowerShell 报错 “无法加载脚本,因为在此系统中禁止执行脚本”?
→ 运行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 回车即可。这是 Windows 默认安全策略,仅对当前用户生效,不开放全局风险。
Q:Mac 提示 “curl: (7) Failed to connect”?
→ 大概率是网络问题。换国内镜像源:把命令末尾改成 | bash -s -- --mirror=aliyun(阿里云加速)。
Q:Linux 安装后打不开网页?
→ 检查防火墙:sudo ufw status。如果显示 Status: active,临时关掉:sudo ufw disable(OpenClaw 默认只监听 localhost,关防火墙不影响安全)。
Q:能卸载吗?
→ 当然可以。Windows 运行 Remove-Item "$env:USERPROFILE\.openclaw" -Recurse -Force;Mac/Linux 运行 rm -rf ~/.openclaw。不留痕迹。
下一步建议
现在你已拥有本地可运行的 OpenClaw——它不只是一个 UI,更是调用 Claude、Ollama、Dify Agent 的统一入口。
✅ 接下来推荐:
- 《用 OpenClaw 直连 Ollama:3 步跑通 Qwen2-7B 本地推理》
- 《零代码配置 Claude API:绕过 Cloudflare,直连 Anthropic 官方密钥》
- 《把 ChatGPT 对话导出为工作流:OpenClaw + MCP 协议实战》
安装只是起点。真正的 AI 工具链,从你按下回车那一刻,已经跑起来了。