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.1 安装 Node Version Manager (nvm-windows)

OpenClaw 对 Node.js 版本有明确且严格的要求，为了避免版本冲突，使用 nvm 来管理 Node 版本是一个稳妥且高效的选择。

安装步骤:

1. 下载 nvm-windows 安装程序

   # 以管理员身份打开 PowerShell，执行以下命令
   curl -o nvm-setup.exe https://github.com/coreybutler/nvm-windows/releases/download/1.1.12/nvm-setup.exe

2. 运行安装程序

   Start-Process .\nvm-setup.exe

   按照安装向导的提示进行操作即可，建议保持默认安装路径。这里有一个关键步骤：安装完成后，务必重启 PowerShell 终端，这样才能让 nvm 命令生效。

3. 验证安装

   nvm version
   # 如果安装成功，你会看到类似下面的输出： 1.1.12

2. Node.js 安装与配置

2.1 安装 Node.js v22.13.1

根据 OpenClaw 的官方要求，需要 Node.js 版本不低于 22.12.0。这里我们直接安装最新的长期支持（LTS）版本 v22.13.1，以保证最佳的兼容性。

# 以管理员身份打开 PowerShell
# 1. 安装指定版本
nvm install 22.13.1

# 2. 激活该版本
nvm use 22.13.1

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

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

注意一个常见问题：有时安装 Node.js 后，自带的 npm 版本可能是 11.x。如果遇到这种情况，需要手动降级到 10.x 版本来避免潜在的兼容性警告。

npm install -g npm@10

3. OpenClaw 安装

3.1 清理旧版本（如有）

如果是重新安装，或者之前的安装过程失败了，建议先清理一下残留文件，这能避免很多说不清道不明的奇怪问题。

Remove-Item -Recurse -Force “C:\Users\Administrator\AppData\Roaming\npm\node_modules\openclaw” -ErrorAction SilentlyContinue
Remove-Item -Force “C:\Users\Administrator\AppData\Roaming\npm\openclaw*” -ErrorAction SilentlyContinue
npm cache clean --force

3.2 安装 OpenClaw

在 Windows 环境下安装 OpenClaw 有个小“坑”：它依赖的 `node-llama-cpp` 模块可能需要本地编译，而编译过程常常会因缺少C++构建工具而失败。因此，对于大多数初次使用的用户，建议先跳过本地LLM的编译，专注于核心功能。

npm install -g openclaw@latest --ignore-scripts

这个 `--ignore-scripts` 参数的作用就是跳过对 `node-llama-cpp` 的编译。如果你想启用本地LLM功能，则需要先安装 Visual Studio Build Tools 等编译环境，然后重新安装而不使用该参数。

3.3 验证安装

# 以管理员身份打开 PowerShell
openclaw --version
# 如果一切顺利，你将看到： 2026.1.30

可能出现的警告及处理：

• 如果看到关于 `punycode` 模块的弃用警告，可以暂时忽略，这不会影响 OpenClaw 的主要功能。
• 如果系统提示“找不到 openclaw 命令”，可以尝试使用 `npx openclaw` 来运行。

4. 功能说明

4.1 当前安装模式

根据上述安装步骤，你当前的 OpenClaw 状态如下：

• API 模式: ✅ 已启用。这意味着你可以立即连接并使用 OpenAI、Anthropic、远程 Ollama 等云端大模型服务。
• 本地 LLM 模式: ❌ 未启用。因为安装时跳过了 `node-llama-cpp` 的编译，所以暂时无法在本地运行 Llama、Qwen 等需要该模块支持的模型。需要时可按前文说明重新安装以启用。

4.2 基本使用命令

# 以管理员身份打开 PowerShell
# 查看所有命令和帮助
openclaw --help

# 强烈推荐！启动初始化向导，它会引导你完成基本配置，并可选安装后台守护进程
openclaw onboard --install-daemon

# 启动网关服务，这是 OpenClaw 的核心服务进程
openclaw gateway --port 18789 --verbose

# 再次检查版本
openclaw --version

6. 配置路径

OpenClaw 的主要配置文件通常存放在以下位置，你可以用任何文本编辑器打开它进行高级配置：

C:\Users\Administrator\AppData\Roaming\openclaw\settings.yml

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

为了让你对整个流程有更清晰的把握，这里是一份完整的、顺序执行的命令日志，你可以对照参考：

# 步骤 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 .\nvm-setup.exe
# [安装完成后务必重启 PowerShell]

# 步骤 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:\Users\Administrator\AppData\Roaming\npm\node_modules\openclaw” -ErrorAction SilentlyContinue
PS> npm cache clean --force
PS> npm install -g openclaw@latest --ignore-scripts

# 步骤 5: 验证
PS> openclaw --version
# 输出安装版本号

# 步骤 6: 初次启动
PS> openclaw onboard --install-daemon

Qwen API 配置指南

需要特别注意的是，OpenClaw 中集成 Qwen 模型采用的是 OAuth 设备码认证流程，而不是传统的静态 API 密钥。这种方式更安全，但步骤上略有不同。

配置步骤

1. 启用Qwen插件：

   openclaw plugins enable qwen-portal-auth

   启用插件后，必须重启 Gateway 服务才能生效（即再次运行 openclaw gateway --port 18789 --verbose）。

2. 登录并配置认证：

   openclaw models auth login --provider qwen-portal --set-default

   执行这个命令会启动 Qwen 的 OAuth 设备码流程。命令行会显示一个验证链接和一组设备码，你需要用浏览器打开链接并输入设备码完成授权。成功后，相关配置会自动写入你的 settings.yml 文件。

3. 切换到Qwen模型：

   openclaw models set qwen-portal/coder-model

   授权完成后，就可以将当前使用的模型切换为 Qwen 了。

可用模型

目前通过此方式可用的 Qwen 模型主要包括：

• qwen-portal/coder-model (专为代码优化)
• qwen-portal/vision-model (支持多模态识别)

来源：互联网