Windows系统安装OpenClaw详细教程

前言

OpenClaw 是一个开源、自托管的 AI 助手平台，能够连接 WhatsApp、Telegram、Discord 等多种即时通讯渠道，并支持 Claude、OpenAI、Ollama 等主流大语言模型。本文将详细介绍如何在 Windows 系统上完成 OpenClaw 的安装和配置。

环境要求

在开始安装之前，请确认你的系统满足以下要求：

第一步：安装 Node.js

OpenClaw 需要 Node.js 22 或更高版本。推荐使用 nvm-windows 来管理 Node.js 版本，这样可以方便地在多个版本之间切换。

方式一：使用 nvm-windows（推荐）

1. 前往 nvm-windows 发布页面 下载最新的 nvm-setup.exe。

2. 运行安装程序，按提示完成安装。

3. 以管理员身份打开 PowerShell，执行以下命令：

# 查看可用的 Node.js 版本
nvm list available

# 安装 Node.js 22 LTS
nvm install 22

# 切换到 Node.js 22
nvm use 22

# 验证安装
node --version
npm --version

方式二：直接安装 Node.js

前往 Node.js 官网 下载 22 LTS 版本的 Windows 安装包，运行安装程序并勾选"自动安装必要工具"选项。

安装完成后打开新的 PowerShell 窗口验证：

node --version
# 输出应为 v22.x.x

npm --version
# 输出应为 10.x.x 或更高

第二步：安装 OpenClaw

打开 PowerShell，执行全局安装命令：

npm install -g openclaw@latest

安装完成后，验证是否成功：

openclaw --version

如果看到版本号输出，说明安装成功。

常见安装问题

如果遇到权限错误，可以尝试以下方法：

# 方法一：设置 npm 全局安装目录
npm config set prefix "$env:APPDATA\npm"

# 方法二：以管理员身份运行 PowerShell 后重新执行安装命令
npm install -g openclaw@latest

如果遇到网络问题，可以配置 npm 镜像：

# 使用淘宝镜像源
npm config set registry https://registry.npmmirror.com

# 安装完成后恢复官方源
npm config set registry https://registry.npmjs.org

第三步：初始化配置

首次运行 OpenClaw 需要完成初始配置向导：

openclaw onboard

向导会引导你完成以下设置：

1. 选择 AI 模型提供商 — 支持 Claude、OpenAI、Ollama、Gemini、OpenRouter 等
2. 输入 API 密钥 — 根据所选模型提供商填写相应的密钥
3. 选择通讯频道 — 选择要对接的即时通讯平台
4. 设置网关端口 — 默认为 18789

配置完成后，文件会保存在以下位置：

%USERPROFILE%\.config\openclaw\openclaw.json5

你可以用任何文本编辑器打开这个文件进行手动编辑。

第四步：启动 OpenClaw

openclaw up

启动后，你应该能看到类似以下的输出：

[OpenClaw] Gateway started on port 18789
[OpenClaw] Model provider: Claude (claude-sonnet-4-20250514)
[OpenClaw] Channels: ready
[OpenClaw] Dashboard: http://localhost:18789/dashboard

打开浏览器访问 http://localhost:18789/dashboard 可以进入管理面板。

检查运行状态

# 查看运行状态
openclaw doctor

# 查看运行日志
openclaw logs

# 重启服务
openclaw restart

第五步：配置 Windows 环境变量

为确保 OpenClaw 在任何终端窗口中都能正常使用，建议检查并配置系统环境变量。

# 查看当前 PATH 中是否包含 npm 全局目录
$env:PATH -split ';' | Where-Object { $_ -like '*npm*' }

# 如果没有，手动添加
[System.Environment]::SetEnvironmentVariable(
    'PATH',
    "$env:PATH;$env:APPDATA\npm",
    'User'
)

第六步：设置为 Windows 服务（可选）

如果你希望 OpenClaw 在系统启动时自动运行，可以使用 node-windows 将其注册为 Windows 服务。

安装 node-windows

npm install -g node-windows

创建服务安装脚本

在任意目录创建一个 install-service.js 文件：

const { Service } = require('node-windows');
const path = require('path');

// 找到 openclaw 的实际路径
const openclawPath = path.join(
  process.env.APPDATA, 'npm', 'node_modules', 'openclaw', 'bin', 'openclaw.js'
);

const svc = new Service({
  name: 'OpenClaw',
  description: 'OpenClaw AI Assistant Platform',
  script: openclawPath,
  scriptOptions: 'up',
  nodeOptions: [],
  workingDirectory: process.env.USERPROFILE,
});

svc.on('install', () => {
  console.log('OpenClaw 服务安装完成，正在启动...');
  svc.start();
});

svc.on('start', () => {
  console.log('OpenClaw 服务已启动');
});

svc.install();

以管理员身份运行：

node install-service.js

管理服务

安装完成后，可以在 Windows 服务管理器中找到 OpenClaw 服务，也可以用命令行管理：

# 查看服务状态
Get-Service -Name 'OpenClaw'

# 停止服务
Stop-Service -Name 'OpenClaw'

# 启动服务
Start-Service -Name 'OpenClaw'

# 重启服务
Restart-Service -Name 'OpenClaw'

第七步：配置 Windows 防火墙

如果你需要从局域网内其他设备访问 OpenClaw，需要开放防火墙端口：

# 以管理员身份运行
New-NetFirewallRule `
  -DisplayName "OpenClaw Gateway" `
  -Direction Inbound `
  -Protocol TCP `
  -LocalPort 18789 `
  -Action Allow

开放后，局域网内其他设备可以通过 http://你的IP:18789 访问 OpenClaw Dashboard。

PowerShell 执行策略说明

如果在运行 OpenClaw 时遇到"无法加载脚本"的错误，可能需要调整 PowerShell 执行策略：

# 查看当前策略
Get-ExecutionPolicy

# 设置为允许本地脚本
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

使用 Windows Terminal 的技巧

推荐在 Windows Terminal 中使用 OpenClaw，可以创建一个专用的配置文件：

1. 打开 Windows Terminal 设置
2. 点击"添加新配置文件"
3. 设置名称为 OpenClaw
4. 命令行填写：pwsh -NoExit -Command "openclaw up"
5. 起始目录设置为 %USERPROFILE%

这样每次打开该配置文件就会自动启动 OpenClaw。

验证安装

完成以上步骤后，运行诊断命令确认一切正常：

openclaw doctor

该命令会检查：

• Node.js 版本是否满足要求
• 配置文件是否有效
• 网络连接是否正常
• 已配置的模型提供商是否可用
• 已配置的通讯频道是否连通

总结

至此，你已经在 Windows 系统上完成了 OpenClaw 的安装和配置。接下来可以：

• 阅读配置文件指南，深入了解 openclaw.json5 的各项配置
• 对接你喜欢的即时通讯平台
• 创建自定义技能插件
• 部署多个 AI 模型并配置智能路由

如有问题，可以运行 openclaw doctor 进行自检，或查阅故障排查文档。