OpenClaw（windows版）部署指南

# OpenClaw 安装配置指南

文档信息
– 适用系统: Windows 10/11 (x64)
– 目标软件: OpenClaw v2026.1.30
– Node.js 版本: v22.13.1 (LTS)
– 包管理器: npm v10.9.4
– 最后更新: 2026-02-02

—

1. 环境准备

安装步骤:
1. 下载 nvm-windows 安装程序
   “`powershell（管理员打开）
   curl -o nvm-setup.exe https://github.com/coreybutler/nvm-windows/releases/download/1.1.12/nvm-setup.exe
   “`

2. 运行安装程序
   “`powershell
   Start-Process . vm-setup.exe
   “`
   – 按提示完成安装（保持默认路径）
   – 安装完成后必须重启 PowerShell

3. 验证安装
   “`powershell
   nvm version
   # 预期输出: 1.1.12
   “`
—

2. Node.js 安装与配置

“`powershell（管理员打开）
# 安装指定版本
nvm install 22.13.1

# 验证版本
node -v
# 预期输出: v22.13.1

npm -v
# 预期输出: 10.9.x
“`

注意: 如果 npm 版本为 11.x，需要降级到 10.x：
“`powershell
npm install -g npm@10
“`
—
3. OpenClaw 安装

3.1 清理旧版本（如有）
如果之前安装失败，先清理残留文件：
“`powershell
Remove-Item -Recurse -Force “C:UsersAdministratorAppDataRoaming pm ode_modulesopenclaw” -ErrorAction SilentlyContinue
Remove-Item -Force “C:UsersAdministratorAppDataRoaming pmopenclaw*” -ErrorAction SilentlyContinue
npm cache clean –force
“`

“`powershell
npm install -g openclaw@latest –ignore-scripts
“`

3.3 验证安装
“`powershell（管理员打开）
openclaw –version
# 预期输出: 2026.1.30
“`

可能出现的警告:
– `punycode` 模块弃用警告：可忽略，不影响功能
– 如果提示命令未找到，使用 `npx openclaw` 运行
—

4. 功能说明

4.1 当前安装模式
– API 模式: ✅ 可用（OpenAI、Anthropic、Ollama 远程等）
– 本地 LLM 模式: ❌ 未启用（需重新安装以启用 `node-llama-cpp`）

4.2 基本使用命令
“`powershell（管理员打开）
# 查看帮助
openclaw –help

# 检查版本
openclaw –version
“`

—

6. 配置路径

配置文件通常位于：
“`
C:UsersAdministratorAppDataRoamingopenclawsettings.yml
“`

—

7. 附录：完整安装日志（参考）

“`powershell
# 步骤 1: 安装 nvm-windows
PS> curl -o nvm-setup.exe https://github.com/coreybutler/nvm-windows/releases/download/1.1.12/nvm-setup.exe
PS> Start-Process . vm-setup.exe
# [安装完成后重启 PowerShell]

# openclaw 部署 步骤 2: 安装 Node.js 22
PS> nvm install 22.13.1
PS> nvm use 22.13.1
Now using node v22.13.1 (64-bit)

# 步骤 3: 降级 npm（如需要）
PS> npm install -g npm@10
PS> npm -v
10.9.4

# 步骤 4: 清理并安装 OpenClaw
PS> Remove-Item -Recurse -Force “C:UsersAdministratorAppDataRoaming pm ode_modulesopenclaw” -ErrorAction SilentlyContinue
PS> npm cache clean –force
PS> npm install -g openclaw@latest –ignore-scripts

# Qwen API 配置指南

Qwen在OpenClaw中采用OAuth认证方式，而不是传统的API密钥。以下是配置步骤：

配置步骤

1. 启用Qwen插件：
   “`bash
   openclaw plugins enable qwen-portal-auth
   “`
   启用后需要重启Gateway服务 （openclaw gateway –port 18789 –verbose）。

2. 登录并配置认证：
   “`bash
   openclaw models auth login –provider qwen-portal –set-default
   “`
   此命令会启动Qwen设备码OAuth流程，并将提供程序条目写入配置文件中。

3. 切换到Qwen模型：
   “`bash
   openclaw models set qwen-portal/coder-model
   “`

可用模型
– `qwen-portal/coder-model`
– `qwen-portal/vision-model`