Windows 本地部署 OpenClaw

本教程将指导您在 Windows 10/11 上完成 OpenClaw 的本地安装和配置。适合开发者和隐私敏感用户。

系统要求

• 操作系统: Windows 10（64位）或 Windows 11
• 处理器: Intel Core i5 或同等性能的 AMD 处理器
• 内存: 8 GB RAM（推荐 16 GB）
• 磁盘空间: 至少 2 GB 可用空间
• 网络: 稳定的互联网连接
• 软件依赖: Node.js ≥ 22.0.0、Git（可选）

安装步骤

步骤 1: 安装 Node.js 环境

OpenClaw 2026 版要求 Node.js ≥ 22.0.0。请安装 LTS 版本：

1. 访问 Node.js 官方网站 下载 22.x LTS 版本安装包
2. 运行下载的 .msi 安装程序，保持默认选项
3. 安装完成后，打开 PowerShell，验证安装：

node --version
npm --version

确保 Node.js 版本显示 v22.x.x 或更高。

步骤 2: 安装 Git（可选）

如果您选择从 GitHub 克隆源码安装，需要 Git：

1. 访问 Git 官方网站 下载 Windows 版本
2. 运行安装程序，保持默认配置
3. 验证：git --version

步骤 3: 安装 OpenClaw

有两种安装方式，推荐使用 npm 全局安装：

方式 A：npm 全局安装（推荐）

npm install -g openclaw

安装完成后验证：

openclaw --version

方式 B：从 GitHub Release 下载

1. 访问 OpenClaw Releases
2. 下载最新版本的 openclaw-win-x64.zip
3. 解压到您喜欢的目录（如 C:\openclaw）
4. 将解压目录添加到系统 PATH 环境变量

步骤 4: 初始化配置

运行初始化命令，生成配置文件：

openclaw init

这会在 ~/.openclaw/ 目录下生成 config.yaml 配置文件。

步骤 5: 配置百炼 API Key

OpenClaw 需要接入大模型 API 才能提供 AI 对话能力：

1. 访问 阿里云百炼平台，注册并创建 API Key（查看详细申请购买教程）
2. 配置 API Key：

openclaw config set model.provider "bailian"
openclaw config set model.apiKey "your-api-key-here"

也可以直接编辑配置文件 ~/.openclaw/config.yaml：

model:
  provider: bailian
  apiKey: your-api-key-here
  # 也支持其他模型提供商：
  # provider: openai
  # provider: anthropic

步骤 6: 启动 OpenClaw

openclaw start

启动成功后，您会看到：

OpenClaw server is running at http://localhost:18789
WebUI: http://localhost:18789

安装验证

1. 打开浏览器，访问 http://localhost:18789
2. 您应该能看到 OpenClaw 的管理后台仪表盘
3. 在聊天窗口输入 /ping 测试
4. 在命令行中运行：

# 检查服务状态
openclaw status

# 发送测试消息
openclaw test "你好"

# 查看日志
openclaw logs

设置开机自启（可选）

使用 PM2 实现进程守护和开机自启：

# 安装 PM2
npm install -g pm2

# 使用 PM2 启动 OpenClaw
pm2 start openclaw

# 设置开机自启
pm2 startup
pm2 save

常见问题

npm config set prefix %USERPROFILE%\.npm-global

# 查找占用端口的进程
netstat -ano | findstr :18789

# 终止进程
taskkill /PID <PID> /F

# 或修改端口
openclaw config set port 18790

nvm install 22
nvm use 22
node --version