🚀 龙虾新手指南

OpenClaw一键安装脚本实测：Win/Mac/Linux三平台全自动部署与报错解决

发布时间：2026-08-12 分类：龙虾新手指南

摘要：一行命令全自动部署！OpenClaw 官方安装脚本实测：Win/Mac/Linux 三平台 1 分钟启动（含报错急救指南）想试试 OpenClaw（龙虾开源版机器人控制框架），但卡在环境搭建上：Node 版本不对、Python 路径混乱、npm install 卡死、Windows 上还得手动配 PowerShell 权限……折腾两小时，连首页都没跑起来。OpenClaw 官方提供了一键安装...

OpenClaw一键安装脚本实测：Win

一行命令全自动部署！OpenClaw 官方安装脚本实测：Win/Mac/Linux 三平台 1 分钟启动（含报错急救指南）

想试试 OpenClaw（龙虾开源版机器人控制框架），但卡在环境搭建上：Node 版本不对、Python 路径混乱、npm install 卡死、Windows 上还得手动配 PowerShell 权限……折腾两小时，连首页都没跑起来。

OpenClaw 官方提供了一键安装脚本 install-openclaw.sh（Windows 对应 .ps1）。它不是简单下载解压，而是真正“懂你”的安装器：自动识别系统 → 检查 Node 是否存在 → 若缺失或版本低于 18.0，则静默安装 Node 18 LTS → 拉取最新代码 → 安装依赖 → 启动服务 → 自动打开浏览器引导页。全程无需手动干预，新手也能直接跑通。

✅ 步骤（三平台统一命令，复制即用）

Mac / Linux 用户（终端中执行）：

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

Windows 用户（PowerShell 管理员模式运行）：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser; iwr https://raw.githubusercontent.com/yitb/openclaw/main/install-openclaw.ps1 | iex

⚠️ 必须管理员权限：脚本需写入 C:\Program Files\nodejs\ 或修改系统 PATH，普通用户权限会拒绝写入。

🔍 为什么这行命令能“全自动”？

curl ... | bash 不是裸奔执行：脚本开头校验 SHA256 确保源码完整；Node 安装统一走 nvm（Mac/Linux）或 nvm-windows（Windows），不污染全局环境；
检测到 Node 20+？跳过安装，直接执行 npm ci（比 npm install 更快更稳定）；
检测到 Windows 桌面环境？自动注册为后台服务，并生成带龙虾图标的桌面快捷方式；
启动后监听 http://localhost:3000，并调用 start http://localhost:3000（Win/Mac）或 open http://...（Linux），不用手动复制地址。

✅ 验证是否成功

执行完命令后，终端最后几行应显示：

✅ OpenClaw is running at http://localhost:3000
👉 First-time users: follow the onboarding wizard (5 min)
📁 Project root: /home/you/openclaw  # Mac/Linux 路径
📁 Project root: C:\Users\You\openclaw  # Win 路径

此时浏览器自动弹出向导页：选择硬件类型（USB 摄像头 / 树莓派 / 模拟器）、测试电机响应、保存第一个动作序列——不是 demo，是真实可操作的控制台。

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

❌ 常见报错 & 急救方案（亲测有效）

报错现象	原因	解决命令
`Permission denied`（Mac/Linux）	curl 下载后 bash 没执行权	`chmod +x install-openclaw.sh && ./install-openclaw.sh`
`npm : 无法加载文件…执行策略限制`（Win）	PowerShell 默认禁止运行本地脚本	先单独运行 `Set-ExecutionPolicy RemoteSigned -Scope CurrentUser`，再执行安装命令
`Node.js v16.x detected, but v18+ required`	旧 Node 冲突（如 nvm 切换失败）	手动卸载旧版：Win 控制面板卸载；Mac `nvm uninstall 16`；再重跑安装命令
`ERR_CONNECTION_REFUSED`（浏览器打不开）	防火墙/杀软拦截 localhost:3000	临时关闭防火墙，或浏览器地址栏手动输入 `http://127.0.0.1:3000`（绕过 DNS 缓存）

💡 小技巧：安装后想改端口？直接编辑 openclaw/.env 文件，把 PORT=3000 改成 PORT=8080，然后 npm run dev 重启。

🧩 实际能做什么？（新手第一天就能玩）

用笔记本摄像头 + OpenClaw Web UI 实时查看机械臂视觉反馈；
拖拽式拼接“抓取→旋转→放置”动作块，导出 JSON 指令发给真实舵机；
在 examples/ 目录下运行 node demo-arm.js，让机械臂自动画五角星（需接好 USB 舵机控制器）。

这不是玩具框架——龙虾官网 yitb.com 上所有教学视频，底层都跑在这个脚本部署的 OpenClaw 实例上。

✅ 已成功启动？立刻看《OpenClaw 硬件接入实战：USB舵机零配置识别》
⚠️ 想离线部署？《Ollama + OpenClaw：本地大模型驱动机械臂语音指令》已上线
🔧 遇到其他报错？直接提交 issue 到 github.com/yitb/openclaw/issues，附上 install.log 文件（脚本自动生成）。

返回首页