手把手带你在 Windows 安装 Hermess Agent，并接入飞书 [喂饭级教程含踩坑经验]

星浩AI
0 阅读2分钟

最近，Hermes Agent 的自动进化机制非常火，接下来，我将手把手带你在 Windows 安装 Hermess Agent，并接入飞书。

一、它是什么？

Hermes Agent 是由 Nous Research 开发的自学习型 AI 智能体，内置学习循环的智能体——它能从经验中积累技能，在使用过程中不断改进，持续学习并巩固知识，在不同会话中逐步构建更深入的自我认知模型。

简单来说：用得越久，它就越懂你、越能打。比 Openclaw 更强大！。

开源一个多月，它已经：

  • 🏆 斩获 86.4k Stars（GitHub 热榜常客）
  • 📦 成为 GitHub 最受欢迎的 Agent 项目之一

二、核心功能一览

功能说明
全平台接入CLI、Telegram、Discord、Slack、WhatsApp、Email
多模型支持OpenRouter(200+)、OpenAI、Anthropic、国产GLM/Kimi/MiniMax
技能自进化复杂任务后自动创建技能，越用越强
跨会话记忆FTS5 语义检索，记住所有历史对话
内置调度器Cron 定时任务（报告、备份、审计）
并行子Agent多个独立工作流同时执行
47个内置工具搜索、浏览、视觉、图片生成、TTS

三、一键安装

官方文档中说明：Hermes 不支持原生 Windows 系统，需要预先安装 WSL2。今天我们介绍的另外一种安装方式。

开始安装

打开 PowerShell（以管理员身份运行），执行以下命令：

irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

安装过程中，会自动检测并安装 Python、Node.js、Git、ripgrep 等所有依赖，如果安装失败，可以把梯子打开。

1.png

检查 hermes 版本

hermes --version

2.png

特别说明

一键安装命令自动检测并安装Python、Node、Git、ripgrep。

我本地已经安装了Conda来管理Python环境，Nvm来管理Node环境、Git环境、rg环境。

为了不与本地安装环境冲突，安装前进行了以下配置：

  • Python 环境
# 安装 Python 虚拟环境
conda create -n hermes-env python=3.11 -y

conda activate hermes-env

conda env list

# 设置 HERMES_PYTHON_PATH 
$env:HERMES_PYTHON_PATH="F:\conda3_python\envs\hermes-env\python.exe"
  • Node 环境
nvm install 22.22.0
nvm use 22.22.0

四、快速配置

开始配置

安装完成后会自动进行初始化配置界面

3.png

如果你本地安装了OpenClaw，也能帮你一键导入

3.1.png

当然你也可以命令进行配置,打开 Windows PowerShell

    hermes setup

4.png

输入 1，进行 Quick setup 快速配置。（若出现乱码，请见文章末尾）

配置大模型

5.png

我选择 17 ，使用Minimax。

6.png

配置大模型API KEY、Base URL，并选择模型 Minimax-M2.7。

配置消息平台

跳过消息平台配置，后面再配置

7.png

配置完成

8.png

Launch hermes chat now ? 选择Y。

启动

成功启动hermes chat，看到下面的欢迎界面，恭喜你安装成功了。

9.png

测试

测试是否能够正常对话

10.png

五、常见命令

1. 首次配置引导

hermes setup

按提示填写 API Key、选择模型、配置工具权限即可。

2. 基础命令一览

命令说明
hermes启动交互式CLI
hermes model切换模型
hermes tools配置启用的工具
hermes config set修改配置项
hermes gateway启动消息网关（接入Telegram等）

3. 配置快捷键

在对话中可用斜杠命令（/ask、/search、/code），支持多行编辑、流式输出。

六、配置飞书

在飞书开放平台上创建一个“企业自建应用”，并给它添加机器人能力，让它可以收发消息。

详见我之前为 Openclaw 配置飞书的文章：《手把手教你安装 OpenClaw 并接入飞书，让本地 AI 在飞书里听你指挥》：mp.weixin.qq.com/s/-_d5ESeMg…。

通过 hermes gateway 配置飞书，步骤如下：

hermes gateway setup

11.png

在渠道列表中选择 11,飞书。

12.png

填入飞书应用的 App ID 和 App Secret。来源选 feishu (国内版,lark是海外版)

13.png

连接方式: 默认选择 websocket。 谁有资格给你的 Hermes 发送私信（DM）？ : 我选择：Use DM pairing approval (recommended) —— 配对验证模式

13.png

Hermes 在群聊里应该怎么表现？ 我选择Respond only when @mentioned in groups。

    Home chat ID (optional, for cron/notifications):

要把定时任务报告或系统通知，发给哪个聊天窗口？ 直接回车跳过。

15.png

配置完成确认，选择 Done 保存。

七、启动网关

运行 hermes gateway命令，启动网关。

    hermes gateway 
    # -v INFO(含轻微DEBUG) -vv 包含 INFO 的所有内容 + 内部细节
    hermes gateway run --vv

16.png

根据上图，我们发现启动网关报错了，根据错误日志，我们发现飞书的lark-oapi没有正确安装。

Hermes Gateway 运行在 hermes-agent/venv 虚拟环境中,因此，需要将飞书的lark-oapi安装到 hermes-agent/venv虚拟环境中。

确认安装路径并安装

    # 获取安装路径
    Get-Command hermes | Select-Object -ExpandProperty Source

    # 用 uv 将 lark-oapi 安装进 venv
    uv pip install lark-oapi --python "C:\Users\DELL\AppData\Local\hermes\hermes-agent\venv\Scripts\python.exe"

17.png

再次启动网关

成功启动。

18.png

启动报错解决办法

在启动时，若报OSError: WinError 11 错误：

18.1.png

修复方案 在 PowerShell 中运行以下 patch 命令：

python -c "
path = r'C:\Users\DELL\AppData\Local\hermes\hermes-agent\gateway\status.py'
with open(path, 'r', encoding='utf-8') as f:
    content = f.read()
content = content.replace(
    'except (ProcessLookupError, PermissionError):',
    'except (ProcessLookupError, PermissionError, OSError):'
)
with open(path, 'w', encoding='utf-8') as f:
    f.write(content)
print('Done')
"

18.2.png

验证 patch 是否生效：

python -c "
path = r'C:\Users\DELL\AppData\Local\hermes\hermes-agent\gateway\status.py'
with open(path, encoding='utf-8') as f:
    for i, line in enumerate(f, 1):
        if 'OSError' in line:
            print(f'Line {i}: {line.rstrip()}')
"

18.3.png

再次执行hermes gateway,启动成功。

八、飞书下发指令

配对码

飞书向机器人发消息，会获取到配对码。

19.png

执行以下指令，配对成功：

hermes pairing approve feishu XNC5SCJM

20.png

飞书成功接收到消息

ok.png

飞书对接成功，可以通过飞书向Hermes Agent下发任务了。

九、对接国产大模型（GLM / Kimi / MiniMax）

Hermes Agent 支持 OpenAI 兼容格式，国产模型只需配置 API 地址和 Key 即可使用。

1. 配置 GLM（智谱AI）

hermes config set OPENAI_BASE_URL https://open.bigmodel.cn/api/paas/v4/
hermes config set OPENAI_API_KEY your_glm_api_key_here

然后运行 hermes model 选择 GLM 对应的模型名称即可。

2. 配置 Kimi（Moonshot）

hermes config set OPENAI_BASE_URL https://api.moonshot.cn/v1/
hermes config set OPENAI_API_KEY your_kimi_api_key_here

3. 配置 MiniMax

hermes config set OPENAI_BASE_URL https://api.minimax.chat/v1/
hermes config set OPENAI_API_KEY your_minimax_api_key_here

4. 验证是否生效

hermes model

在模型列表中选择你刚配置的国产模型，输入一句对话测试是否正常响应。

提示：国产模型 API Key 可前往对应官网申请（智谱AI、Moonshot、 MiniMax），均有免费额度。

十、常见问题

hermes setup 出现乱码问题？

23.png

上图中，[35m 是设置紫色，[0m 是重置颜色。窗口没有正确识别并渲染这些颜色，而是直接把控制颜色的“代码”显示出来了。

访问 terminal 的官方 GitHub 发布页面：github.com/microsoft/t… 进行下载安装。

下载地址：github.com/microsoft/t…

飞书接收不到消息？

新版本不再有下面的问题，但在老版本中会出现：在飞书中发送消息，Hermes Agent 日志中显示接收到消息

21.png

hermes Agent也给了回复，飞书中死活收不到消息。

22.png

如果你飞书上权限管理-开通的权限、事件与回调-事件配置没问题的话。

需要检查 config.xml 是否有 feishu 配置是否存在，配置是否正确，修改脚本如下：

  • Policy Gate 将 Policy 改为 open：
    Add-Content "$env:LOCALAPPDATA\hermes\.env" "`nFEISHU_GROUP_POLICY=open" -Encoding UTF8
  • Mention Gate 修正 config.xml 中错误的配置：
(Get-Content "$env:LOCALAPPDATA\hermes\config.yaml" -Raw -Encoding UTF8) `
  -replace "feishu:\r?\n  require_mention: false", "feishu:`n  default_group_policy: open" |
  Set-Content "$env:LOCALAPPDATA\hermes\config.yaml" -Encoding UTF8 -NoNewline

24.png

十一、总结

Hermes Agent 最大的差异化在于闭环学习：

  • 普通 Agent = 执行命令
  • Hermes = 执行 + 总结 + 创建技能 + 持续优化

Hermes Agent竟是整套抄袭中国团队 EvoMap 的开源引擎 Evolver，10 步主循环一模一样，术语全换了但架构纹丝不动。

项目地址：github.com/NousResearc…

文档：hermes-agent.nousresearch.com/docs

avatar
文章
阅读
粉丝