🚀 龙虾新手指南

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

发布时间:2026-08-10 分类: 龙虾新手指南
摘要:OpenClaw 一键安装实测指南:Windows/Mac/Linux 5分钟跑通本地AI工具链问题 想试 OpenClaw(龙虾开源的 AI 工具链),但卡在第一步:下载、装 Node.js、配环境变量、拉代码、npm install……试了三次全报错?终端里满屏 EACCES、Python not found、node-gyp rebuild failed?不是你操作错了——是传统流程...

OpenClaw一键安装教程:Windo

OpenClaw 一键安装实测指南:Windows/Mac/Linux 5分钟跑通本地AI工具链

问题
想试 OpenClaw(龙虾开源的 AI 工具链),但卡在第一步:下载、装 Node.js、配环境变量、拉代码、npm install……试了三次全报错?终端里满屏 EACCESPython not foundnode-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 的统一入口。
✅ 接下来推荐:

安装只是起点。真正的 AI 工具链,从你按下回车那一刻,已经跑起来了。

返回首页