2026最新OpenClaw Windows保姆级安装教程：从原生到WSL2，手把手带你“养虾”避坑

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

最近，OpenClaw（也被大家戏称为“养虾”）在技术圈的热度持续攀升。作为一款本地优先、强执行能力的开源AI智能体（Agent），OpenClaw不仅仅是另一个聊天机器人，它能真正通过自然语言指令操作你的设备——处理文件、调用工具、联动飞书等办公软件，实现了从“对话”到“执行”的跨越。

然而，伴随着热度而来的是新手在部署时的各种“劝退”瞬间：Node.js环境冲突、PowerShell权限不足、WSL配置失败、插件安装卡顿……特别是Windows用户，由于官方对Linux/macOS更友好，原生环境确实存在不少“坑”。

本文将结合2026年最新实测经验，彻底讲透Windows系统下的两种安装方案（原生PowerShell硬装与官方推荐的WSL2+Ubuntu方案），并附赠飞书集成配置及常见问题排雷手册。无论你是零基础小白还是想体验IM联动的进阶玩家，跟着这篇教程走，保证一次成功！

在复制粘贴命令之前，建议你先花一分钟搞清楚这三个问题，这会让你后面的安装过程顺畅十倍。

1. 你到底需要什么样的环境？

OpenClaw官方对Windows的支持策略很明确：推荐使用WSL2（Windows Subsystem for Linux），因为CLI和Gateway跑在Linux环境下兼容性更好，Node二进制文件和Skills的适配也更稳定。

但这并不意味着原生Windows不能装。根据你的需求，可以这样选：

只是想快速体验/轻度测试：选择 方案A（原生PowerShell安装）。简单直接，但后续扩展技能可能遇到权限问题。
准备长期使用/接入办公软件/跑自动化任务：选择 方案B（WSL2 + Ubuntu安装）。这是官方钦定的“标准答案”，环境更干净，问题更少。

2. 你的电脑准备好了吗？

无论是哪种方案，都需要满足以下基本条件：

系统：Windows ¹⁰⁄₁₁ 64位（建议Win11 build 26200+ 或 Win10 专业版/企业版）。
内存：≥8GB（推荐16GB，毕竟要跑Node和可能的本地模型）。
权限：全程需要使用管理员权限操作。
网络：部署阶段需要联网下载依赖，建议网络环境稳定（无需“科学上网”，但访问GitHub可能需要稳定连接）。

3. 重要提醒：隐私与安全

由于OpenClaw具备操作本地文件的能力，如果你的电脑存有重要的商业机密或个人隐私信息，强烈建议使用一台干净的备用设备，或者直接租用一台云端VPS（如阿里云轻量服务器）来运行，避免因自动化脚本误操作或权限泄露导致风险。

此方案适合想在Windows系统内直接运行，不愿折腾虚拟环境的用户。注意： 此方案在安装飞书等插件时可能遇到兼容性报错，需要手动干预。

步骤1：以管理员身份打开PowerShell

按下，搜索“PowerShell”，右键点击选择 “以管理员身份运行”。这是后续所有命令执行的基础，否则会报权限错误。

步骤2：解锁PowerShell执行策略

新版的Windows通常默认禁止执行来自互联网的脚本。先输入以下命令解除限制（仅对当前进程有效，安全无副作用）：

GPT plus 代充 只需 145

步骤3：一键安装OpenClaw

在管理员PowerShell中直接粘贴以下命令，安装脚本会自动处理Node.js依赖（如果未安装，脚本会调用nvm或直接下载）：

如果你在国内网络环境下遇到下载超时，可以尝试使用国内镜像源命令（如果有提供）或手动安装Node.js后再重试。

步骤4：初始化配置（Onboard）

安装完成后，执行初始化向导。这一步会引导你配置模型API（可以先跳过）、工作目录等。

GPT plus 代充 只需 145

遇到：输入回车。
Model/auth provider：如果你还没有大模型API Key（如阿里云百炼、Kimi等），可以先选择，后续再配置。
Skill和Channel：同样可以先选择跳过，等核心服务跑通后再安装。

步骤5：启动网关并验证

配置完成后，启动Gateway服务。Gateway是OpenClaw的“心脏”，负责接收消息和调度任务。

服务启动后，打开浏览器，访问本地控制台地址：http://127.0.0.1:18789/。如果能看到界面，说明原生安装成功。

这是目前社区公认最稳的Windows运行方式，本质上是在Windows内跑了一个轻量级Linux虚拟机，环境纯净且与官方文档保持高度一致。

步骤1：启用WSL2功能并安装Ubuntu

同样以管理员身份打开PowerShell，执行以下命令一键安装WSL及默认的Ubuntu发行版：

GPT plus 代充 只需 145

该命令会启用必要的Windows功能，下载并安装最新的Ubuntu LTS版本。安装完成后，按提示重启电脑。

步骤2：初始化Ubuntu子系统

重启后，在开始菜单中找到并打开 “Ubuntu”（或你安装的版本）。首次打开会让你设置：

用户名：任意输入（建议小写英文）。
密码：输入时屏幕无显示（Linux特性），正常输入并记住即可。

进入Ubuntu终端后，首先更新系统软件包：

步骤3：在Ubuntu中安装OpenClaw

现在你已经身处Linux环境了。执行OpenClaw官方Linux安装脚本：

GPT plus 代充 只需 145

脚本运行过程中如果提示缺少Node.js，它会自动处理。你也可以提前通过或安装Node.js 22.x版本。

步骤4：初始化并启用systemd（关键步骤！）

在WSL中，为了能让OpenClaw的Gateway服务在后台稳定运行并开机自启，需要启用systemd。

在Ubuntu终端中编辑WSL配置文件：
在文件中添加以下内容：
```
GPT plus 代充 只需 145
```
保存（Ctrl+O，回车）并退出（Ctrl+X）。
回到Windows PowerShell（管理员），执行以下命令完全重启WSL：
重新打开Ubuntu终端，此时systemd已生效。

步骤5：运行初始化向导与启动服务

在Ubuntu终端中执行：

GPT plus 代充 只需 145

步骤6：访问控制台

服务启动后，在Windows浏览器中同样访问 http://127.0.0.1:18789/。你会发现，虽然OpenClaw跑在Linux子系统里，但它的Web服务端口被自动映射到了Windows，使用起来毫无区别。

部署成功后，接下来是大家最关心的环节：把OpenClaw接入飞书，实现在聊天框里指挥AI干活。

整体思路：在OpenClaw里安装飞书插件 → 在飞书开放平台创建应用并配置权限 → 双向绑定。

1. 安装飞书插件（在PowerShell或Ubuntu终端执行）

确保OpenClaw网关正在运行，然后执行插件安装命令：

等待插件下载完成。

2. 创建飞书应用并获取凭证

访问飞书开放平台，进入“开发者后台”。

创建一个企业自建应用，取名“我的AI助手”之类的。
创建成功后，在“凭证与基础信息”页面，复制 App ID 和 App Secret 备用。

3. 配置权限和事件

权限管理：点击“批量导入导出权限”，粘贴以下JSON代码，为机器人添加必要权限：
```
GPT plus 代充 只需 145
```
事件与回调：
- 订阅方式选择 “使用长连接接收事件”（因为你的OpenClaw是本地部署，没有公网域名和HTTPS证书，长连接是最简单的方案）。
- 添加事件：搜索并添加（接收用户消息）。

4. 在OpenClaw中完成绑定

回到OpenClaw的控制台（http://127.0.0.1:18789/）或通过CLI，找到飞书插件的配置入口，填入刚才复制的和。
在飞书客户端找到你的应用，发送任意消息。机器人会自动回复一个配对码。
将配对码复制，发送给OpenClaw的对话框（或按插件指引在控制台输入），完成最终绑定。

至此，你就可以在飞书里尽情调教你的“虾”了！

报错1：命令找不到

原因：Node.js的全局安装路径没有添加到系统的环境变量（PATH）中。
解决：关闭当前Powerhell/终端，重新以管理员身份打开。如果还是不行，手动添加（Windows）或（Linux/WSL）到环境变量。

报错2：WSL2中systemd无法启动，服务无法开机自启

原因：文件未配置或配置后未完全重启WSL。
解决：检查文件是否配置。然后在Windows PowerShell中执行，再重新打开Ubuntu，执行验证是否生效。

报错3：安装脚本下载慢或失败

原因：网络波动或访问GitHub受限。
解决：方案A用户可以尝试先手动安装Node.js 22.x版本，然后再执行OpenClaw安装命令。方案B用户可以在Ubuntu内配置代理或使用国内镜像源安装Node.js。

报错4：飞书插件安装失败

原因：原生Windows环境下的权限问题或npm源问题。
解决：如果在原生PowerShell下一直失败，可以切换到WSL2环境下安装飞书插件，这是目前最稳妥的方案。同时可以配置npm国内镜像加速：。

OpenClaw的强大之处在于它将AI的能力从“建议”升级为了“执行”。虽然在Windows上部署它需要一点耐心，但只要按照本文提供的方案B（WSL2） 路径走，绝大多数“坑”都可以被绕开。

部署只是第一步，接下来你可以根据自己的工作流，慢慢为它添加各种“Skills”（如网页搜索、代码执行、文件处理），打造一个真正属于你自己的全能AI助手。

如果你在安装过程中遇到了本文未提及的新问题，欢迎在评论区留言，我们一起探讨解决！

觉得本文对你有帮助吗？点个赞，让更多“养虾”新手看到吧！