Hermes Agent的本地部署并接入飞书的完整攻略

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

最近这段时间，开源Agent圈子里Hermes Agent的出现频率相当高，有人开玩笑叫它"爱马仕 Agent"。说实话，一开始我也以为它不过是又一个AI CLI工具——这类项目太多了，难免审美疲劳。但实际部署体验一周下来，它和普通Agent之间的差距是肉眼可见的：它不只是在机械地"完成指令"，而是在

，形成一套自我优化的学习闭环。用得越久，它就越顺手。

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

一、Hermes Agent 是什么

简单说，Hermes Agent是AI研究机构

开发的开源自适应AI智能体框架，采用MIT开源协议，这意味着上手门槛基本为零。它的核心定位是什么？——。

和市面上常见的AI Agent相比，它最大的区别在于内置了一套

：

• 记住跨会话上下文
  ：借助FTS5全文搜索与LLM摘要，它可以追溯到数周前的对话细节，而不是"聊完就忘"。

• 自主沉淀技能文档
  ：完成复杂度较高的任务后，它会自动把经验提炼成可复用的Skill文件，形成结构化知识。

• 持续自我改进
  ：这些技能在实际使用中会持续优化，越用越好用，根本不需要你手动去微调或写提示词。

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

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

自主运行。

二、安装前的环境准备

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

• 操作系统
  ：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 等，完全不需要手动一个一个装。

脚本跑完之后，如果终端里出现

的提示，那恭喜你——安装已经成功了。

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

安装成功后，会自动进入交互式初始配置向导。这一步会决定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、配置回调）和 （Gateway设置）。下面一步步来。

5.1 飞书开放平台侧配置

登录飞书开放平台，进入开发者后台，点击

，输入应用名称和应用描述后点创建。
应用名称会对应之后用户在飞书上搜到的机器人名——建议取一个好记的名字，方便后面识别。

在应用详情页左侧，找到

，勾选 能力添加。

左侧导航栏进入

，至少需要添加以下两项：

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

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

左侧导航栏进入

，找到 和 。这两个信息先保存好，稍后Hermes侧配置会用到。

左侧导航栏进入

，在订阅方式里选择 ，然后添加事件 im.message.receive_v1。
这样设置之后，每当飞书用户给机器人发消息时，Hermes就能第一时间收到回调事件。

完成以上配置后，在左侧导航栏进入

，创建一个新版本并提交发布。审核通过后，在飞书内就能搜到并开始使用了。

5.2 Hermes 侧配置

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

hermes gateway setup

在出现的渠道列表中选

，然后按提示依次填入以下信息：

• App ID
  ：上面从飞书后台拿到的。

• App Secret
  ：上面从飞书后台拿到的。

• Domain
  ：国内版直接填 feishu 就行。

• Connection Mode
  ：建议选 websocket（默认就是它）。

• 访问控制
  ：鉴权环节选 "1—不限制对话人"，这样群里所有人都能与机器人互动。

配置无误的话，选择

保存，所有配置会自动写入 ~/.hermes/.env 文件。

hermes gateway start

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

5.3 验证接入

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

。

六、常见问题与排障

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

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

首先检查 hermes gateway start 是否正在运行。然后去飞书开放平台后台确认两件事：

里订阅方式是否为长连接，以及 im.message.receive_v1 事件是否已添加。最后还要看飞书应用的审核和发布状态——。

Hermes Agent

，请确认已经安装并启用WSL2。

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

七、总结

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

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

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