🚀 龙虾新手指南

OpenClaw一键安装脚本教程：自动检测系统环境/安装Node.js/配置运行依赖（Win/Mac/Linux）

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

摘要：一键安装实录：OpenClaw 官方 Install 脚本全自动检测系统/装 Node/配环境/启动向导——Windows/Mac/Linux 三平台踩坑修复清单问题刚下载 OpenClaw（开源版 Claude 桌面客户端），双击 openclaw.exe 或 openclaw.app 却弹出“找不到 Node.js”“command not found”“Permission denie...

OpenClaw一键安装脚本教程：自动检

一键安装实录：OpenClaw 官方 Install 脚本全自动检测系统/装 Node/配环境/启动向导——Windows/Mac/Linux 三平台踩坑修复清单

问题

刚下载 OpenClaw（开源版 Claude 桌面客户端），双击 openclaw.exe 或 openclaw.app 却弹出“找不到 Node.js”“command not found”“Permission denied”……不是代码错了，是根本没搭好运行环境。手动装 Node、配 PATH、改权限、装依赖？新手常卡在第一步，半小时过去还在查文档。

方案

OpenClaw 官方提供 install.sh（Mac/Linux）和 install.ps1（Windows）两个脚本。它不是“解压即用”，而是真正做完了整套初始化：自动识别操作系统 → 检查 Node.js 是否存在 → 若缺失，静默下载匹配版本（不写入全局路径，不干扰现有 Node）→ 安装 OpenClaw CLI 工具 → 启动交互式新手向导（onboarding）。全程不用打开浏览器搜“如何装 Node”。

✅ 效果：执行一条命令，3 分钟后直接看到「欢迎使用 OpenClaw」图形向导界面，填入 API Key 就能开始对话。

步骤（三平台实操）

✅ Windows（PowerShell 管理员模式）

# 1. 以「管理员身份」打开 PowerShell（右键开始菜单 → Windows Terminal (Admin)）
# 2. 执行安装（自动下载、静默装 Node、启动向导）
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force; iwr -useb https://raw.githubusercontent.com/openclaw/openclaw/main/install.ps1 | iex

为什么必须管理员？
PowerShell 默认禁止执行本地脚本。Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 是绕过限制的合法方式，只对当前用户生效，不影响系统其他部分。

✅ Mac（终端，推荐 Rosetta 兼容模式）

# 1. 打开「终端」（先用系统自带终端跑通，避免 iTerm 配置干扰）
# 2. 执行（自动检测 Intel/Apple Silicon，装 Node v20.x 沙盒版）
curl -fsSL https://raw.githubusercontent.com/openclaw/openclaw/main/install.sh | bash

为什么不用 Homebrew 装 Node？
脚本自带预编译 Node 二进制（免编译、免 Xcode），避免 brew install node 冲突已有版本或触发 xcode-select --install 提示。M2 Mac 实测 12 秒完成。

✅ Linux（Ubuntu/Debian/CentOS 通用）

# 1. 打开终端（Ctrl+Alt+T）
# 2. 运行（自动检测 glibc 版本，跳过 apt update 冗余步骤）
wget -qO- https://raw.githubusercontent.com/openclaw/openclaw/main/install.sh | bash

为什么不用 sudo？
脚本默认安装到 $HOME/.openclaw，所有文件归当前用户所有，不触碰 /usr/bin。即使没有 root 权限（公司服务器、学校机房），也能正常运行。

验证

安装完成后，终端会自动打开浏览器访问 http://localhost:3000/onboarding。
✅ 看到带「Claude Logo + Step 1: Enter API Key」的网页 → 成功
❌ 显示 ERR_CONNECTION_REFUSED → 服务未启动 → 见下方「常见问题」

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

常见问题 & 修复命令（真实踩坑汇总）

报错现象	根本原因	一行修复命令
Windows：`无法加载文件 … install.ps1，因为在此系统上禁止运行脚本`	PowerShell 执行策略拦截	`Set-ExecutionPolicy RemoteSigned -Scope CurrentUser`（再重跑安装命令）
Mac：`curl: (7) Failed to connect`	GitHub raw URL 被墙（国内网络）	改用镜像：`curl -fsSL https://ghproxy.com/https://raw.githubusercontent.com/openclaw/openclaw/main/install.sh \	bash`
Linux：`bash: wget: command not found`	最小化安装系统未预装 wget	`apt install -y wget`（Ubuntu/Debian）或 `yum install -y wget`（CentOS）
所有平台：`onboarding 页面打不开`	端口 3000 被占用（如 VS Code Live Server）	`lsof -i :3000 \	awk '{print $2}' \	xargs kill -9`（Mac/Linux）<br>`netstat -ano \	findstr :3000 `→ 记下 PID →` taskkill /PID 12345 /F`（Windows）

💡 实测提示：Windows 用户装完可额外运行 openclaw-hub 启动桌面托盘程序（支持后台常驻、快捷键唤出）。Mac/Linux 暂无此组件，但 CLI 功能完全一致。

下一步建议

✅ 已成功启动？马上学《OpenClaw 三分钟接入 Anthropic API》配置 Claude 3.5 Sonnet
❌ 卡在 Node 安装？看《手把手：离线部署 Node.js 绿色版（含 v18/v20/v22 三版本）》
想改默认端口/换模型/加插件？《OpenClaw 配置文件全字段注释版》正在更新

脚本地址开源可查：github.com/openclaw/openclaw/tree/main/install.sh —— 不信？复制链接进浏览器，自己读源码。

返回首页