先说一个核心判断：Hermes Agent 确实值得试一试。

最近这段时间，开源Agent圈子里Hermes Agent的出现频率相当高，有人开玩笑叫它"爱马仕 Agent"。说实话，一开始我也以为它不过是又一个AI CLI工具——这类项目太多了，难免审美疲劳。但实际部署体验一周下来，它和普通Agent之间的差距是肉眼可见的：它不只是在机械地"完成指令"，而是在每一次交互中沉淀经验，形成一套自我优化的学习闭环。用得越久，它就越顺手。

这篇文章会把我从零开始部署Hermes Agent并接入飞书的完整过程做一个系统性梳理，尽量把容易踩的坑提前标注出来，希望能帮到想入手的同学。

一、Hermes Agent 是什么

简单说，Hermes Agent是AI研究机构 Nous Research 开发的开源自适应AI智能体框架，采用MIT开源协议，这意味着上手门槛基本为零。它的核心定位是什么？——一个运行在你自己的服务器上、越用越聪明的AI Agent。

和市面上常见的AI Agent相比，它最大的区别在于内置了一套闭环学习机制：

• 记住跨会话上下文：借助FTS5全文搜索与LLM摘要，它可以追溯到数周前的对话细节，而不是"聊完就忘"。
• 自主沉淀技能文档：完成复杂度较高的任务后，它会自动把经验提炼成可复用的Skill文件，形成结构化知识。
• 持续自我改进：这些技能在实际使用中会持续优化，越用越好用，根本不需要你手动去微调或写提示词。

这套体系意味着什么呢？Hermes不只是"执行"，它能在实践中反思、学习和进化。不是你给它什么它就做什么，而是做完之后还会自己总结规律。

另外一点值得提：Hermes支持400+模型调用（包括OpenAI、Claude、Ollama本地模型、Kimi等），并通过Telegram、Discord、飞书等多个消息平台与用户交互，可以在服务器上7×24小时自主运行。

二、安装前的环境准备

在动手之前，先确认一下环境是否满足要求：

• 操作系统：Linux（主流发行版）、macOS、Windows WSL2、Android Termux 都可以。
• Python：3.10+（这一步不用担心，安装脚本会自动处理）。
• Git：需要提前装好。
• 内存：建议4GB起步；如果打算本地跑7B+模型，建议16GB以上。
• 网络：需要正常访问GitHub，因为安装脚本从仓库拉取依赖。

Windows原生环境是不支持的，一定要先启用WSL2。在管理员PowerShell中执行 wsl --install 就能完成。

三、一行命令完成安装

环境就绪后就能装了。老实讲，Hermes的安装方式是截至目前我见过开源Agent里最直接的那一档——一条命令行，搞定。

打开终端（Windows用户在WSL2的Ubuntu终端中运行），执行：

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

这条命令会自动检测并安装所有必备依赖：uv（Python包管理）、Python 3.10+、Node.js、ripgrep、ffmpeg 等，完全不需要手动一个一个装。

脚本跑完之后，如果终端里出现 "Starting setup wizard" 的提示，那恭喜你——安装已经成功了。

四、按照向导完成初始配置

安装成功后，会自动进入交互式初始配置向导。这一步会决定Hermes的"大脑"用哪个模型，以及之后在哪些平台上使用。

4.1 选择配置模式

向导会给出两个选项：

• Quick setup：适合新手，按流程一步步来就行。
• Advanced setup：适合有经验的老手，想细化配置的可以选这个。

新手直接选Quick setup，完全够用。

4.2 配置模型供应商

这一步根据你的情况来选：

• 有OpenAI / Anthropic / Kimi等API Key：在provider列表里直接选对应的服务商，填入API Key和Model Name就行。
• 用Ollama跑本地模型：选择Ollama provider，确认本地服务地址（通常为http://localhost:11434）。
• 使用自定义API端点（比如火山方舟、阿里云百炼）：选择 "Custom endpoint (enter URL manually)"，然后手动填写API Base URL和Key。

4.3 消息平台选择（建议先跳过）

需要注意的是，向导的消息平台列表中可能没有飞书选项，这属于正常情况。建议在这个环节直接选择Skip，飞书的接入我们后面通过 hermes gateway setup 单独来做。

4.4 验证安装

配置完成后，在终端输入：

hermes

这会进入交互式CLI界面。随便输入一句话，如果能正常收到响应，就说明安装和模型配置已经OK了。

五、飞书接入完整流程

安装配置没问题之后，接下来就是重点——飞书对接。

整个飞书接入分为两大步：飞书开放平台侧配置（获取App ID、App Secret、配置回调）和 Hermes侧配置（Gateway设置）。下面一步步来。

5.1 飞书开放平台侧配置

第一步：创建企业自建应用

登录飞书开放平台，进入开发者后台，点击 「创建企业自建应用」，输入应用名称和应用描述后点创建。
应用名称会对应之后用户在飞书上搜到的机器人名——建议取一个好记的名字，方便后面识别。

第二步：添加机器人能力

在应用详情页左侧，找到 「添加应用能力」，勾选 「机器人」 能力添加。

第三步：配置必要权限

左侧导航栏进入 「权限管理」，至少需要添加以下两项：

• im:message — 获取与发送消息的核心权限
• im:resource — 获取消息中的资源文件

如果想让机器人在群聊中也稳定工作，建议再补上 im:chat:readonly 和 admin:app.info:readonly。

第四步：获取App ID和App Secret

左侧导航栏进入 「凭证与基础信息」，找到 App ID 和 App Secret。这两个信息先保存好，稍后Hermes侧配置会用到。

第五步：配置事件订阅

左侧导航栏进入 「事件与回调」，在订阅方式里选择 「长连接」，然后添加事件 im.message.receive_v1。
这样设置之后，每当飞书用户给机器人发消息时，Hermes就能第一时间收到回调事件。

第六步：发布应用

完成以上配置后，在左侧导航栏进入 「版本管理与发布」，创建一个新版本并提交发布。审核通过后，在飞书内就能搜到并开始使用了。

5.2 Hermes 侧配置

飞书侧的准备工作完成后，回到Hermes的终端环境：

第一步：启动Gateway配置向导

hermes gateway setup

在出现的渠道列表中选 飞书 (Feishu)，然后按提示依次填入以下信息：

• App ID：上面从飞书后台拿到的。
• App Secret：上面从飞书后台拿到的。
• Domain：国内版直接填 feishu 就行。
• Connection Mode：建议选 websocket（默认就是它）。
• 访问控制：鉴权环节选 "1—不限制对话人"，这样群里所有人都能与机器人互动。

配置无误的话，选择 Done 保存，所有配置会自动写入 ~/.hermes/.env 文件。

第二步：启动Gateway

hermes gateway start

此时Gateway会在后台持续监控飞书消息，并路由到Hermes的AI核心处理。

5.3 验证接入

Gateway启动后，打开飞书客户端，在搜索栏搜索你之前创建的机器人，发送一条消息（比如简单的"你好"）。
如果能正常收到回复，那就恭喜了——飞书与Hermes的接入已经全部搞定。

六、常见问题与排障

实际部署中确实会遇到一些典型问题，这里归纳几个高频的解决思路。

Q1：安装脚本执行失败，提示curl命令不存在？

运行 sudo apt update && sudo apt install -y curl git，先把curl和git装上，再重新执行安装脚本。

Q2：飞书机器人不响应消息？

首先检查 hermes gateway start 是否正在运行。然后去飞书开放平台后台确认两件事：「事件与回调」 里订阅方式是否为长连接，以及 im.message.receive_v1 事件是否已添加。最后还要看飞书应用的审核和发布状态——未发布的应用，机器人不会对消息做出响应。

Q3：Windows下安装报错？

Hermes Agent不支持原生Windows环境，请确认已经安装并启用WSL2。

Q4：Hermes Gateway启动时报App ID或App Secret无效？

回去在飞书开放平台的「凭证与基础信息」页面仔细检查一遍，看看是否漏填或者粘贴时多了空格。

七、总结

到这里，整个部署到飞书接入的完整流程就算梳理完毕了。

和很多开源Agent框架相比，Hermes Agent的安装体验明显更顺畅——一条命令安装、交互式向导配置、Gateway无缝对接飞书，整个过程几乎没有多余的弯弯绕绕。更重要的是，它这套"越用越聪明"的自我学习机制，确实让Agent从一个"执行工具"变成了一个会"成长"的助手。

当然，Hermes目前也有需要改进的地方：Gateway占用的内存不算少，低配机器上长期跑需要留意资源；飞书侧的权限配置对新手来说仍有门槛。但这些问题并不妨碍它成为目前最值得尝试的开源AI Agent之一。

《夸克》非常好用的免费AI浏览器

下载APP查看