Hermes Agent 安装与飞书接入指南

1. Hermes Agent 简介

什么是 Hermes Agent

Hermes Agent 是由知名 AI 实验室 Nous Research 开发的一款开源、自托管的自主 AI 智能体框架。它的核心理念是打造一个"越用越聪明"的数字助手，能够深度集成到用户的日常工作流中。

核心优势

特性	特性描述	技术亮点
自进化	技能沉淀与迭代	任务完成后自动提取逻辑并沉淀为 Skill；支持对解法进行反思和自动迭代，实现"越用越聪明"。
安全性	全链路安全防护	采用沙箱隔离执行环境；敏感环境变量自动过滤；高危指令（如文件删除、系统更改）强制人工审批。
成本优化	智能 Token 管理	任务编排支持混合模型（简单任务用轻量模型）；内置 Context 自动压缩与 Prompt Caching，大幅降低长对话开销。
深度记忆	多模态记忆引擎	结合短期上下文 + 向量检索 (RAG) + 全文搜索 + 结构化 KV 存储，构建完整的用户画像与知识库。
高可用性	长程任务调度	基于 SQLite 的持久化设计，支持会话崩溃恢复；内置 Gateway 常驻进程与 Cron 定时任务，确保后台任务稳定运行。
可观测性	执行轨迹回溯	提供清晰的 Trace 记录，用户可实时查看推理链路与工具调用细节，支持不同粒度的日志展示。
生态接入	全渠道适配	适配 Telegram、飞书、Discord 等主流 IM；完美兼容 Ollama / LM Studio，支持从云端到本地的无缝切换。

2. 安装 & 基本使用

2.1 安装与配置

打开终端，执行以下命令：

下面是安装脚本，会有引导，执行时，只需要安装提示选择和操作：

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

向导会引导你逐一完成以下配置：

1、选择 LLM 服务商和模型（必须配置）

我使用的minimax，可以访问 minimax 官网：

https://platform.minimaxi.com

注册登录即可，可以先不实名：

4.2 申请订阅

可以访问下面链接订阅：

https://platform.minimaxi.com/subscribe/coding-plan?code=4BPRPWJ2Xz&source=link

4.3 保存 API-Key

订阅后，可以找到这里重新成功 Key（自行保存，平台不能二次查看）

2、配置工具集，可先跳过

3、配置消息网关（可选）：接入 Telegram、Discord、Slack、飞书等平4台（飞书接入应用申请流程见：3. 接入飞书）

4、网关配置

建议调整下终端为深色背景：

2.2 Hermes 常用命令

分类	常用命令	功能说明	备注
初始化	`hermes setup`	全局配置向导	首次运行必用，涵盖模型、存储、工具全套设置
模型管理	`hermes model`	切换/配置 LLM	关联 Ollama、LM Studio 或 OpenAI 等 API 地址
技能管理	`hermes tools`	工具/插件管理	开启或禁用内置工具（如浏览器、终端执行、文件）
交互测试	`hermes chat`	进入对话模式	在终端直接与 Agent 对话，测试记忆与工具调用
网关/常驻	`hermes gateway setup`	配置消息网关	设置 Telegram、飞书、Slack 等 IM 的 Webhook
	`hermes gateway start`	启动网关服务	让 Agent 在后台上线，接收外部即时消息
系统维护	`hermes status`	查看运行状态	检查当前激活的模型、工具以及网关连接情况
	`hermes clear`	清理数据/缓存	重置会话记忆或清除过期的临时文件
	`hermes --version`	查看版本	确认当前 CLI 版本，方便排查兼容性问题

3. 接入飞书

3.1 打开飞书开放平台（open.feishu.cn/app）

3.2 创建 企业自建应用

3.3 记录 App ID、App Secret

3.4 添加应用能力，找到机器人，添加

3.5 添加权限，通过导入：

  {  "scopes":{    "tenant":[      "aily:file:write",      "application:application.app_message_stats.overview:readonly",      "application:application:self_manage",      "application:bot.menu:write",      "cardkit:card:write",      "contact:user.employee_id:readonly",      "docs:document.content:read",      "event:ip_list",      "im:chat.access_event.bot_p2p_chat:read",      "im:chat.members:bot_access",      "im:message",      "im:message.group_at_msg:readonly",      "im:message.group_msg",      "im:message.p2p_msg:readonly",      "im:message:readonly",      "im:message:send_as_bot",      "im:resource",      "wiki:wiki:readonly"    ],    "user":[      "aily:file:write",      "im:chat.access_event.bot_p2p_chat:read"    ]  }}

3.6 事件与回调配置，找到事件配置-订阅方式-选长链接-保存

3.7 保存后，点击点击事件，选择接收消息-添加

3.8 发布版本

4. 飞书验证

4.1 飞书和 Hermes 配对

找到自己的机器人，随便发一条消息
在 Hermes Agent 的终端，执行配对命令

hermes pairing approve feishu <配对码>

显示 Approved 即为配对成功，然后就可以直接和机器人对话了。

总结

Hermes Agent 的核心价值在于自进化——它不会只做机械的重复，而是会在每次任务中学习最优解法，逐渐成为真正懂你业务逻辑的数字员工。

接入飞书后，你的团队将拥有一个：

24 小时在线的智能助手
自动处理飞书消息的自动化中枢
越用越聪明的 AI 同事

如果你对 Hermes Agent 的更多玩法感兴趣，建议进一步了解：

官方文档
GitHub 仓库
Skill 自进化机制