夜雨聆风新手零门槛，Windows/macOS/Linux 三系统全覆盖，一键脚本+逐步截图，10分钟搞定
一、安装前准备（必看）
系统要求
• 系统：Windows 10+/macOS 12+/Ubuntu 20.04+
• 运行环境：Node.js ≥22（脚本自动装，不用手动）
• 内存：≥4GB；磁盘：≥1GB
• 网络：可访问外网
方案选择
• Windows：WSL2+Ubuntu（最稳） > 原生PowerShell
• macOS/Linux：终端一键脚本（最快）
二、Windows 安装（WSL2 推荐版｜零报错）
步骤1：安装WSL2（管理员PowerShell）
1. 右键开始菜单 → 打开 终端(管理员)
2. 执行命令：
wsl --install
3. 重启电脑，设置Ubuntu用户名+密码（记住密码）
WSL安装命令执行界面
步骤2：WSL内一键安装OpenClaw
1. 打开Ubuntu终端，执行国内加速脚本：
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
2. 等待自动部署：Node→依赖→OpenClaw→环境变量
WSL内执行一键安装脚本
步骤3：验证安装
openclaw --version
# 输出版本号=成功
三、Windows 原生安装（简易版）
步骤1：管理员PowerShell
1. 解锁脚本权限：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
2. 执行安装：
iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex
Windows原生安装命令
四、macOS 安装（3步极速）
1. 打开终端（Command+空格搜索「终端」）
2. 执行一键脚本：
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
3. 验证：openclaw --version
macOS终端安装界面
五、Linux（Ubuntu/Debian）安装
1. 打开终端（Ctrl+Alt+T）
2. 更新依赖：
sudo apt update && sudo apt install -y git
3. 一键安装：
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
六、初始化配置（必做）
步骤1：启动配置向导
openclaw onboard
步骤2：按向导设置
• 选择网关模式：local（本地）
• 配置AI密钥（按提示输入）
• 开机自启：选Y
• 第三方平台（QQ/钉钉）：新手选N
初始化配置向导界面
步骤3：启动服务
openclaw gateway start
openclaw dashboard
# 浏览器访问：http://localhost:3000
七、常用命令（收藏）
• 查看版本：openclaw --version
• 诊断环境：openclaw doctor
• 启动网关：openclaw gateway start
• 打开控制台：openclaw dashboard
• 重启服务：openclaw gateway restart
八、常见问题
1. WSL安装失败：开启「虚拟机平台」「Windows虚拟机监控程序平台」
2. Node版本过低：脚本自动升级，手动装：https://nodejs.org/
3. 权限报错：务必用管理员/root运行
4. 网络慢：必用国内cn脚本
#open claw #龙虾