【接入】Hermes Agent 接入飞书 & 企业微信：国内用户最全配置指南

常威正在打来福
0 阅读7分钟

前几篇介绍了 Hermes 的安装和核心功能。 这篇专门讲国内用户最需要的 —— 接入飞书和企业微信。

一、准备工作：你需要什么

准备项说明
Hermes Agent已安装并能正常运行
飞书账号企业版，需要管理员权限创建应用
企业微信账号同上，需要管理员权限
网络要求无需公网 IP（两者均支持 WebSocket 长连接模式）

提醒： 只要采用长连接模式，无论你的服务器是在云端还是本地局域网，都可以顺利接入，无需配置复杂的内网穿透或公网 IP 回调。

二、接入飞书

飞书接入分 5 步，整体约 15-20 分钟。

第 1 步：创建飞书自建应用

  1. 打开 飞书开放平台，用管理员账号登录
  2. 点击「创建应用」→「企业自建应用」
  3. 填写应用名称（比如 Hermes AI 助手）和描述
  4. 上传应用图标（可选）

创建完成后，记下应用名称，后面会用到。

第 2 步：添加机器人能力

  1. 进入应用详情页
  2. 点击「添加应用能力」→「机器人」
  3. 确认启用

重要： 务必勾选「开启交互式卡片」选项，否则后续按钮类交互无法触发。

第 3 步：配置权限

  1. 进入「权限管理」→「申请权限」
  2. 批量添加以下权限：
im:message            # 收发消息
im:message.send_as_bot # 以机器人身份发送消息
im:message.read       # 读取消息
im:message.group_at_msg # 接收群@消息
im:message.p2p_msg    # 接收私聊消息
contact:user.id:readonly # 读取用户 ID
im:resource           # 访问资源
  1. 点击「发布权限变更」使配置立即生效

第 4 步：获取凭证

  1. 进入「凭证与基础信息」页面
  2. 复制并保存以下两项：
  • App ID：cli_xxxxxxxxxx 格式
  • App Secret：一串密钥字符

安全提醒： App Secret 等同于应用密码，不要泄露给他人。

第 5 步：配置 Hermes Gateway

在服务器上运行：

hermes gateway setup

按提示操作：

1. 选择配置聊天平台 → 选 Feishu（飞书）
2. 输入 App ID（刚才复制的）
3. 输入 App Secret
4. Domain 保持默认 feishu
5. Connection mode 选 WebSocket（推荐，无需公网 IP 的关键）
6. 配置群聊和私聊权限
7. 确认安装服务 y

第 6 步：订阅事件

  1. 在飞书开放平台，进入「事件与回调」
  2. 订阅方式选择「长连接」（配合第 5 步，无需提供回调 URL）
  3. 添加事件：im.message.receive_v1（接收消息）

第 7 步：发布应用

  1. 进入「版本管理与发布」
  2. 创建版本并发布

第 8 步：配对验证

  1. 在飞书中搜索机器人名称
  2. 给机器人发一条消息
  3. 命令行会提示配对命令，运行它：
hermes pairing approve <用户ID>
  1. 配对成功后，再次发消息测试

验证命令：

hermes gateway status
# 确认飞书连接状态为 connected

三、接入企业微信

企业微信同样非常简单，利用智能机器人的 WebSocket 长连接特性，也可以在无公网 IP 的环境下稳定运行。

第 1 步：创建机器人

  1. 登录企业微信管理后台
  2. 进入「管理工具」→「智能机器人」
  3. 点击「创建机器人」
  4. 填写机器人名称和描述
  5. 选择「API 模式」创建

第 2 步：获取凭证

创建后，你会得到：

  • Bot ID：格式类似 wwxxxxxxxx
  • Bot Secret：一串密钥

保存好这两个值。

第 3 步：配置 Hermes Gateway

hermes gateway setup


1. 选择配置聊天平台 → 选 WeCom（企业微信）
2. 输入 Bot ID
3. 输入 Bot Secret
4. 配置允许使用的用户
5. 确认安装服务

第 4 步：测试对话

  1. 在企业微信中找到机器人
  2. 发一条消息测试

验证命令：

hermes gateway status
# 确认 WeCom 连接状态为 connected

四、双平台同时接入

Hermes 支持同时接入多个平台。

配置方法

hermes gateway setup

在配置向导中，可以依次配置：

  1. 飞书
  2. 企业微信
  3. 其他平台

完成后，所有平台的消息都会汇总到同一个 Hermes 对话中。

查看连接状态

hermes platforms

输出示例：

Connected platforms:
- Feishu: ✅ Online
- WeCom:  ✅ Online

五、常见问题排错

飞书：消息发出去没有回应

检查步骤：

  1. 确认 Hermes Gateway 在运行：
hermes gateway status
  1. 检查事件订阅是否生效：
  • 飞书开放平台 → 事件与回调 → 确认「长连接」状态为绿色
  1. 检查 App ID 和 App Secret 是否正确：
hermes config show | grep feishu
  1. 查看日志：
hermes logs --platform feishu

网络代理问题（仅限请求外部 LLM）

需要特别澄清的是，飞书和企业微信的 API 在国内访问是非常畅通的，无需为其配置代理。

如果你发现请求超时，通常是因为 Hermes 无法连接到后端的 LLM（大语言模型）API：

  • 如果你底层使用的是国外模型（如 Claude 或 OpenAI）：在国内网络环境下，你需要为 Hermes 配置代理。例如配合本地运行的 v2rayN 等工具，设置 hermes config set http_proxy http://127.0.0.1:端口号。同时，在执行相关配置的 Bash 脚本读取 .omc-config.json 等配置文件时，留意本地的 GateGuard 等安全拦截器是否会对其进行误拦截，导致配置无法生效。
  • 如果你底层使用的是国内模型（如 Kimi 2.5、GLM-5 或 MiMo-V2-Pro）：这些 API 国内直连即可，通常完全不需要配置 HTTP 代理，清空代理配置反而更稳定。

企业微信：机器人无法响应

检查步骤：

  1. 确认 Bot ID 和 Secret 配置正确：
hermes config show | grep wecom
  1. 确认机器人已添加到正确的群聊
  2. 重启 Gateway：
hermes gateway restart

配对失败

原因： 首次使用需要配对命令授权。

解决方法：

  1. 给机器人发任意消息
  2. 命令行会显示配对命令，类似：
Run: hermes pairing approve <user_id>
  1. 复制命令并运行
  2. 再次发消息测试

六、安全建议

限制使用人员

在配置时，务必设置允许的用户列表，避免陌生人调用 Hermes：

hermes config set allowed_users user1,user2,user3

敏感信息处理

  • 不要在对话中透露核心业务数据
  • 定期检查 ~/.hermes/memory/ 目录，清除敏感记忆
  • API Key 和 Token 妥善保管，不要写入代码库

监控使用情况

hermes usage --days 7

查看近 7 天的使用量，及时发现异常。

七、进阶玩法

定时任务推送

配置 Cron 任务，每天定时推送到飞书或企业微信：

hermes cron add \
  --name "daily-report" \
  --schedule "0 9 * * *" \
  --message "早安！今日资讯摘要..." \
  --platform feishu

多机器人协同

在同一个群里添加多个 Hermes 实例，分别负责不同任务：

  • 机器人 A：负责技术问答
  • 机器人 B：负责日程提醒

接入钉钉（补充）

虽然官方文档主要介绍飞书和企业微信，但 Hermes 也支持钉钉：

hermes gateway setup
# 选择配置 DingTalk
# 输入 App ID 和 App Secret

钉钉同样支持长连接模式，配置流程与飞书类似。

八、配置对比

平台是否需要公网 IP配置难度适合场景
飞书❌ 不需要 (支持 WebSocket)⭐⭐⭐ 中等企业内部协作
企业微信❌ 不需要 (支持 WebSocket)⭐⭐ 简单快速验证、小团队
钉钉❌ 不需要 (支持 Stream 模式)⭐⭐⭐ 中等阿里系企业

九、完成

飞书和企业微信都接入后，你就有了随时可用的 AI 助手。

资源链接

点点赞和关注不迷路，后续还会分享更多 AI 效率工具。

👨‍💻 H先生出品 | 专注 AI 工具与效率提升

avatar
文章
阅读
粉丝