OpenClaw Windows 本地部署教程

国内大部分用户使用的是Windows系统，所以我演示的是Windows 10系统，其他版本的Windows系统安装方法一样。直接在Windows上安装的，方便更多人能使用。

适用于，以下系统，预计安装时间：10分钟

Windows 10（亲测）
Windows 11（亲测）
win8.1以下是不行的（因为装不了node）

一、安装Node.js

Node.js® 是一个免费、开源、跨平台的 JavaScript 运行时环境，它让开发人员能够创建服务器、 Web 应用、命令行工具和脚本，Node.js下载和安装教程。

安装结束之后，打开Windows PowerShell(管理员)窗口，输入：node -v 验证一下,安装成功应该显示：v22.xx.x。

二、安装Git

Git 是一个开源的分布式版本控制系统，用于高效管理代码的版本和协作开发，但是现在随着各种AI工具的爆火，越来越多普通用户也要配置好Git环境，不需要提交代码，仅用于拉取项目。 Git下载和安装教程。

安装完成后，重新打开Windows PowerShell(管理员)窗口，输入：git -v，如果显示了版本号（例如git version 2.xx.x），说明配置成功。

三、安装OpenClaw

1、转换国内镜像

先把npm的默认下载换成国内镜像，在Windows PowerShell(管理员)窗口中输入：

npm config set registry https://registry.npmmirror.com

验证是否成功，输入：

npm config get registry
# 应该显示：https://registry.npmmirror.com

2、安装OpenClaw

在Windows PowerShell(管理员)窗口中输入：

npm install -g openclaw@latest

安装验证，输入：

openclaw --version

【注意】

1）在这个过程中，不同的电脑配置可能会有错误，例如，提示系统缺少编译它所需的C++运行库或构建工具，出现该错误，请安装：

Visual Studio Build Tools；
安装时，务必勾选 workload: “Desktop development with C++”(使用 C++ 的桌面开发)；
重启后继续配置。

2）若出现其他警告或报错信息，可将提示内容复制到 DeepSeek、千问、豆包、元宝等工具中，它们能帮你分析报错原因，并给出详细修复步骤。

四、初始化 OpenClaw

在powershell里面执行：

openclaw onboard --install-daemon

进入初始化向导，如下图所示选择Yes，然后回车。

如下图所示选择并回车。

五、配置国产大模型

推荐使用国产大模型；OpenAI API Key 费用高、配置麻烦，还容易被封号；国产大模型性价比高、使用简单，更稳定可靠。几个大模型介绍如下：

模型	厂商	免费额度	点评
Qwen	阿里	100万 tokens/月	⭐首选！额度大方
DeepSeek	深度求索	1000万tokens	推理一把好手，性价比之王
GLM-4	智谱	有免费额度	写代码可以信赖
Kimi	月之暗面	有免费额度	长文本处理的王者

配置方法：以Qwen（通义千问）为例

1、获得API Key

用支付宝扫码登录阿里云百炼，进入「API Key管理」，「创建 API Key」，如下图所示：

2.运行向导配置

打开Windows PowerShell(管理员)窗口，输入：

openclaw onboard --install-daemon

1）我了解此功能默认为个人使用模式，如需用于共享/ 多用户场景，必须进行安全加固（锁定）。是否继续？

→ 选 Yes

2）引导配置模式/初始化引导模式→ 选 QuickStart3

）模型/服务商 → 选 Qwen

4）弹出浏览器窗口，完成浏览器授权

最后：你已经安装好OpenClaw、并配置好大模型。

六、常见问题

1、常见问题之一

如果安装过程中有如下图所示含有[ssh://XXXXX]的关键词的报错的话。

在powershell里面执行：

git config --global --unset-all url."https://github.com/".insteadOf

git config --global --add url."https://github.com/".insteadOf "ssh://git@github.com/"

git config --global --add url."https://github.com/".insteadOf "git@github.com:"

git config --global --add url."https://github.com/".insteadOf "ssh://git@github.com:"

npm cache verify

git config --global --get-regexp "url\..*\.insteadOf"

然后再重新安装即可：