Windows 11 安装 OpenClaw 完整指南

OpenClaw 是基于 Node.js 的 AI 助手框架，Windows 11 64 位系统可通过一键脚本（推荐）或手动安装两种方式部署，以下是详细步骤。

一、系统要求

• 操作系统：Windows 11 64 位（32 位不支持）
• 内存：最低 2GB，推荐 4GB+（本地跑模型建议 8GB+）
• 硬盘：预留 ≥500MB 空间
• 网络：稳定联网（下载依赖、调用模型）
• 权限：需管理员权限执行安装

---

二、方式一：一键脚本安装（推荐，新手首选）

1. 以管理员身份打开 PowerShell

• 按 Win + X，选择 终端（管理员） 或 Windows PowerShell（管理员）
• 弹出 UAC 提示时，点击 是 确认

2. 配置 PowerShell 执行策略（首次必做）

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

• 提示时输入 Y 并回车，允许运行本地脚本

3. 执行官方一键安装脚本

# 官方脚本
iwr -useb https://openclaw.ai/install.ps1 | iex

# 国内镜像（下载慢时用）
# iwr -useb https://clawd.org.cn/install.ps1 | iex

• 等待 3–5 分钟，脚本自动安装 Node.js、OpenClaw 及依赖
• 防火墙提示时，点击 允许访问

4. 初始化配置（关键）

# 快速初始化（推荐）
openclaw onboard --flow quickstart

# 或完整配置（含守护进程）
openclaw onboard --install-daemon

• 按提示选择 AI 模型、设置端口（默认 18789）、配置 API Key

5. 启动与验证

# 启动服务
openclaw start

# 验证版本
openclaw --version

# 访问 Web 管理页（默认端口 18789）
# 浏览器打开：http://localhost:18789

• 能正常打开管理页、无报错即安装成功

---

三、方式二：手动安装（适合进阶用户）

1. 安装 Node.js（必备）

• 下载：Node.js 官网，选择 Windows 64 位 LTS（22.x+）
• 安装：双击 .msi 包，务必勾选 Add to PATH，其余默认
• 验证：重启终端，执行

  node -v
  npm -v
  

  显示版本号即成功

2. 安装 Git（可选，源码开发用）

• 下载：Git 官网，安装默认配置即可
• 验证：git --version 显示版本

3. 全局安装 OpenClaw

# 以管理员身份运行 PowerShell
npm install -g openclaw@latest

• 等待安装完成，无报错即成功

4. 初始化与启动（同一键脚本步骤 4–5）

openclaw onboard --install-daemon
openclaw start

---

四、常见问题与解决

1. 提示“禁止运行脚本”

• 执行：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，输入 Y 确认

2. openclaw 命令无法识别

• 检查 Node.js 是否添加到 PATH：Win + R → 输入 sysdm.cpl → 高级 → 环境变量 → 系统变量 Path 中添加 C:\Program Files\nodejs\
• 重启终端后重试

3. 安装/启动失败

• 关闭杀毒软件/防火墙（临时）
• 以管理员身份重新运行所有命令
• 卸载重装：npm uninstall -g openclaw，再重新安装

4. Web 页面无法访问

• 检查端口是否被占用：netstat -ano | findstr :18789
• 重启服务：openclaw gateway restart

---

五、卸载 OpenClaw

# 全局卸载
npm uninstall -g openclaw

# 删除配置文件（可选）
# 配置目录：C:\Users\[你的用户名]\.openclaw

需要我帮你排查安装过程中遇到的具体报错，并给出针对性修复命令吗？