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

最近，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（以管理员身份运行），执行以下命令：

powershell 复制代码

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

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

检查 hermes 版本

powershell 复制代码

hermes --version

特别说明

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

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

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

Python 环境

powershell 复制代码

# 安装 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 环境

bash 复制代码

nvm install 22.22.0
nvm use 22.22.0

四、快速配置

开始配置

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

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

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

bash 复制代码

    hermes setup

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

配置大模型

我选择 17 ，使用Minimax。

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

配置消息平台

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

配置完成

Launch hermes chat now ? 选择Y。

启动

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

测试

测试是否能够正常对话

五、常见命令

1. 首次配置引导

bash 复制代码

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 配置飞书，步骤如下：

powershell 复制代码

hermes gateway setup

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

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

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

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

text 复制代码

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

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

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

七、启动网关

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

powershell 复制代码

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

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

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

确认安装路径并安装

powershell 复制代码

    # 获取安装路径
    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"

再次启动网关

成功启动。

启动报错解决办法

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

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

powershell 复制代码

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')
"

验证 patch 是否生效：

powershell 复制代码

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()}')
"

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

八、飞书下发指令

配对码

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

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

powershell 复制代码

hermes pairing approve feishu XNC5SCJM

飞书成功接收到消息

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

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

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

1. 配置 GLM（智谱AI）

bash 复制代码

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）

bash 复制代码

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

3. 配置 MiniMax

bash 复制代码

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

4. 验证是否生效

bash 复制代码

hermes model

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

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

十、常见问题

hermes setup 出现乱码问题？

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

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

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

飞书接收不到消息？

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

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

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

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

Policy Gate 将 Policy 改为 open：

powershell 复制代码

    Add-Content "$env:LOCALAPPDATA\hermes\.env" "`nFEISHU_GROUP_POLICY=open" -Encoding UTF8

Mention Gate 修正 config.xml 中错误的配置：

powershell 复制代码

(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

十一、总结

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

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

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

项目地址 ：github.com/NousResearc...

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