hermes agent 接入飞书 hermes agent企业微信全流程指南

在 2026 年，一个真正优秀的 AI Agent 不应被局限于单一平台。Hermes Agent 凭借其内置的 统一消息网关(UnifiedGateway)，让你只需部署一次，就能同时在 飞书、企业微信、钉钉 等多个主流办公 IM 中拥有同一个、具备持久记忆和自我进化能力的 AI 助手。

前置条件

一台云服务器：已成功部署 Hermes Agent。

一个可用的大模型 API Key：如 OpenAI, Claude, 或国内大模型。

对应平台的管理员权限：用于创建自建应用。

📦 核心原理：Hermes Gateway

Hermes Agent 的强大之处在于其 gateway 模块。它像一个智能路由器，负责：

接收来自不同平台(飞书、企微、钉钉等)的消息。

路由给核心的 Hermes Agent 进行处理。

发送Agent 的回复回对应的平台。

我们通过 hermes gateway setup 命令来配置这个网关。

🚀 第一部分：接入飞书 (Feishu)

步骤 1：在飞书开放平台创建应用

访问 飞书开放平台。

点击 “创建企业自建应用”。

填写应用名称(如 My Hermes Agent)和描述，点击 “创建”。

步骤 2：配置应用权限

在应用详情页，进入 “应用功能” -> “机器人”，确保已启用。

进入 “权限管理”。

在 “申请权限” 中，添加以下关键权限(根据你的需求可增减)：

im:message:send_as_bot (以机器人身份发消息)

im:message:read (读取消息)

contact:user:readonly (读取用户信息)

保存并 “发布” 权限变更。

步骤 3：获取凭证

在 “凭证与基础信息” 页面，记下：

App ID

App Secret

步骤 4：配置 Hermes Gateway

在你的服务器上，执行命令：

代码语言：Bash

自动换行

AI代码解释

hermes gateway setup

在交互式向导中：

选择 feishu。

输入你刚刚获取的 App ID 和 App Secret。

对于 User IDs，如果你希望所有用户都能使用，可以留空或输入你的飞书用户ID进行测试。

Domain 保持默认 feishu。

Connection mode 选择 webSocket (推荐)。

步骤 5：配置事件订阅(关键!)

回到飞书开放平台：

进入 “事件与回调”。

订阅方式 选择 “长连接”。

在 “需要订阅的事件” 中，勾选 im.message.receive_v1。

保存。

现在，你可以在飞书中向你的 Bot 发送消息，它就会开始工作了!

🏢 第二部分：接入企业微信 (WeCom)

步骤 1：在企业微信管理后台创建应用

登录 企业微信管理后台。

进入 “应用管理” -> “自建” -> “创建应用”。

填写应用名称(如 Hermes Assistant)、上传头像，点击 “创建应用”。

步骤 2：配置应用权限

在应用详情页，记下 AgentId 和 Secret。

在 “权限管理” 中，确保为应用分配了必要的权限，至少包括 “收发消息”。

步骤 3：配置 Hermes Gateway

再次运行配置命令：

代码语言：Bash

自动换行

AI代码解释

hermes gateway setup

选择 wecom。

输入你的企业 ID (Corp ID)、AgentId 和 Secret。

完成配置。

步骤 4：在企业微信中测试

在企业微信客户端找到你创建的应用，点击进入并发送消息即可开始对话。

🔔 第三部分：接入钉钉 (Dingtalk)

注意：根据最新资料，Hermes Agent 对钉钉的原生支持可能需要通过其通用 Webhook 或稍后更新的版本。但流程与其他平台高度相似。

步骤 1：在钉钉开放平台创建应用

访问 钉钉开放平台。

进入 “应用开发” -> “企业内部开发” -> “小程序”/“H5微应用” (根据需求选择)，点击 “创建应用”。

填写应用信息并创建。

步骤 2：配置机器人 & 获取凭证

在应用详情页，找到 “机器人” 或 “事件订阅” 相关设置。

启用机器人，并获取 AppKey 和 AppSecret。

配置 事件订阅 的 Server URL (如果 Hermes Gateway 提供了公网可访问的 Webhook 地址)。

步骤 3：配置 Hermes Gateway

运行配置命令：

代码语言：Bash

自动换行

AI代码解释

hermes gateway setup

如果列表中有 dingtalk 选项，则直接选择并输入凭证。

如果没有，可以尝试使用 webhook 选项，并将钉钉机器人的 Webhook URL 填入。

步骤 4：测试

在钉钉群聊中添加你的自建机器人，并@它发送消息进行测试。

🧠 终极优势：跨平台统一记忆

完成以上任一或全部平台的配置后，最神奇的事情发生了：

你在飞书里教 Hermes Agent 一个技能。

当你在企业微信里提出类似需求时，它会立刻调用之前学到的技能!

所有平台的交互历史都汇总到同一个持久化记忆中，让它对你的了解越来越深。

这就是 Hermes Agent “The agent that grows with you” 理念的核心体现。

💎 总结

通过 hermes gateway setup 这个强大的命令，Hermes Agent 极大地简化了多平台集成的复杂度。你不再需要为每个 IM平台编写和维护独立的适配器。

操作要点回顾：

在各平台创建自建应用，获取 App ID/Key 和 Secret。

配置必要的权限和事件订阅(尤其是飞书的长连接)。

在服务器上运行 hermes gateway setup，按提示填入凭证。

享受一个跨平台、会自我进化的 AI 分身!