Windows 部署安装 OpenClaw 教程：零基础小白也能搞定的完整指南

前言：OpenClaw 是什么，能帮你做什么

如果你还不了解 OpenClaw，简单说它就是一个运行在你电脑上的 AI 智能助手。

跟 ChatGPT 那种只能聊天的工具不同，OpenClaw 能实实在在地"动手干活"——它可以帮你操作浏览器、读取和整理本地文件、自动执行电脑上的命令，甚至你去吃饭、睡觉的时候，它也能继续帮你完成预设好的任务。

你可以把它理解成一个"数字员工"，只要配置好了，就能 7×24 小时帮你工作。

目前 OpenClaw 在程序员群体中非常火爆，但其实普通人也能用它来完成很多事情，比如批量整理文件、自动化处理表格、辅助写作等等。

这篇教程就是专门写给没有技术背景的普通用户的，每一步都会讲清楚是什么、为什么要做、具体怎么操作。

跟着做就行，不需要你懂任何编程知识。

开始之前：你需要准备什么

在正式安装之前，有几件事情需要提前搞定。

很多人安装失败不是因为操作有误，而是前期准备没做好。

电脑基本要求

• 操作系统：Windows 10（版本号 1903 以上）或 Windows 11，必须是 64 位系统
• 磁盘空间：至少留出 2 GB 的可用空间
• 内存：4 GB 以上可以用原生安装，如果选 WSL2 方案建议 8 GB 以上

怎么查看你的系统版本：按键盘上的 Win + I 打开设置，点击 “系统” → “关于”，就能看到你的 Windows 版本和系统类型（64 位还是 32 位）。

网络环境准备（重要）

这一步很多人都会忽略，但它直接决定了你后面能不能顺利安装。

OpenClaw 的安装过程需要从 GitHub 和 npm（一个开发工具的下载平台）上下载文件，而这两个网站的服务器都在海外。

在国内直接访问的话，经常会遇到下载特别慢、甚至完全连不上的情况。

你有两种方式来解决这个问题：

方式一：确保你能正常访问外网

如果你已经有科学上网的工具（比如某些代理软件），确保在安装过程中保持开启状态就行。

这是最简单直接的方式，后面的步骤基本不会遇到网络问题。

方式二：使用国内镜像源（不需要外网）

如果你没有访问外网的条件，也不用担心。

后面的教程中我会专门教你怎么把下载源切换到国内的镜像服务器（淘宝镜像），速度很快，效果和直接访问一样。

小提示：如果你两种方式都没有，安装过程中可能会反复出现 ETIMEDOUT（连接超时）之类的错误。

遇到这种情况先别急着怀疑自己操作有误，大概率就是网络问题，换个镜像源或者换个网络环境再试一次就好。

准备一个大模型的 API Key

OpenClaw 本身只是一个框架，它需要对接一个 AI 大模型才能"思考"和"干活"。

就好比你买了一辆汽车，还需要加油才能跑起来。

这里说的 API Key 是一串密钥，相当于你使用 AI 大模型服务的"钥匙"

注意：使用过程是要收 token 的费用的，也就是每次调用大模型都要花钱，也就是每次使用 openclaw 要调用大模型要花钱。

目前支持的模型包括：

• Claude（效果最好，需要付费）
• Gemini（Google 的模型，有免费额度，适合体验）
• GPT（OpenAI 的模型）
• Kimi（国产模型，注册就能用，免费额度）
• 通义千问（阿里的模型）

如果你只是想先体验一下，推荐去 Gemini 或者 Kimi 注册一个账号，它们都有免费额度可以试用。

API Key 在安装过程中会用到，但也可以先跳过后面再配。

两种安装方案怎么选

在 Windows 上安装 OpenClaw，有两条路可以走。

建议先花一分钟了解一下区别，选好了再动手，免得做到一半又想换：

我的建议：

• 如果你的电脑内存 16 GB 以上，选 WSL2 更省心
• 如果你的电脑内存只有 8 GB 左右，选原生安装，省下来的内存给 OpenClaw 用
• 如果你希望 AI 能帮你操作 Windows 上的软件（比如打开浏览器搜东西），只能选原生安装

方案一：PowerShell 原生安装（保姆级步骤）

第一步：打开 PowerShell

很多朋友可能连 PowerShell 是什么都不清楚，这里解释一下：PowerShell 就是 Windows 系统自带的一个命令行工具，长得像一个蓝色或黑色的文字窗口，你在里面输入命令，电脑就会执行对应的操作。

怎么打开 PowerShell：

1. 在键盘上按 Win + S（或者直接点击任务栏上的搜索图标）
2. 输入 PowerShell
3. 在搜索结果中找到 “Windows PowerShell”，点击打开

关于管理员模式：后面有些步骤需要用"管理员身份"打开 PowerShell。方法是在搜索到 PowerShell 后，右键点击它，选择 “以管理员身份运行”，弹出提示时点"是"就行。

第二步：安装 Node.js 22

Node.js 是什么？ 你可以把它理解成 OpenClaw 运行所需要的一个"引擎"。OpenClaw 是用 JavaScript 语言写的，而 Node.js 就是让 JavaScript 能在你电脑上跑起来的工具。你不需要了解它的技术细节，只需要把它装好就行。

重要：版本必须是 22 或更高。低版本（比如 18、20）装了也没用，OpenClaw 直接就报错不认。

先打开 PowerShell，输入下面这行命令看看你有没有装过：

node -v

如果屏幕上显示了 v22.x.x（x 代表任意数字），说明已经装好了，直接跳到下一步。

如果显示"不是内部或外部命令"或者版本低于 22，按下面的方法安装：

推荐方式：去官网下载安装包（最简单）

1. 打开浏览器，访问 Node.js 官方下载页
2. 选择 Windows 系统，下载 .msi 安装包
3. 双击运行安装包，一直点 “Next”（下一步） 就行
4. 安装过程中会看到一个选项叫 “Automatically install the necessary tools”（自动安装必要工具），一定要勾上！它会帮你顺便装好后面可能用到的 C++ 编译工具

特别注意：安装完成后，你必须关掉当前的 PowerShell 窗口，重新打开一个新的！这一步非常关键，因为 Windows 不会自动识别刚装好的软件，不关掉重开的话，后面输什么命令都会提示"找不到"。

重新打开 PowerShell 后，输入下面两行验证一下：

node -v
npm -v

注意：如果你没法科学上网，请先参考后面的 国内网络优化 章节把镜像源换好，否则后面的步骤大概率会因为网络问题安装失败。

两行都显示了版本号就说明没问题。npm 是跟着 Node.js 一起装好的，后面用它来安装 OpenClaw。

第三步：安装 Git

Git 是什么？ Git 是一个版本管理工具，OpenClaw 在安装过程中会用到它来下载一些文件。

你不需要学会用 Git，只需要确保电脑上有这个软件就行。

先在 PowerShell 里输入：

git --version

如果显示了版本号，说明已经有了，跳过这步。

如果提示"不是内部或外部命令"，按下面的步骤安装：

1. 打开浏览器，访问 Git 官网
2. 点击 “Download for Windows”
3. 下载后双击安装，全部选默认选项，一路 “Next” 到底
4. 安装完成后，再次关掉 PowerShell 重新打开

第四步：修改 PowerShell 执行策略

这一步是很多人安装失败的"隐形杀手"。Windows 为了安全，默认不允许 PowerShell 运行从网上下载的脚本。如果你不改这个设置，后面执行 OpenClaw 安装命令时会直接被系统拦截。

操作方法：

1. 以管理员身份打开 PowerShell（前面教过怎么做：搜索 PowerShell → 右键 → 以管理员身份运行）
2. 输入下面这行命令后按回车：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

3. 如果弹出确认提示，输入 Y 再按回车

这条命令的意思是"允许运行本地的脚本和经过签名的远程脚本"。

这是一个很安全的设置，不会给你的电脑带来风险，放心操作就好。

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

OpenClaw 有一些组件需要在你的电脑上"现场编译"（可以理解为现场组装零件），这个过程需要用到 C++ 编译工具。

如果你在第二步安装 Node.js 时勾选了 “Automatically install the necessary tools”，这一步可以直接跳过，因为那个选项已经帮你装好了。

如果当时没勾选，需要手动安装一下：

1. 打开浏览器，搜索 “Visual Studio Build Tools” 下载安装
2. 安装时勾选以下内容：
   • “使用 C++ 的桌面开发” 这个工作负载
   • MSVC v143 编译器
   • Windows 10/11 SDK
3. 安装包比较大（约 2-3 GB），需要等一会儿

第六步：执行 OpenClaw 安装脚本

好了，前面的准备工作都做完了，现在开始正式安装 OpenClaw！

打开一个新的 PowerShell 窗口（这次普通模式就行，不需要管理员），输入下面这行命令：

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

国内用户注意：如果你没有外网条件，执行这行命令前先参考后面的 国内网络优化 章节把镜像源换好，否则大概率会因为网络问题安装失败。

这行命令会自动帮你完成三件事：

1. 检查你的 Node.js 版本对不对
2. 下载并安装 OpenClaw
3. 启动一个配置向导（后面会详细讲怎么配）

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

安装过程中如果看到一堆英文在滚动，不用担心，那是正常的安装日志。

安装完成后，输入下面的命令验证一下：

openclaw --version
openclaw status

如果能正常显示版本号和状态信息，恭喜你，安装成功了！

如果提示"openclaw 不是内部或外部命令"怎么办？ 这个问题十有八九是"路径"没设置好。

通俗说就是 Windows 不知道 OpenClaw 装在哪儿了。解决方法：

1. 在 PowerShell 中输入 npm config get prefix，它会显示一个路径（比如 C:\Users\你的用户名\AppData\Roaming\npm）
2. 按 Win + I 打开系统设置
3. 搜索"环境变量"，点击 “编辑系统环境变量”
4. 在弹出的窗口中点击 “环境变量”
5. 在上方的 “用户变量” 中找到 Path，双击它
6. 点击 “新建”，把刚才那个路径粘贴进去
7. 一路确定保存，然后重新打开 PowerShell

方案二：WSL2 安装（推荐怕麻烦的朋友）

如果你看了方案一觉得步骤太多、太折腾，那 WSL2 方案绝对适合你。

装好之后整个体验和 Linux 一模一样，不会碰到 Windows 特有的那些环境问题。

什么是 WSL2

WSL2 全称 Windows Subsystem for Linux 2，翻译过来就是"Windows 下的 Linux 子系统"。

你可以把它理解成：在你的 Windows 电脑里装了一个迷你版的 Linux 系统。

它不是虚拟机（不需要你专门下载一个几十 GB 的系统），而是微软官方内置的功能。开启之后，你就可以在 Windows 里直接运行 Linux 的命令了。

OpenClaw 官方也推荐 Windows 用户用这种方式安装。

唯一的缺点就是它会额外占用 1-2 GB 内存。

如果你的电脑内存低于 8 GB，可能会有点紧张。

开启 WSL2

1. 以管理员身份打开 PowerShell（搜索 PowerShell → 右键 → 以管理员身份运行）
2. 输入下面这行命令：

wsl --install

3. 等待安装完成，然后重启电脑
4. 重启后会自动弹出一个 Ubuntu（一种 Linux 系统）的窗口，让你设置用户名和密码

设置用户名和密码时的注意事项：

• 用户名只能用小写英文字母，不能有空格和中文
• 密码输入时屏幕上不会显示任何内容（连星号都不会有），这是 Linux 的正常行为，直接盲输就行
• 密码建议设置简单一点，后面会用到

如果 wsl --install 报错了怎么办？ 你可能需要手动开启两个 Windows 功能：

1. 按 Win + S 搜索 “启用或关闭 Windows 功能” 并打开
2. 找到 “适用于 Linux 的 Windows 子系统” 和 “虚拟机平台” 这两项，勾选上
3. 点确定，等待安装完成后重启电脑
4. 重启后重新打开管理员 PowerShell，再次运行 wsl --install

安装好之后，以后你随时可以通过在开始菜单搜索 “Ubuntu” 来打开这个 Linux 子系统。

在 WSL2 中安装 OpenClaw

打开 Ubuntu 终端，先把 Node.js 装好（还记得前面说的吗，这是 OpenClaw 的"引擎"）：

# 下载 Node.js 22 的安装源
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# 安装 Node.js
sudo apt install -y nodejs

# 验证安装成功（应该显示 v22.x.x）
node -v
npm -v

输入带 sudo 的命令时系统会要求输入密码，就是你刚才设置的那个。

同样，输入时屏幕不会有任何显示，直接输入完按回车就行。

然后一行命令搞定 OpenClaw：

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

就是这么简单。

在 WSL2 下面，你不用操心 PowerShell 权限、C++ 编译工具这些 Windows 独有的问题。

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

这一步对国内用户来说几乎是必做的，除非你有科学上网条件。

npm 默认是从国外的服务器下载东西的，国内直连的话速度非常慢，经常等半天然后超时失败。好在国内有镜像站点可以用，效果和原版一模一样，只是下载源换到了国内服务器。

在 PowerShell 或 Ubuntu 终端中输入：

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

这样后续所有 npm 的下载都会走淘宝镜像，速度嗖嗖的。

以后如果你不需要镜像了，想切回来也很简单：

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

友情提醒：这一步一定要在执行 OpenClaw 安装脚本之前做好。

很多人在安装过程中反复遇到 ETIMEDOUT（连接超时）或 ECONNREFUSED（连接被拒绝）的错误，几乎都是因为没有切换镜像源。

安装后的初始化配置

Onboarding 配置向导

安装脚本执行完毕后会自动弹出一个配置向导，引导你完成初始设置。

如果你不小心关掉了，随时可以通过下面这行命令重新打开：

openclaw onboard --install-daemon

或者用快速启动模式：

openclaw onboard --flow quickstart

向导中会问你几个问题，这里教你怎么选：

1. 免责声明确认

I understand this is powerful and inherently risky. Continue?

翻译过来就是"我知道这个工具很强大也有一定风险，是否继续？“选择 Yes。

2. 安装模式

选择 Quickstart（快速开始），这个模式会帮你跳过很多复杂配置。

3. 大模型 API 配置

这里需要你选择一个 AI 模型并输入 API Key。如果你还没准备好，可以先选 Skip（跳过），后面再配也行。

4. 聊天渠道

可以选择接入飞书、Telegram 等聊天工具。如果不确定，先选 Skip 跳过。

5. Skills 技能配置

初次安装建议选 No，等你熟悉了 OpenClaw 之后再按需添加（Skills 就是这个龙虾的各种功能，你装了啥它就能帮你做啥）。

安装启动网关后，它可能会自动打开一个新的 PowerShell 窗口，这个窗口不要关掉，它是 OpenClaw 的后台服务进程。

遇到问题了？ 如果配置过程中系统提示找不到 OpenClaw，试试关掉 PowerShell，然后用管理员身份重新打开，通常环境变量会自动刷新，问题就消失了。

配置大模型 API Key

OpenClaw 需要对接一个 AI 大模型才能工作。

如果在向导中跳过了这一步，后面可以通过命令重新配置：

openclaw config

你也可以直接编辑配置文件：

• Windows 原生安装：配置文件在 C:\Users\你的用户名\.openclaw\clawdbot.json
• WSL2 安装：配置文件在 ~/.openclaw/clawdbot.json

在配置文件的 models.providers 部分，填入你的模型信息和 API Key 就行了。

安全提示：API Key 是你使用 AI 服务的"密码”，千万不要分享给别人，也不要上传到任何公开的地方。

启动 Gateway 并验证

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

openclaw gateway start

然后打开你的浏览器，在地址栏输入 http://localhost:18789，如果看到了 OpenClaw 的控制面板页面，说明一切 OK！

你也可以在 PowerShell 或终端中输入这几个命令来检查状态：

# 健康检查，看看有没有什么问题
openclaw doctor

# 查看运行状态
openclaw status

# 查看你配置的模型列表
openclaw models list

接入飞书机器人（可选）

具体可参考飞书文档：

如果你希望直接在飞书里和 OpenClaw 对话（而不是每次都打开网页），可以按下面的步骤把飞书接入进来。

1. 安装飞书渠道插件

在 PowerShell 或终端中输入：

openclaw channels add

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

2. 在飞书开放平台创建应用

1. 打开浏览器，访问 飞书开放平台，登录你的飞书账号
2. 点击右上角进入 “开发者后台”
3. 点击 “创建企业自建应用”，填写应用名称（随便取个名字就行），然后点创建
4. 在应用页面找到 “添加应用能力”，选择添加 “机器人”

3. 配置机器人权限

在应用后台找到 “权限管理”，点击 “批量导入权限”，把下面这段内容复制粘贴进去：

{
  "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"
    ]
  }
}

4. 配置事件订阅

• 在应用后台找到 “事件与回调”
• 选择 “使用长连接接收事件”，保存
• 点击 “添加事件”，搜索 im.message.receive_v1，勾选添加（这一步是让机器人能收到消息，不加的话发什么消息机器人都收不到）

5. 发布应用并绑定

• 点击 “创建版本”，随便写个版本号和说明，然后发布上线
• 在 “凭证与基础信息” 页面找到 App ID 和 App Secret
• 回到 PowerShell / 终端，按提示把这两个值输入进去
• 打开飞书，找到你创建的机器人，发一条消息，收到回复就说明接入成功了

Windows 常见报错与解决方案

Windows 上部署 OpenClaw 确实比 Mac 和 Linux 多一些问题，这里把最常遇到的错误整理出来，遇到了直接对照处理：

处理 Windows Defender 拦截的方法：

1. 按 Win + I 打开设置
2. 搜索并进入 “病毒和威胁防护”
3. 点击 “管理设置”，往下找到 “排除项”
4. 点击 “添加或删除排除项”，选择 “添加文件夹”
5. 分别添加以下路径：
   • %APPDATA%\openclaw
   • %USERPROFILE%\.openclaw
   • Node.js 安装目录（通常是 C:\Program Files\nodejs）
6. 安装完成后，如果你在意安全，可以把这些排除项删掉

网上有些教程会让你直接关闭 Defender，千万别这么做。加排除项就够了，既不影响安装，也不影响系统安全。

日常运维命令速查

装好之后，日常使用中你可能会用到这些命令，存下来备用：

# 启动网关（每次开机后需要手动启动）
openclaw gateway start

# 重启网关（遇到卡死或异常时用）
openclaw gateway restart

# 停止网关
openclaw gateway stop

# 打开网页控制面板
openclaw dashboard

# 检查健康状态（出问题时先跑这个）
openclaw doctor

# 查看运行状态
openclaw status

# 实时查看日志（排查问题的利器）
openclaw logs follow

# 重新进入配置向导
openclaw onboard

# 修改模型配置
openclaw config

# 查看已装的模型
openclaw models list

# 添加聊天渠道（飞书、Telegram 等）
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 才引入的一些底层功能，低版本跑不起来。如果你电脑上之前装过老版本的 Node.js，可以去 nvm-windows 下载一个版本管理工具，用它来切换不同版本。

Q3：原生安装和 WSL2 安装能同时存在吗？

技术上可以，但不建议。两种方式的配置文件存在不同的地方，同时维护容易搞混。选定一种方式就一直用它。

Q4：安装到一半失败了怎么办？

先运行 openclaw doctor 看看诊断报告怎么说。如果想从头再来，可以删除配置目录后重新安装：

• 原生安装的配置目录：C:\Users\你的用户名\.openclaw
• WSL2 安装的配置目录：在 Ubuntu 终端中输入 rm -rf ~/.openclaw

Q5：API Key 要花钱吗？

看你选哪个模型。Gemini 有免费额度适合体验，Kimi 等国产模型注册就能用。Claude 和 GPT 效果好但需要付费。建议先用免费的体验一下，觉得好用了再考虑付费。

Q6：我没有科学上网条件，能装吗？

可以。在安装前先把 npm 镜像切换到淘宝源（文章里有写怎么切），绝大部分下载就能走国内服务器了。安装脚本本身可能也需要访问外网，如果实在连不上，可以试试手动安装的方式：直接运行 npm install -g openclaw@latest。

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

强烈建议装。OpenClaw 可以安装各种 Skill 技能来扩展功能，但有些技能可能存在安全风险。装了 security-audit 之后，每次添加新技能都可以做一次安全扫描，相当于给你的系统加了一道"安检"。

Q8：能用 CMD（命令提示符）代替 PowerShell 吗？

不推荐。CMD 是 Windows 的老一代命令行工具，OpenClaw 的安装脚本是专门为 PowerShell 写的。用 CMD 会遇到各种兼容性问题，比如修改执行策略那一步在 CMD 里根本没有对应的命令。

Q9：PowerShell 跟 CMD 有什么区别？

简单来说，PowerShell 是 CMD 的升级版，功能更强大。Windows 10 以上系统都自带了 PowerShell，你搜索打开就能用。如果你在搜索栏搜不到 PowerShell，试试搜索 “终端” 或 “Terminal”，Windows 11 默认的终端就是 PowerShell。

总结

一步步走下来，在 Windows 上把 OpenClaw 跑起来其实没那么难，关键是要把环境准备工作做到位。来回顾一下整个流程：

1. 确认网络条件：能访问外网最好，不能的话提前把 npm 镜像换成淘宝源
2. 选择安装方案：怕折腾选 WSL2，需要操作 Windows 桌面选原生安装
3. 装好前置工具：Node.js 22 + Git，原生安装还需要改 PowerShell 执行策略
4. 执行安装脚本：原生用 iwr -useb https://openclaw.ai/install.ps1 | iex，WSL2 用 curl -fsSL https://openclaw.ai/install.sh | bash
5. 完成配置：配好 API Key，启动 Gateway，打开浏览器 http://localhost:18789 验证
6. 按需扩展：接入飞书、安装 Skills 技能等

安装过程中遇到报错别慌，绝大多数都是环境配置的问题。先跑一下 openclaw doctor 看看诊断结果，再对照文章中的常见报错表格找解决办法，基本都能搞定。

如果大家在安装部署 OpenClaw 的过程中遇到了什么问题，或者发现了文章中没覆盖到的报错，欢迎在评论区留言交流，我看到都会回复的～～～