Windows 系统 OpenClaw 完整部署过程

📋 部署前系统检查清单（必做）

检查项目	最低要求	推荐配置	验证方法
操作系统	Windows 10 2004+ (64 位)	Windows 11 23H2+ (64 位)	按 Win+R→输入`winver`→查看版本
内存	8GB	16GB+	按 Ctrl+Shift+Esc→任务管理器→性能→内存
可用磁盘	20GB	50GB+ (非系统盘)	此电脑→右键磁盘→属性→可用空间
网络	稳定宽带	50Mbps+	打开浏览器→访问speedtest.net测试
权限	管理员权限	管理员权限	右键 PowerShell→"以管理员身份运行"

🔧 阶段 1：基础依赖环境完整安装（3 个核心组件）

步骤 1.1：安装 Git（版本控制工具）

访问 Git 官网：https://git-scm.com/download/win

下载64 位安装程序（如Git-2.45.1-64-bit.exe）

双击运行安装程序，每一步都按以下设置操作：

步骤 1.2：安装 Node.js（JavaScript 运行时）

访问 Node.js 官网：https://nodejs.org/en/download/

下载LTS 版本（如 v22.16.0 LTS，64 位）→点击 "Windows Installer (.msi) 64-bit"

双击运行安装程序，每一步都按以下设置操作：

配置国内镜像（解决网络问题）：

npm config set registry https://registry.npmmirror.comnpm config set disturl https://npmmirror.com/dist

步骤 1.3：安装 PNPM（高效包管理器）

在管理员 PowerShell 中执行：

npm install -g pnpm

配置 PNPM 国内镜像

pnpm config set registry https://registry.npmmirror.com

🚀 阶段 2：OpenClaw 主程序部署（官方推荐方案）

步骤 2.1：执行官方一键安装脚本（国内加速版）

以管理员身份打开 PowerShell（必须管理员，否则权限不足）

执行国内加速安装脚本（推荐中国用户）：

先设置执行策略（首次运行必须）Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser# 执行国内加速安装脚本iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex

脚本执行过程详解

（会自动完成以下 10 个操作）：

检测系统中是否已安装 Node.js 22+

如未安装，自动下载并安装最新 LTS 版本

全局安装 OpenClaw CLI 工具

配置系统环境变量

创建 OpenClaw 配置目录（C:\Users\<用户名>\.openclaw）

下载默认配置文件

配置国内镜像源（加速模型下载）

安装核心依赖包

验证安装完整性

显示安装成功提示

步骤 2.2：解决脚本执行可能遇到的 3 个常见问题

问题 1：执行策略错误

解决方法：重新设置执行策略Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process

问题 2：网络下载失败

解决方法：手动下载安装包# 1. 访问 https://github.com/openclaw/openclaw/releases# 2. 下载最新Windows版本zip包# 3. 解压到 C:\Program Files\openclaw# 4. 添加到系统PATH[Environment]::SetEnvironmentVariable("PATH", "$env:PATH;C:\Program Files\openclaw\bin", "Machine")

问题 3：权限不足

解决方法：确保使用管理员PowerShell# 关闭所有PowerShell窗口→右键开始菜单→选择"Windows PowerShell (管理员)"

⚙️ 阶段 3：OpenClaw 完整初始化配置

步骤 3.1：启动初始化向导（首次运行必须）

在管理员 PowerShell 中执行：

openclaw init

按以下步骤完成每一项配置（共 8 个配置项）：

配置项	选项	推荐设置	详细说明
安装路径	默认 / 自定义	默认（`C:\Users\<用户名>\.openclaw`）	存储核心程序和配置
模型存储位置	系统盘 / 非系统盘	非系统盘（如`D:\openclaw-models`）	模型文件大，避免占用系统盘空间
网络加速	国内镜像 / 默认	国内镜像	加速模型和依赖下载
API 密钥	输入 / 跳过	跳过（后续可在配置文件添加）	可选，用于访问特定云服务
自动更新	开启 / 关闭	开启	自动获取安全更新和功能升级
日志级别	调试 / 信息 / 警告 / 错误	信息	平衡日志详细度和性能
端口配置	默认 (18789)/ 自定义	默认	避免端口冲突
启动方式	手动 / 开机自启	手动	按需启动，节省系统资源

步骤 3.2：手动配置核心参数（高级用户）

打开配置文件：

notepad $env:USERPROFILE\.openclaw\config.yaml

必须配置的 5 个关键参数：

模型配置（必选）model:  default: qwen-max  # 默认使用的AI模型  path: D:\openclaw-models  # 模型存储路径# 网络配置（必选）network:  proxy: false  # 是否使用代理  timeout: 30000  # 网络超时时间（毫秒）# 服务配置（必选）server:  port: 18789  # 服务端口  host: 0.0.0.0  # 允许所有IP访问# 日志配置（必选）logging:  level: info  # 日志级别  path: $env:USERPROFILE.openclaw\logs  # 日志存储路径# 安全配置（必选）security:  api_key: ""  # API密钥（留空禁用）  cors: true  # 允许跨域访问

保存文件并关闭记事本

🚀 阶段 5：启动 OpenClaw 服务并验证

步骤 5.1：启动 OpenClaw 服务（3 种方式）

方式 1：前台启动（调试用）

openclaw start

特点：实时显示日志，关闭窗口服务停止

方式 2：后台启动（推荐）

启动服务start-process powershell -argumentlist "openclaw start" -windowstyle hidden# 查看服务状态openclaw status

特点：后台运行，不占用终端窗口

方式 3：设置开机自启（高级）

openclaw service installopenclaw service start

🛡️ 阶段 6：安全配置与防火墙设置（必做）

步骤 6.1：配置 Windows 防火墙允许访问

打开防火墙设置：按 Win+R→输入wf.msc→确定

点击 "入站规则"→"新建规则"

规则类型：选择 "端口"→Next

协议和端口：选择 "TCP"→输入 "18789"→Next

操作：选择 "允许连接"→Next

配置文件：勾选 "域"、"专用"、"公用"→Next

名称：输入 "OpenClaw Service"→完成

步骤 6.2：设置 API 访问权限（可选）

编辑配置文件：

notepad $env:USERPROFILE\.openclaw\config.yaml

添加 API 密钥：

security:  api_key: "your_secure_api_key_here"  替换为自己的密钥

重启服务

openclaw restart

调用 API 时需添加密钥：

curl -H "Authorization: Bearer your_secure_api_key_here" http://localhost:18789/api/health

🎯 最终部署完成确认清单

当以下 5 个条件全部满足时，OpenClaw 部署成功：

✅openclaw --version显示正确版本

✅openclaw status显示服务运行中

✅ 浏览器访问返回 OK

✅ 模型下载完成并能正常使用

✅ 基本功能测试全部通过