OpenClaw 全平台安装

🦞 OpenClaw 全平台安装教程（最新版）

一、安装前准备

系统要求

操作系统	最低配置	推荐配置
Windows 10+/Server 2016+	2核4GB内存，20GB硬盘	4核8GB内存，40GB SSD
macOS 12+/Linux (Ubuntu 20.04+/Debian 11+)	2核4GB内存，20GB硬盘	4核8GB内存，40GB SSD
WSL2 (Windows子系统)	与Windows相同	与Windows相同

必备条件

• 稳定网络连接（安装过程需下载约200MB文件）

• 管理员/root权限（用于全局安装和服务配置）

• 终端/PowerShell可正常运行（无特殊权限限制）

---

二、快速安装（推荐：一键脚本）

1. Windows系统（PowerShell）

1. 以管理员身份打开PowerShell

   • 按 Win+X，选择"终端(管理员)“或"Windows PowerShell(管理员)”

   • 出现UAC提示时点击"是"

2. 解锁脚本执行权限（首次安装必做）

   
   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
   

   输入 Y 确认政策变更

3. 执行一键安装脚本

   
   iwr -useb https://openclaw.ai/install.ps1 | iex
   

   脚本会自动完成：Node.js检测安装、OpenClaw全局安装、环境配置

2. macOS/Linux/WSL2（终端）

1. 打开终端（macOS：启动台→其他→终端；Linux/WSL2：Ctrl+Alt+T）

2. 执行一键安装脚本

   
   curl -fsSL https://openclaw.ai/install.sh | bash
   

   国内用户可使用加速镜像：

   
   curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
   

   输入密码（Linux/macOS）确认权限提升

---

三、手动安装（适合高级用户）

1. 安装Node.js（LTS版本推荐）

1. 访问 Node.js官网 下载对应系统的LTS版本

2. 运行安装程序，勾选"Add to PATH"选项

3. 验证安装：

   
   node --version  # 应显示 v20.x 或 v22.x (LTS)
   npm --version   # 应显示 10.x 或更高版本
   

2. 安装OpenClaw CLI

# 使用npm（推荐）
npm install -g openclaw@latest

# 或使用pnpm（更快）
pnpm add -g openclaw@latest  # 需先安装pnpm: npm install -g pnpm

安装时间约5-12分钟，取决于网络速度

---

四、初始化配置（必做）

1. 启动引导向导（自动/手动）

   
   openclaw onboard --install-daemon
   

   向导会引导完成：

   • Gateway服务安装（系统自启动）

   • 工作区创建与配置

   • 通道设置（支持Discord/飞书/微信等）

   • 技能商店初始化（默认安装基础技能包）

2. 启动控制面板

   
   openclaw dashboard
   

   自动打开浏览器访问 http://localhost:8080（默认端口）

---

五、验证安装成功

1. 检查版本

   
   openclaw --version
   

   预期输出：2026.x.x（当前最新版）

2. 检查Gateway服务状态

   
   openclaw gateway status
   

   显示 Running 表示服务正常

3. 测试基础功能

   
   openclaw chat "Hello OpenClaw!"
   

   收到AI回复即表示安装成功

---

六、常见问题排查

问题	解决方案
权限不足错误	重新以管理员/root身份运行终端/PowerShell
脚本执行被阻止	执行Windows解锁权限命令或Linux chmod +x 赋予脚本执行权
Node.js安装失败	手动下载安装Node.js LTS版本，确保添加到系统PATH
Gateway启动失败	检查端口8080是否被占用（`netstat -ano
控制面板无法访问	确认Gateway服务已启动，尝试重启服务：openclaw gateway restart

---

七、后续操作与卸载

1. 更新OpenClaw

# npm
npm update -g openclaw

# pnpm
pnpm update -g openclaw

2. 完全卸载

# 卸载CLI
npm uninstall -g openclaw  # 或 pnpm remove -g openclaw

# 删除配置与数据（谨慎操作）
rm -rf ~/.openclaw

---

八、进阶安装（源代码编译，适合开发者）

# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装依赖
pnpm install

# 构建项目
pnpm build

# 链接到全局
pnpm link --global

# 初始化
openclaw onboard --install-daemon