OpenClaw（windows版）部署指南

OpenClaw 安装与配置详细教程 - 从零开始搭建 AI 助手环境

核心文档信息

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

• 适用操作系统: Windows 10/11 64位系统
• 目标软件版本: OpenClaw v2026.1.30 最新稳定版
• Node.js 版本要求: v22.13.1 (长期支持版)
• 包管理器版本: npm v10.9.4
• 文档最后更新时间: 2026年2月2日

1. 环境准备与前置条件

1.1 安装 Node Version Manager (nvm-windows)

OpenClaw 对 Node.js 运行环境有严格的版本兼容性要求。使用 nvm-windows 进行多版本管理能够彻底解决环境冲突问题，确保安装过程顺利无阻。

详细安装流程:

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 安装结果

   nvm version
   # 成功安装后，终端将显示当前版本号，例如： 1.1.12

2. Node.js 安装与运行环境配置

2.1 安装指定版本的 Node.js

遵循 OpenClaw 官方技术文档的明确要求，需要安装 Node.js v22.13.1 及以上版本。我们推荐直接安装最新的长期支持（LTS）版本，以获得最佳的系统稳定性和功能兼容性。

# 使用管理员权限启动 PowerShell 终端
# 步骤一：安装指定版本的 Node.js
nvm install 22.13.1

# 步骤二：激活已安装的版本
nvm use 22.13.1

# 步骤三：验证安装版本是否正确
node -v
# 预期正确输出显示: v22.13.1

npm -v
# 预期版本显示: 10.9.x 系列

重要兼容性提示：有时在安装 Node.js 22.13.1 后，系统自带的 npm 版本可能为 11.x 系列。如果遇到这种情况，建议手动调整 npm 版本至 10.x，以避免可能出现的依赖包兼容性警告。

npm install -g npm@10

3. OpenClaw 核心安装步骤

3.1 清理旧版本残留文件（如适用）

如果您之前尝试过安装 OpenClaw 或者正在进行重新安装，强烈建议先清理可能存在的旧版本残留文件。这一步骤可以有效避免因文件冲突导致的各种不可预见的安装问题。

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 或相应的 C++ 编译环境，之后在不使用该参数的情况下重新执行安装命令。

3.3 验证 OpenClaw 安装成功

# 使用管理员权限打开 PowerShell
openclaw --version
# 安装成功后，命令行将准确显示当前版本号： 2026.1.30

安装后可能遇到的常见问题及解决方案：

• 如果终端显示关于 `punycode` 模块的弃用（Deprecation）警告，通常可以暂时忽略，该警告不会影响 OpenClaw 主要功能的正常运行。
• 如果系统提示“无法识别 'openclaw' 命令”，可以尝试使用 `npx openclaw` 命令作为替代方案来启动程序。

4. 功能特性与运行模式说明

4.1 当前安装所支持的功能模式

根据上述安装流程，您当前部署的 OpenClaw 将具备以下功能状态：

• 云端 API 模式: ✅ 已完全启用。您可以立即配置并连接使用 OpenAI GPT系列、Anthropic Claude、远程部署的Ollama服务等多种云端大型语言模型。
• 本地 LLM 运行模式: ❌ 暂未启用。由于在安装时跳过了 `node-llama-cpp` 模块的编译，因此暂时无法在本地计算机上直接运行 Llama、Qwen 等依赖该模块的离线模型。如有需要，可按照前文指引配置编译环境后重新安装以启用此功能。

4.2 基础操作与常用命令

# 使用管理员权限启动 PowerShell
# 查看 OpenClaw 提供的所有命令列表及详细帮助信息
openclaw --help

# 强烈推荐新用户执行！启动交互式初始化向导，它将引导您完成基础参数配置，并可选择安装系统后台守护进程
openclaw onboard --install-daemon

# 启动 OpenClaw 网关（Gateway）核心服务，这是接收和处理请求的关键进程
openclaw gateway --port 18789 --verbose

# 再次确认已安装的软件版本
openclaw --version

6. 配置文件存储路径

OpenClaw 的主要系统配置文件默认存储于以下用户目录中，您可以使用记事本、VS Code 等任意文本编辑器打开并修改其中的高级配置选项：

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

7. 附录：完整的顺序执行安装日志（供参考对照）

为了让您对整个安装和配置流程有更全局、清晰的把握，以下提供一份完整的、按顺序执行的命令日志，供您在操作过程中逐条对照参考：

# 阶段一：安装 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 窗口。

# 阶段二：安装指定版本的 Node.js 环境
PS> nvm install 22.13.1
PS> nvm use 22.13.1
# 预期成功输出显示: Now using node v22.13.1 (64-bit)

# 阶段三：调整 npm 包管理器版本（如遇高版本兼容性问题）
PS> npm install -g npm@10
PS> npm -v
# 预期版本显示: 10.9.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

# 阶段五：验证主要程序的安装结果
PS> openclaw --version
# 成功输出将显示具体的安装版本号

# 阶段六：执行初次启动与初始化配置
PS> openclaw onboard --install-daemon

通义千问（Qwen）API 接入与配置专项指南

需要特别关注的是，在 OpenClaw 框架中集成通义千问（Qwen）模型采用的是 OAuth 设备码（Device Code）认证流程，而非传统的静态 API 密钥模式。这种认证方式安全性更高，但在配置步骤上与传统 API 有所不同。

详细的 Qwen 模型接入步骤

1. 启用 Qwen 专属认证插件：

   openclaw plugins enable qwen-portal-auth

   成功启用插件后，必须重新启动 Gateway 核心服务才能使插件生效（即需要再次运行 openclaw gateway --port 18789 --verbose 命令）。

2. 登录并完成 OAuth 设备认证：

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

   执行此命令将启动 Qwen 的 OAuth 设备码认证流程。命令行界面会显示一个验证页面链接和一组唯一的设备码。您需要使用浏览器访问该链接，并在页面中输入命令行显示的设备码以完成授权操作。授权成功后，相关的访问令牌和配置信息会自动保存并更新到您的 settings.yml 配置文件中。

3. 切换默认模型至 Qwen：

   openclaw models set qwen-portal/coder-model

   在成功完成 OAuth 授权后，即可将 OpenClaw 当前使用的默认模型设置为通义千问系列模型。

当前可用的 Qwen 模型列表

目前通过此 OAuth 认证方式可在 OpenClaw 中接入并使用的通义千问模型主要包括：

• qwen-portal/coder-model (专为代码生成与优化任务设计)
• qwen-portal/vision-model (支持图像识别与理解的多模态模型)