目录
Win10系统如何部署OpenClaw
Word疑难咋整
2026年03月09日 21:26
收录于文集
共2篇
openclaw

在 Windows 10 x64 本地部署 OpenClaw 有两种主流方案：新手一键安装（原生 PowerShell） 和 WSL2 稳定版（推荐生产使用）。核心依赖为 Node.js ≥22.x LTS、Git，推荐使用 pnpm 管理包以提升稳定性。

环境准备（必做）

系统要求

  • Windows 10 64 位，版本 ≥21H2（低于此版本请先通过 Windows 更新升级）。

  • 硬件：≥8GB 内存、≥20GB SSD 空闲空间（4GB 内存可能卡顿）。

依赖安装

  1. Node.js 22.x LTS 下载地址：https://nodejs.org/zh-cn/download/ 安装时勾选 “Add to PATH”，完成后在 PowerShell 验证： node --version # 应显示 v22.x.x npm --version # 应显示 10.x.x

  2. Git 下载地址：https://git-scm.com/download/win 安装后验证： git --version # 应显示 git version 2.x.x

  3. pnpm（推荐） npm install -g pnpm pnpm config set registry https://registry.npmmirror.com/ # 国内镜像加速

方案一：新手一键安装（原生 PowerShell，最快）

1. 解锁 PowerShell 脚本权限

以管理员身份打开 PowerShell，执行：

代码块
PlainText
自动换行
复制代码
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
复制成功

提示时输入 Y 确认。

2. 执行官方安装脚本

关闭管理员 PowerShell，打开普通权限 PowerShell，执行：

代码块
PlainText
自动换行
复制代码
# 官方脚本（国内网络较慢时用下方镜像）
iwr -useb https://openclaw.ai/install.ps1 | iex

# 国内镜像脚本（推荐）
iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex
复制成功

等待终端显示 “OpenClaw installed successfully” 即完成。

3. 验证安装

代码块
PlainText
自动换行
复制代码
openclaw --version  # 应显示当前版本（如 v2026.3.2）
复制成功

方案二：WSL2 稳定版（推荐，兼容性最佳）

1. 启用 WSL2 并安装 Ubuntu

以管理员身份打开 PowerShell，执行：

代码块
PlainText
自动换行
复制代码
wsl --install -d Ubuntu
复制成功

重启电脑后，设置 Ubuntu 用户名和密码。

2. 在 WSL2 中安装依赖

代码块
PlainText
自动换行
复制代码
sudo apt update && sudo apt upgrade -y
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs git
npm install -g pnpm
pnpm config set registry https://registry.npmmirror.com/
复制成功

3. 安装 OpenClaw

代码块
PlainText
自动换行
复制代码
# 官方脚本
curl -fsSL https://openclaw.ai/install.sh | sh

# 国内镜像脚本
curl -fsSL https://open-claw.org.cn/install-cn.sh | sh
复制成功

4. 验证安装

代码块
PlainText
自动换行
复制代码
openclaw --version
复制成功

初始化配置（两种方案通用）

  1. 启动新手向导： “`powershell 原生 Windows openclaw onboard

# WSL2 openclaw onboard

代码块
PlainText
自动换行
复制代码
2. 按向导完成：
   - 选择 **“Local First”**（本地优先）模式。
   - 配置 AI 模型：支持本地模型（如 Llama 3）或云端 API（如 OpenAI）。
   - 绑定消息渠道（如 Telegram、Discord）。

3. 启动 OpenClaw：
   ```powershell
   openclaw start
复制成功

打开浏览器访问 http://localhost:3000 即可使用 Web UI。

常见问题与避坑

问题解决方案脚本执行被禁止重新以管理员身份执行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUserNode.js 版本过低卸载旧版本，安装 Node.js 22.x LTS依赖下载缓慢配置 pnpm 国内镜像：pnpm config set registry https://registry.npmmirror.com/原生 Windows 工具兼容性差切换到 WSL2 方案启动后端口被占用执行 openclaw start --port 3001 更换端口

进阶：源码编译（开发者用）

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

  2. 安装依赖并构建： pnpm install pnpm build pnpm ui:build

  3. 启动： pnpm start

总结

  • 新手：优先使用方案一（一键安装），5 分钟即可完成。

  • 追求稳定性：选择方案二（WSL2），避免原生 Windows 的兼容性问题。

  • 部署完成后，通过 openclaw onboard 配置模型和渠道，即可开始使用本地 AI 代理。

cv46618552