# 🦞 手把手教程：在 Windows 上通过 WSL2 部署 OpenClaw 并接入飞书，打造你的 24 小时数字员工

> **导语**：谁说强大的 AI Agent 只能在 Linux 上运行？虽然 OpenClaw 官方原生支持 Linux 和 macOS，但通过 **Windows Subsystem for Linux (WSL2)**，我们完全可以在 Windows 11/10 上获得丝滑、原生般的体验！  
> 本指南将手把手带你完成从 **零配置 WSL2** 到 **成功部署 OpenClaw**，再到 **无缝接入飞书机器人** 的全过程。我们将直面并解决所有可能遇到的“坑”，让你在 Windows 上也能拥有一个会自我进化的 AI 伙伴！

---

## ⚠️ 重要前提：为什么必须用 WSL2？

根据官方文档和社区实践（截至 2026 年），**OpenClaw 是一个基于 Node.js 的复杂系统**，其部分底层依赖（如文件监听、进程管理）在 Windows 原生命令行（CMD/PowerShell）中存在兼容性问题。

**WSL2 在 Windows 内核上运行一个完整的 Linux 内核**，为你提供了一个与 Ubuntu 等发行版几乎无异的开发环境，是目前在 Windows 上运行 OpenClaw **最可靠且社区广泛验证**的方式。

---

## 🛠 第一部分：在 Windows 上安装并配置 WSL2

### 步骤 1：启用 WSL 功能
以 **管理员身份** 打开 PowerShell，并执行以下命令：

```powershell
# 启用必要的 Windows 功能
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
```

✅ **执行完毕后，务必重启你的电脑**。

### 步骤 2：设置 WSL2 为默认版本
重启后，再次打开 **普通用户权限** 的 PowerShell，运行：

```powershell
# 将 WSL2 设置为默认版本
wsl --set-default-version 2
```

### 步骤 3：安装 Linux 发行版（推荐 Ubuntu 22.04 LTS）
1. 打开 **Microsoft Store (微软应用商店)**。
2. 搜索 “**Ubuntu**”。
3. 选择 “**Ubuntu 22.04 LTS**”，点击 “获取” 进行安装。

> 💡 **避坑提示**：如果你在中国大陆，可能会遇到网络问题。可以尝试在 PowerShell 中使用：
> ```powershell
> wsl --install -d Ubuntu-22.04
> ```
> 并确保系统代理已正确配置（如果使用）。

### 步骤 4：初始化 Ubuntu
1. 安装完成后，在开始菜单中启动 “**Ubuntu**”。
2. 首次启动会要求你创建一个 **Linux 用户名和密码**（这与你的 Windows 账户无关，请牢记）。
3. 初始化完成后，你就拥有了一个功能完备的 Linux 终端！

---

## 🚀 第二部分：在 WSL2 中安装 OpenClaw

现在，我们的操作环境已经切换到了 WSL2 的 Ubuntu 终端。

### 步骤 1：更新系统并安装必要依赖
```bash
# 更新包列表
sudo apt update

# 安装 Git 和 curl（通常已预装，但保险起见）
sudo apt install -y git curl

# 安装 Node.js (v20+ LTS)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# 验证安装
node -v  # 应输出 v20.x.x
npm -v   # 应输出 10.x.x
```

### 步骤 2：克隆并安装 OpenClaw
这是最标准、最可控的方式。

```bash
# 克隆官方仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装项目依赖
npm install

# 构建项目（如果需要）
npm run build
```

> ✅ **注意**：不要使用 `sudo` 运行 `npm install`，这可能导致权限问题。

### 步骤 3：配置模型提供商
OpenClaw 需要连接一个大模型 API 才能工作。我们以 **DeepSeek** 为例（完全本地化方案）。

#### 方案 A：使用 Ollama + DeepSeek（推荐，完全离线）
1. 在 **Windows 主机** 上安装 [Ollama](https://ollama.com)。
2. 在 Windows PowerShell 中拉取模型：
   ```powershell
   ollama run deepseek-chat
   ```
3. 在 WSL2 的 OpenClaw 目录下，创建 `.env` 文件：
   ```env
   MODEL_PROVIDER=ollama
   OLLAMA_MODEL=deepseek-chat
   OLLAMA_BASE_URL=http://localhost:11434
   ```

> 🔔 **关键**：WSL2 可以通过 `localhost` 访问 Windows 主机上的服务，因此 `OLLAMA_BASE_URL` 保持为 `http://localhost:11434` 即可。

#### 方案 B：使用云端 API（如 OpenAI, Claude, 国内大模型）
在 `.env` 中配置：
```env
MODEL_PROVIDER=openai
OPENAI_API_KEY=your_api_key_here
OPENAI_MODEL=gpt-4o
```

### 步骤 4：启动 OpenClaw 核心服务（用于本地测试）
```bash
# 启动核心服务
npm start
```
访问 `http://localhost:3000`（在 Windows 浏览器中打开），你应该能看到 OpenClaw 的 Web UI。

---

## 💬 第三部分：接入飞书机器人（核心！）

OpenClaw 通过其 **插件系统** 支持飞书接入。社区已开发了成熟的 `@openclaw/feishu` 插件。

### 步骤 1：在飞书开放平台创建应用
1. 访问 [飞书开放平台](https://open.feishu.cn/)。
2. 点击 “**创建企业自建应用**”。
3. 填写应用名称（如 “My OpenClaw”），点击 “创建”。

### 步骤 2：配置应用权限
1. 在应用详情页，进入 “**应用功能**” -> “**机器人**”，确保已启用。
2. 进入 “**权限管理**”，申请以下权限：
   - `im:message:send_as_bot`
   - `im:message:read`
   - `contact:user:readonly`
3. **保存并发布** 权限。

### 步骤 3：获取凭证
在 “**凭证与基础信息**” 页面，记下：
- **App ID**
- **App Secret**

### 步骤 4：在 WSL2 中安装并配置飞书插件
回到你的 WSL2 Ubuntu 终端：

```bash
# 在 openclaw 目录下，安装飞书插件
npm install @openclaw/feishu

# 创建飞书配置文件 (feishu.config.json)
cat > feishu.config.json <<EOF
{
  "appId": "你的_App_ID",
  "appSecret": "你的_App_Secret",
  "userIds": [], // 留空表示所有用户可用，或填入你的飞书ID
  "domain": "feishu"
}
EOF
```

### 步骤 5：启动飞书网关
OpenClaw 的网关服务负责与飞书通信。在 **另一个终端窗口**（或使用 `screen`/`tmux`）中运行：

```bash
# 确保在 openclaw 目录下
cd ~/openclaw

# 启动飞书网关
npx tsx scripts/gateway.ts feishu
```

> ✅ **关键优势**：此模式使用 **WebSocket 长连接**，由 OpenClaw 主动连接飞书服务器，**不需要公网 IP 或内网穿透**，在家用网络下即可正常工作。

### 步骤 6：在飞书中测试！
1. 打开你的飞书客户端。
2. 搜索你创建的应用（或在群聊中添加它）。
3. 向它发送一条消息，比如 “你好！” 或 “在桌面上创建一个测试文件”。
4. 如果一切顺利，你的 OpenClaw Agent 就会回复你，并执行相应操作！

> 💡 **避坑提示**：
> - **防火墙**：确保 Windows 防火墙没有阻止 WSL2 的出站连接。
> - **日志排查**：如果无响应，查看 `gateway.ts` 的终端输出，通常会有明确的错误信息（如 App ID 错误、权限不足等）。
> - **多终端**：你需要同时运行 `npm start`（核心服务）和 `gateway.ts`（飞书网关）两个进程。

---

## 💎 总结：你的 Windows 数字员工已就位！

通过 WSL2 这座桥梁，我们在 Windows 上成功搭建了一个功能完整、能够自我进化的 OpenClaw AI Agent，并将其无缝接入了飞书工作流。

### 核心流程回顾：
1. **启用并安装 WSL2 (Ubuntu 22.04)**。
2. **在 WSL2 终端中安装 Node.js 并克隆 OpenClaw**。
3. **配置模型 API（推荐 Ollama + DeepSeek 实现完全离线）**。
4. **在飞书开放平台创建应用并获取凭证**。
5. **安装 `@openclaw/feishu` 插件并启动网关服务**。

现在，无论你是在 Windows 上办公，还是在飞书里沟通，你的 AI 分身都已就位。你可以对它说：
> “帮我把上周的销售数据整理成图表发到群里。”
> “监控我的下载文件夹，新 PDF 自动转为 Word。”

这只“数字龙虾”将 7×24 小时为你效劳，真正成为你的生产力倍增器！🦞

导语：谁说强大的 AI Agent 只能在 Linux 上运行？虽然 OpenClaw 官方原生支持 Linux 和 macOS，但通过 Windows Subsystem for Linux (WSL2)，我们完全可以在 Windows 11/10 上获得丝滑、原生般的体验！   本指南将手把手带你完成从 零配置 WSL2 到 成功部署 OpenClaw，再到 无缝接入飞书机器人 的全过程。我们将直面并解决所有可能遇到的“坑”，让你在 Windows 上也能拥有一个会自我进化的 AI 伙伴！

手把手教程：在 Windows 上通过 WSL2 部署 OpenClaw 并接入飞书，打造你的 24 小时数字员工

谁说强大的 AI Agent 只能在 Linux 上运行？虽然 OpenClaw 官方原生支持 Linux 和 macOS，但通过 Windows Subsystem for Linux (WSL2)，我们完全可以在 Windows 11/10 上获得丝滑、原生般的体验！   本指南将手把手带你完成从 零配置 WSL2 到 成功部署 OpenClaw，再到 无缝接入飞书机器人 的全过程。

人工智能

开发工具

操作系统

Windows用户福音！本教程详细讲解如何通过WSL2在Windows系统部署OpenClaw AI助手，并实现与飞书的无缝对接。从WSL2环境配置、OpenClaw安装到飞书机器人接入，手把手教你打造24小时待命的数字员工。特别针对国内用户优化，提供离线方案和常见问题解决方案，让Windows用户也能享受强大的AI生产力工具。

服务器

防火墙

Windows

Ubuntu

Linux

4核4G3M云服务器 新用户低至38元/年！

2026采购季 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Windows用户福音！本教程详细讲解如何通过WSL2在Windows系统部署OpenClaw AI助手，并实现与飞书的无缝对接。从WSL2环境配置、OpenClaw安装到飞书机器人接入，手把手教你打造24小时待命的数字员工。特别针对国内用户优化，提供离线方案和常见问题解决方案，让Windows用户也能享受强大的AI生...

手把手教程：在 Windows 上通过 WSL2 部署 OpenClaw 并接入飞书，打造你的 24 小时数字员工-腾讯云开发者社区-腾讯云

手把手教程：在 Windows 上通过 WSL2 部署 OpenClaw 并接入飞书，打造你的 24 小时数字员工

手把手教程：在 Windows 上通过 WSL2 部署 OpenClaw 并接入飞书，打造你的 24 小时数字员工

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐