
## 💡 导语

谁说强大的 AI Agent 只能在 Linux 上运行？虽然 **Hermes Agent** 官方原生支持 Linux 和 macOS，但通过 **Windows Subsystem for Linux (WSL2)**，我们完全可以在 Windows 11/10 上获得丝滑、原生般的体验！

本指南将手把手带你完成从 **零配置 WSL2** 到 **成功部署 Hermes Agent**，再到 **接入飞书机器人** 的全过程。我们将直面并解决所有可能遇到的“坑”，让你在 Windows 上也能拥有一个会自我进化的 AI 伙伴！

> 🔥 **为什么现在是最佳时机？**  
> 截至 2026 年 4 月，Hermes Agent 已迭代至 **v0.8.1**，其 **飞书网关（Gateway）模块** 经过社区大规模验证，稳定性极高。配合 WSL2，你甚至能以 **5 美元/月** 的成本（本地 PC + 免费模型 API）养一个 7×24 小时在线的数字员工！

---

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

根据官方文档和社区实践，Hermes Agent 是一个基于 Python 的复杂系统，重度依赖 Linux 环境下的工具链（如 `uv`、特定的系统库、`systemd` 进程管理等）。直接在 Windows 原生命令行（CMD/PowerShell）或 Git Bash 中安装几乎肯定会失败。

**WSL2 在 Windows 内核上运行一个完整的 Linux 内核**，为你提供了一个与 Ubuntu 等发行版几乎无异的开发环境，是目前在 Windows 上运行 Hermes Agent **唯一可靠且官方推荐的方式**。

> 📌 **官方立场佐证**：  
> Hermes Agent 中文社区文档明确指出：“*For Windows users, WSL2 is the only supported installation method.*”（对于 Windows 用户，WSL2 是唯一受支持的安装方式。）

---

## 🛠 第一部分：在 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
```

> 💡 **验证命令**：运行 `wsl -l -v`，若看到 `VERSION 2`，则配置成功。

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

> ✅ **为什么选 22.04 LTS？**  
> 该版本是 Hermes Agent 官方测试矩阵中的标准环境，兼容性最佳，社区问题最少。

### 步骤 4：初始化 Ubuntu
安装完成后，在开始菜单中启动 “**Ubuntu**”。

- 首次启动会要求你创建一个 **Linux 用户名和密码**（这与你的 Windows 账户无关，请牢记）。
- 初始化完成后，你就拥有了一个功能完备的 Linux 终端！

> 💡 **避坑提示**：如果你在中国大陆，可能会遇到网络问题导致安装缓慢或失败。可以尝试在 PowerShell 中使用：
> ```powershell
> wsl --install -d Ubuntu-22.04 --web-download
> ```
> 并配合系统代理（如果有的话）。此外，安装后建议立即更换国内源（如清华源）以加速后续操作。

---

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

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

### 步骤 1：更新系统包（可选但推荐）
```bash
sudo apt update && sudo apt upgrade -y
```
这能确保你拥有最新的安全补丁和库文件，避免潜在的依赖冲突。

### 步骤 2：执行官方一键安装脚本
这是最简单、最不容易出错的方式。在 Ubuntu 终端中粘贴并运行：

```bash
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
```

> 🔍 **这个脚本会自动完成以下工作**：
> - 安装 `uv`（超快的 Python 包安装器和虚拟环境管理器）
> - 安装 Python 3.11+
> - 克隆 Hermes Agent 仓库到 `~/hermes-agent`
> - 创建并激活虚拟环境
> - 安装所有依赖（包括 `ripgrep`, `fd-find` 等高效工具）
> - 将 `hermes` 命令添加到你的 PATH

### 步骤 3：重载 Shell 并验证安装
安装完成后，为了让 `hermes` 命令生效，需要重载你的 Shell 配置：

```bash
# 对于 Bash 用户（Ubuntu 默认）
source ~/.bashrc

# 对于 Zsh 用户（如果你已切换）
source ~/.zshrc
```

然后，验证是否安装成功：
```bash
hermes --version
```
你应该能看到类似 `hermes 0.8.1` 的输出。

### 步骤 4：配置模型提供商
运行设置向导，连接你的大模型 API：
```bash
hermes setup
```

在交互式界面中：
1. **选择你的模型提供商**（如 OpenAI, Anthropic, OpenRouter, 或国内的大模型如 **MiniMax、阿里云百炼、智谱 GLM**）。
2. **输入对应的 API Key**。
3. **选择一个默认模型**（如 `gpt-4o`, `claude-3-5-sonnet-20241022`, `qwen-plus`）。

> 💡 **新手推荐**：使用 **OpenRouter** 作为统一入口，它聚合了数十家模型供应商，一个 Key 通吃所有模型，且价格透明。

配置完成后，你可以通过 `hermes` 命令直接与 Agent 对话，测试其基本功能，例如：
```bash
hermes "在桌面上创建一个名为 'test.txt' 的文件，内容为 'Hello Hermes!'"
```

> 💡 **避坑提示**：
> - **网络问题**：如果 `curl` 命令卡住或失败，很可能是网络问题。请确保你的 WSL2 能正常访问 GitHub。必要时可配置 Git 代理。
> - **权限问题**：不要在 WSL2 中使用 `sudo` 来运行 `hermes` 命令，这可能导致权限混乱。始终以普通用户身份运行。
> - **模型未识别**：如果提示模型不可用，请检查 `.env` 文件中的 `MODEL_PROVIDER` 和 `MODEL_NAME` 是否与提供商文档一致。

---

## 💬 第三部分：接入飞书机器人

Hermes Agent 通过其内置的 `gateway` 模块支持多平台消息接入。下面是如何将其连接到飞书。

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

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

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

### 步骤 4：在 WSL2 中配置 Hermes Gateway
回到你的 WSL2 Ubuntu 终端，运行 gateway 配置命令：
```bash
hermes gateway setup
```

在交互式向导中：
- **选择 `feishu`**。
- **输入你刚刚获取的 App ID 和 App Secret**。
- **User IDs**: 如果你想让所有用户都能使用，可以留空。如果只想给自己用，可以输入你的飞书用户ID（可在飞书个人资料中找到）。
- **Domain**: 保持默认 `feishu`（中国大陆）或 `lark`（国际版）。
- **Connection mode**: 选择 `websocket` (**强烈推荐**)。

> ✅ **关键优势**：WebSocket 模式由 Hermes 主动建立到飞书的长连接，**不需要你的电脑有公网 IP**，在家用网络下也能完美工作。

### 步骤 5：配置飞书事件订阅（关键！）
回到飞书开放平台：
1. 进入 “**事件与回调**”。
2. **订阅方式** 选择 “**长连接**”。
3. 在 “**需要订阅的事件**” 中，勾选 `im.message.receive_v1`。
4. **保存**。

### 步骤 6：在飞书中测试！
现在，打开你的飞书，搜索你创建的应用（或在群聊中添加它），向它发送一条消息，比如 “你好！” 或 “帮我查一下今天的天气”。

> 🎉 **成功标志**：如果一切顺利，你的 Hermes Agent 就会回复你，并可能调用浏览器、终端等工具来完成任务！

> 💡 **避坑提示**：
> - **公网 IP 问题**：飞书的长连接模式不需要你的服务器有公网 IP，Hermes Gateway 会主动建立到飞书的 WebSocket 连接，因此在家用网络下也能正常工作。
> - **防火墙**：确保你的 Windows 防火墙没有阻止 WSL2 的网络连接。通常默认规则即可。
> - **日志排查**：如果无响应，运行 `hermes gateway logs` 查看实时日志，错误信息会非常明确。

---

## 💎 总结

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

### 核心流程回顾：
1. **启用并安装 WSL2 (Ubuntu)**。
2. **在 WSL2 终端中运行官方一键安装脚本**。
3. **通过 `hermes setup` 配置模型 API**。
4. **在飞书开放平台创建应用并获取凭证**。
5. **通过 `hermes gateway setup` 完成飞书接入**。

现在，无论你是在 Windows 上办公，还是在飞书里沟通，你的 AI 分身都已就位，随时准备与你一同成长！它不仅能回答问题，更能 **执行任务、编写代码、管理文件、监控数据**——真正成为你不可或缺的 **数字员工**。

> 🚀 **下一步行动建议**：
> - 探索 `hermes skills` 命令，查看和管理 Agent 自主学习的技能。
> - 尝试为其添加定时任务（Cron Job），实现自动化运维。
> - 关注本专栏或作者个主页，获取最新插件和最佳实践！

谁说强大的 AI Agent 只能在 Linux 上运行？虽然 Hermes Agent 官方原生支持 Linux 和 macOS，但通过 Windows Subsystem for Linux (WSL2)，我们完全可以在 Windows 11/10 上获得丝滑、原生般的体验！

谁说 Hermes Agent 不能在 Windows 上跑？手把手教你用 WSL2 部署「类 Hermes」AI Agent 并接入飞书机器人！

人工智能

开发工具

操作系统

自动化运维

安全补丁

虚拟化

防火墙

服务器

Windows

Python

GitHub

Ubuntu

Linux

Agent

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

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

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯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编辑器全新改版上线，欢迎大家体验!

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

社区新版编辑器体验调研

谁说 Hermes Agent 不能在 Windows 上跑？手把手教你用 WSL2 部署「类 Hermes」AI Agent 并接入飞书机器人！-腾讯云开发者社区-腾讯云

谁说 Hermes Agent 不能在 Windows 上跑？手把手教你用 WSL2 部署「类 Hermes」AI Agent 并接入飞书机器人！

谁说 Hermes Agent 不能在 Windows 上跑？手把手教你用 WSL2 部署「类 Hermes」AI Agent 并接入飞书机器人！

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐