Windows 部署安装 OpenClaw 教程：从环境搭建到实战配置全流程

前言：为什么选择在 Windows 上跑 OpenClaw

OpenClaw 是一款开源的 AI Agent 框架，它不同于普通的聊天机器人——它能自主操控浏览器、编写代码、读取本地文件、执行终端命令，甚至可以在你离开电脑时继续完成预设任务。简单来说，它就是一个能帮你干活的"数字员工"。

虽然 OpenClaw 官方更推荐 macOS 和 Linux 环境，但国内大部分用户日常使用的依然是 Windows。好消息是，经过社区的不断优化，现在在 Windows 上部署 OpenClaw 已经比之前顺畅了不少。只要提前把几个环境坑填好，整个过程其实并不复杂。

这篇教程基于我自己在 Windows 10 和 Windows 11 上的实际部署经验，把踩过的坑都整理出来了，希望能帮你少走弯路。

两种安装方案怎么选

在 Windows 上安装 OpenClaw，有两条路可以走，建议先想清楚再动手：

我的建议：如果你电脑内存在 16 GB 以上、不需要 OpenClaw 直接操作 Windows 桌面应用，WSL2 是更省心的选择。如果内存比较紧张（8 GB 左右），或者需要 AI 控制本地软件，那就走原生安装。

方案一：PowerShell 原生安装（详细步骤）

第一步：安装 Node.js 22

OpenClaw 强制要求 Node.js 版本 >= 22，低版本会直接报错，这点很多人一上来就栽了。

打开 PowerShell，先检查一下：

node -v

如果显示 v22.x.x 就不用管了。没装或者版本不对的话，有两种方式安装：

方式一：用 winget 安装（推荐）

winget install OpenJS.NodeJS.LTS

方式二：官网下载安装包

前往 Node.js 官网 下载 Windows 版 .msi 安装包。安装过程中有一个选项叫 “Automatically install the necessary tools”，强烈建议勾上，它会帮你顺便装好 C++ 编译工具，省得后面再折腾。

注意：安装完成后，必须关掉 PowerShell 再重新打开！Windows 的终端不会自动刷新 PATH 环境变量，不重启就会一直提示"node 不是内部或外部命令"。

重新打开后验证：

node -v
npm -v

两个命令都有输出就没问题了。

第二步：安装 Git

OpenClaw 在安装过程中会调用 Git，缺少的话会报 spawn git ENOENT 错误。

git --version

如果没有安装，去 Git 官网 下载安装包，一路默认选项即可。装完同样需要重启 PowerShell。

第三步：修改 PowerShell 执行策略

Windows 默认禁止 PowerShell 运行外部脚本，不改这个设置的话，OpenClaw 的安装脚本会直接被系统拦截。

右键点击开始菜单，选择 “终端(管理员)” 或 “Windows PowerShell(管理员)”，执行：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

弹出确认时输入 Y 回车。这条命令的意思是"允许运行本地脚本和经过签名的远程脚本"，是一个比较安全的设置，不用担心有风险。

第四步：安装 C++ 编译工具（按需）

OpenClaw 依赖的部分 npm 包（比如 sharp 做图像处理、node-pty 做终端模拟）需要编译原生模块。如果你在安装 Node.js 时已经勾选了自动安装开发工具，可以跳过这一步。

没有装的话，需要安装 Visual Studio Build Tools，安装时勾选以下组件：

• “使用 C++ 的桌面开发"工作负载
• MSVC v143 编译器
• Windows 10/11 SDK

安装包大约 2-3 GB，需要耐心等待。

第五步：执行 OpenClaw 安装脚本

前面的环境都就绪后，打开一个新的 PowerShell 窗口（普通权限即可），执行：

iwr -useb https://openclaw.ai/install.ps1 | iex

如果遇到执行策略报错（常见于首次运行脚本），在 PowerShell 输入：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

这条命令会自动完成以下操作：

1. 检测 Node.js 版本
2. 通过 npm 全局安装 OpenClaw
3. 启动 Onboarding 配置向导

整个过程大约需要 2-5 分钟，取决于你的网络速度。

如果你之前已经配置过，想跳过向导直接安装：

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

安装完成后验证：

openclaw --version
openclaw status

如果提示"不是内部或外部命令”，基本上是 PATH 没有配置好。运行 npm config get prefix，把输出的路径添加到系统环境变量的 Path 中（设置 → 系统 → 关于 → 高级系统设置 → 环境变量 → 用户变量 Path → 新增），然后重新打开 PowerShell。

方案二：WSL2 安装（推荐新手）

如果你在原生安装过程中遇到太多麻烦，或者不想处理 Windows 特有的环境问题，WSL2 是一个非常好的替代方案。

开启 WSL2

以管理员身份打开 PowerShell，运行：

wsl --install

系统会自动下载并安装 WSL2 和 Ubuntu 子系统。安装完成后需要重启电脑。

重启之后会弹出 Ubuntu 窗口，让你设置用户名和密码（建议设置简单一些，后面会用到）。

提示：如果 wsl --install 报错，可能需要手动去 “启用或关闭 Windows 功能” 中勾选 “适用于 Linux 的 Windows 子系统” 和 “虚拟机平台” 这两项，然后再重启。

在 WSL2 中安装 OpenClaw

进入 Ubuntu 终端后，先确保 Node.js 环境：

# 安装 Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 验证版本
node -v
npm -v

然后一行命令搞定 OpenClaw：

curl -fsSL https://openclaw.ai/install.sh | bash

在 WSL2 下你不会碰到 PowerShell 权限、C++ 编译工具这些 Windows 独有的问题，整个过程和在 Linux 上装一模一样。

国内网络优化：换用 npm 镜像源

国内直接使用 npm 默认源，下载速度感人，经常会超时失败。在安装之前建议先切换到淘宝镜像：

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

安装完成后如果想切回来：

npm config set registry https://registry.npmjs.org

这一步虽然简单，但很多人因为忽略了它，在安装过程中反复遇到 ETIMEDOUT 错误浪费大量时间。

安装后的初始化配置

Onboarding 配置向导

安装脚本执行完毕后会自动进入配置向导，你也可以随时通过以下命令重新启动：

openclaw onboard --install-daemon

向导中的关键步骤：

1. 免责声明确认：选择 Yes
2. 安装模式：选择 Quickstart（快速开始）
3. 模型提供商配置：填入你的 API Key，也可以先选 Skip 跳过
4. 聊天渠道：根据需要选择飞书、Telegram 等，不确定可以先跳过
5. Skills 技能配置：初次安装建议先选 No，等熟悉后再按需添加

安装完成后通常会自动进入配置流程。
如果你不小心关闭了 PowerShell，重新打开后执行：

openclaw onboard --flow quickstart

风险提示：

I understand this is powerful and inherently risky. Continue?

选择 Yes。

如果遇到问题：系统找不到它的安装位置。处理：

• 关闭当前 PowerShell
• 重新用管理员方式打开 PowerShell
• 一般 nvm/环境变量会自动刷新路径，问题即可消失

配置大模型 API Key

OpenClaw 需要对接大模型才能正常工作。

目前支持的模型包括 Claude、GPT、Gemini、Kimi、通义千问等。

按提示选择模型。这里示例是 Kimi，自行选择。

可以看下配置，主要输入API key，其他都可以默认。

接着配置通讯工具，虽然官方这里直接可以选飞书，但官方文档明确建议 Windows 通过 WSL2 运行，并且提到原生 Windows 未测试、更容易出问题。并且我这里下载插件会报错，所以我们这里先跳过，后续再安装。

skill也先跳过，后续咱们在使用过程中根据自己的工作流慢慢迭代自己的skill。

安装启动网关后，它会自动新开一个 PowerShell 窗口，都不要关闭。

如果在向导中跳过了 API Key 配置，后续可以通过以下方式手动设置：

openclaw config

或者直接编辑配置文件。配置文件路径：

• Windows 原生：C:\Users\你的用户名\.openclaw\clawdbot.json
• WSL2：~/.openclaw/clawdbot.json

在配置文件的 models.providers 部分，填入你的模型提供商信息和 API Key 即可。

安全提示：API Key 是敏感信息，不要分享给他人或上传到公开仓库。

启动 Gateway 并验证

配置完成后，启动 Gateway 网关服务：

openclaw gateway start

然后在浏览器中访问 http://localhost:18789，看到 Dashboard 控制面板就说明一切正常。

你也可以用命令行快速验证：

# 健康检查
openclaw doctor

# 查看运行状态
openclaw status

# 查看已配置的模型
openclaw models list

接入飞书机器人（可选）

如果你希望通过飞书和 OpenClaw 对话，可以按以下步骤接入飞书机器人。

1. 安装飞书插件

openclaw channels add

在弹出的选项中选择飞书渠道并确认安装。

2. 创建飞书企业自建应用

登录 飞书开放平台，进入开发者后台：

• 点击 “创建企业自建应用”，填写应用名称并创建
• 添加 “机器人” 应用能力
• 在 “权限管理” 中点击 “批量导入权限”，粘贴以下 JSON：

{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": [
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

3. 配置事件订阅

• 在应用后台找到 “事件与回调”，选择 “使用长连接接收事件”
• 点击 “添加事件”，搜索并添加 im.message.receive_v1
• 保存后创建新版本并发布上线

4. 获取凭证并绑定

• 在 “凭证与基础信息” 页面获取 App ID 和 App Secret
• 回到终端，按提示依次输入这两个值完成绑定
• 打开飞书，给机器人发一条消息测试，收到回复就说明接入成功了

Windows 常见报错与解决方案

在 Windows 上部署 OpenClaw，环境相关的问题确实比 macOS 和 Linux 多一些。下面整理了实际操作中最常遇到的错误及其解决办法：

关于 Windows Defender：有些教程会建议你直接关闭 Defender，这是没必要的。只需要把上面几个目录添加到排除项就够了，安装完成后也可以把排除项删掉。路径：设置 → Windows 安全 → 病毒和威胁防护 → 管理设置 → 排除项 → 添加文件夹。

日常运维命令速查

安装配置完成后，日常使用中常用的命令整理在这里方便查阅：

# 启动 / 重启 / 停止网关
openclaw gateway start
openclaw gateway restart
openclaw gateway stop

# 打开 Web 控制面板
openclaw dashboard

# 诊断检查
openclaw doctor

# 查看运行状态
openclaw status
openclaw health

# 查看实时日志（排查问题必备）
openclaw logs follow

# 重新进入配置向导
openclaw onboard

# 修改模型配置
openclaw config

# 查看已安装模型
openclaw models list

# 添加聊天渠道
openclaw channels add

# 更新到最新版
npm install -g openclaw@latest

常见问题

Q1：OpenClaw 对电脑配置有什么要求？

最低要求是 Windows 10（1903 及以上版本）或 Windows 11，64 位系统，至少 2 GB 可用磁盘空间。内存方面，如果用原生安装 4 GB 就够了，用 WSL2 建议 8 GB 以上。

Q2：Node.js 版本低于 22 能装吗？

不能。OpenClaw 从底层就依赖 Node.js 22 引入的新特性，18 和 20 都不行。如果你电脑上已经有其他版本，推荐用 nvm-windows 来管理多版本切换。

Q3：原生安装和 WSL2 安装能共存吗？

可以同时存在，但不建议。两套环境的配置文件路径不同，容易搞混。建议选定一种方式后就一直用它。

Q4：安装中途失败了怎么办？

先运行 openclaw doctor 看诊断报告，大部分问题都会给出提示。如果想彻底重来，可以先删除配置目录（原生是 %USERPROFILE%\.openclaw，WSL2 是 ~/.openclaw），再重新执行安装脚本。

Q5：API Key 有免费的吗？

有的。Gemini 提供免费额度可以用来测试，部分国内中转平台也有注册赠送额度。Claude 效果最好但需要付费，可以根据自己的需求和预算来选择。

Q6：装好之后要不要装 security-audit 技能？

强烈建议安装。每次给 OpenClaw 添加新的 Skill 技能后，用 security-audit 做一次安全检查是很好的习惯，能有效防止恶意或有问题的技能对你的系统造成影响。

Q7：能用 CMD 代替 PowerShell 吗？

不推荐。OpenClaw 的安装脚本是为 PowerShell 设计的，CMD 下可能会出现各种兼容性问题。尤其是修改执行策略这一步，CMD 里根本没有对应的命令。

总结

回顾一下在 Windows 上部署 OpenClaw 的完整流程：

1. 选择安装方案：内存充裕选 WSL2 更省心，需要操作 Windows 桌面就走原生安装
2. 搞定环境依赖：Node.js 22 + Git + 修改 PowerShell 执行策略 + C++ 编译工具（按需）
3. 执行安装脚本：原生用 iwr -useb https://openclaw.ai/install.ps1 | iex，WSL2 用 curl -fsSL https://openclaw.ai/install.sh | bash
4. 完成初始化：配置 API Key、启动 Gateway、打开 Dashboard 验证
5. 可选扩展：接入飞书等聊天渠道，安装 Skills 技能

整体来说，Windows 部署 OpenClaw 的核心难点不在于 OpenClaw 本身，而在于 Windows 的开发环境配置。只要把 Node.js 版本、PowerShell 权限、C++ 编译工具这几个前置条件处理好，后面的安装过程其实非常丝滑。

如果大家在部署安装 OpenClaw 的过程中还有哪些问题没解决，或者遇到了文章中没提到的报错，欢迎在评论区交流讨论～～～