WSL2 安装教程：Windows 上运行 Hermes Agent 的终极指南

本文详细介绍了如何在 Windows 系统上安装并配置 WSL2 环境，以便运行 Hermes Agent。文章首先强调了 WSL2 是运行 Hermes Agent 的唯一可靠方式，因为它提供了完整的 Linux 环境支持。接着，逐步指导读者如何启用 WSL2 功能、设置默认版本、安装 Linux 发行版（推荐 Ubuntu），并初始化 Ubuntu。此外，还提供了针对中国大陆用户的网络问题解决方案。随后，文章详细阐述了在 WSL2 中安装 Hermes Agent 的步骤，包括更新系统包、使用官方一键安装脚本、重载 Shell 配置和验证安装。最后，介绍了如何配置模型提供商，并详细说明了如何将 Hermes Agent 接入飞书机器人，包括在飞书开放平台创建应用、配置应用权限、获取凭证、配置 Hermes Gateway 以及设置飞书事件订阅。通过这些步骤，读者可以在 Windows 上顺利运行 Hermes Agent 并与飞书机器人进行交互。

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

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

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

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

步骤 1：启用 WSL 功能

以 管理员身份 打开 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（普通用户即可），运行：

wsl --set-default-version2

步骤 3：安装 Linux 发行版（推荐 Ubuntu）

打开 Microsoft Store (微软应用商店)。

搜索 “Ubuntu”。

选择 “Ubuntu 22.04 LTS” (或最新 LTS 版本)，点击 “获取” 进行安装。

步骤 4：初始化 Ubuntu

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

💡 避坑提示：如果你在中国大陆，可能会遇到网络问题导致安装缓慢或失败。可以尝试在 PowerShell 中使用 wsl --install -d Ubuntu-22.04 --web-download 命令，并配合系统代理（如果有的话）。

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

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

步骤 1：更新系统包（可选但推荐）

sudo apt update && sudo apt upgrade -y

步骤 2：执行官方一键安装脚本

这是最简单、最不容易出错的方式。在 Ubuntu 终端中粘贴并运行：

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

这个脚本会自动完成以下工作：

• 安装uv(超快的 Python 包安装器和虚拟环境管理器)
• 安装 Python 3.11+
• 克隆 Hermes Agent 仓库
• 创建并激活虚拟环境
• 安装所有依赖
• 将hermes命令添加到你的 PATH

步骤 3：重载 Shell 并验证安装

安装完成后，为了让hermes命令生效，需要重载你的 Shell 配置：

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

然后，验证是否安装成功：hermes --version

你应该能看到类似 hermes x.x.x 的输出。

步骤 4：配置模型提供商

运行设置向导，连接你的大模型 API：

hermes setup

在交互式界面中：

1. 选择你的模型提供商（如 OpenAI, Anthropic, OpenRouter, 或国内的大模型）。
2. 输入对应的API Key。
3. 选择一个默认模型（如gpt-4o,claude-3-5-sonnet-20241022）。

配置完成后，你可以通过hermes命令直接与 Agent 对话，测试其基本功能。

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

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

步骤 1：在飞书开放平台创建应用

1. 访问 飞书开放平台。
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 配置命令：

hermes gateway setup

在交互式向导中：

1. 选择feishu。
2. 输入你刚刚获取的App ID和App Secret。
3. User IDs: 如果你想让所有用户都能使用，可以留空。如果只想给自己用，可以输入你的飞书用户ID（可在飞书个人资料中找到）。
4. Domain: 保持默认feishu。
5. Connection mode: 选择websocket(推荐)。

步骤 5：配置飞书事件订阅（关键！）

回到飞书开放平台：

1. 进入“事件与回调”。
2. 订阅方式选择“长连接”。
3. 在“需要订阅的事件”中，勾选im.message.receive_v1。
4. 保存。

步骤 6：在飞书中测试！

现在，打开你的飞书，搜索你创建的应用（或在群聊中添加它），向它发送一条消息，比如 “你好！”。如果一切顺利，你的 Hermes Agent 就会回复你了！

最后

对于正在迷茫择业、想转行提升，或是刚入门的程序员、编程小白来说，有一个问题几乎人人都在问：未来10年，什么领域的职业发展潜力最大？

答案只有一个：人工智能（尤其是大模型方向）

当下，人工智能行业正处于爆发式增长期，其中大模型相关岗位更是供不应求，薪资待遇直接拉满——字节跳动作为AI领域的头部玩家，给硕士毕业的优质AI人才（含大模型相关方向）开出的月基础工资高达5万—6万元；即便是非“人才计划”的普通应聘者，月基础工资也能稳定在4万元左右。

再看阿里、腾讯两大互联网大厂，非“人才计划”的AI相关岗位应聘者，月基础工资也约有3万元，远超其他行业同资历岗位的薪资水平，对于程序员、小白来说，无疑是绝佳的转型和提升赛道。

如果你还不知道从何开始，我自己整理一套全网最全最细的大模型零基础教程，我也是一路自学走过来的，很清楚小白前期学习的痛楚，你要是没有方向还没有好的资源，根本学不到东西！

下面是我整理的大模型学习资源，希望能帮到你。

👇👇扫码免费领取全部内容👇👇

最后

1、大模型学习路线

2、从0到进阶大模型学习视频教程

从入门到进阶这里都有，跟着老师学习事半功倍。

3、 入门必看大模型学习书籍&文档.pdf（书面上的技术书籍确实太多了，这些是我精选出来的，还有很多不在图里）

4、AI大模型最新行业报告

2026最新行业报告，针对不同行业的现状、趋势、问题、机会等进行系统地调研和评估，以了解哪些行业更适合引入大模型的技术和应用，以及在哪些方面可以发挥大模型的优势。

5、面试试题/经验

【大厂 AI 岗位面经分享（107 道）】

【AI 大模型面试真题（102 道）】

【LLMs 面试真题（97 道）】

6、大模型项目实战&配套源码

适用人群

四阶段学习规划（共90天，可落地执行）

第一阶段（10天）：初阶应用

该阶段让大家对大模型 AI有一个最前沿的认识，对大模型 AI 的理解超过 95% 的人，可以在相关讨论时发表高级、不跟风、又接地气的见解，别人只会和 AI 聊天，而你能调教 AI，并能用代码将大模型和业务衔接。

• 大模型 AI 能干什么？
• 大模型是怎样获得「智能」的？
• 用好 AI 的核心心法
• 大模型应用业务架构
• 大模型应用技术架构
• 代码示例：向 GPT-3.5 灌入新知识
• 提示工程的意义和核心思想
• Prompt 典型构成
• 指令调优方法论
• 思维链和思维树
• Prompt 攻击和防范
• …

第二阶段（30天）：高阶应用

该阶段我们正式进入大模型 AI 进阶实战学习，学会构造私有知识库，扩展 AI 的能力。快速开发一个完整的基于 agent 对话机器人。掌握功能最强的大模型开发框架，抓住最新的技术进展，适合 Python 和 JavaScript 程序员。

• 为什么要做 RAG
• 搭建一个简单的 ChatPDF
• 检索的基础概念
• 什么是向量表示（Embeddings）
• 向量数据库与向量检索
• 基于向量检索的 RAG
• 搭建 RAG 系统的扩展知识
• 混合检索与 RAG-Fusion 简介
• 向量模型本地部署
• …

第三阶段（30天）：模型训练

恭喜你，如果学到这里，你基本可以找到一份大模型 AI相关的工作，自己也能训练 GPT 了！通过微调，训练自己的垂直大模型，能独立训练开源多模态大模型，掌握更多技术方案。

到此为止，大概2个月的时间。你已经成为了一名“AI小子”。那么你还想往下探索吗？

• 为什么要做 RAG
• 什么是模型
• 什么是模型训练
• 求解器 & 损失函数简介
• 小实验2：手写一个简单的神经网络并训练它
• 什么是训练/预训练/微调/轻量化微调
• Transformer结构简介
• 轻量化微调
• 实验数据集的构建
• …

第四阶段（20天）：商业闭环

对全球大模型从性能、吞吐量、成本等方面有一定的认知，可以在云端和本地等多种环境下部署大模型，找到适合自己的项目/创业方向，做一名被 AI 武装的产品经理。

• 硬件选型

• 带你了解全球大模型

• 使用国产大模型服务

• 搭建 OpenAI 代理

• 热身：基于阿里云 PAI 部署 Stable Diffusion

• 在本地计算机运行大模型

• 大模型的私有化部署

• 基于 vLLM 部署大模型

• 案例：如何优雅地在阿里云私有部署开源大模型

• 部署一套开源 LLM 项目

• 内容安全

• 互联网信息服务算法备案

• …

  👇👇扫码免费领取全部内容👇👇

3、这些资料真的有用吗？

这份资料由我和鲁为民博士(北京清华大学学士和美国加州理工学院博士)共同整理，现任上海殷泊信息科技CEO，其创立的MoPaaS云平台获Forrester全球’强劲表现者’认证，服务航天科工、国家电网等1000+企业，以第一作者在IEEE Transactions发表论文50+篇，获NASA JPL火星探测系统强化学习专利等35项中美专利。本套AI大模型课程由清华大学-加州理工双料博士、吴文俊人工智能奖得主鲁为民教授领衔研发。

资料内容涵盖了从入门到进阶的各类视频教程和实战项目，无论你是小白还是有些技术基础的技术人员，这份资料都绝对能帮助你提升薪资待遇，转行大模型岗位。

这份完整版的大模型 AI 学习资料已经上传CSDN，朋友们如果需要可以微信扫描下方CSDN官方认证二维码免费领取【保证100%免费】