前几篇介绍了 Hermes 的安装和核心功能。
这篇专门讲国内用户最需要的 —— 接入飞书和企业微信。
一、准备工作：你需要什么
| 准备项 | 说明 |
|---|---|
| Hermes Agent | 已安装并能正常运行 |
| 飞书账号 | 企业版，需要管理员权限创建应用 |
| 企业微信账号 | 同上，需要管理员权限 |
| 网络要求 | 无需公网 IP（两者均支持 WebSocket 长连接模式） |
提醒：只要采用长连接模式，无论你的服务器是在云端还是本地局域网，都可以顺利接入，无需配置复杂的内网穿透或公网 IP 回调。
二、接入飞书
飞书接入分 5 步，整体约 15-20 分钟。
第 1 步：创建飞书自建应用
- 打开 飞书开放平台，用管理员账号登录
- 点击「创建应用」→「企业自建应用」
- 填写应用名称（比如
Hermes AI 助手）和描述 - 上传应用图标（可选）
创建完成后，记下应用名称，后面会用到。
第 2 步：添加机器人能力
- 进入应用详情页
- 点击「添加应用能力」→「机器人」
- 确认启用
重要：务必勾选「开启交互式卡片」选项，否则后续按钮类交互无法触发。
第 3 步：配置权限
- 进入「权限管理」→「申请权限」
- 批量添加以下权限：
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 # 访问资源- 点击「发布权限变更」使配置立即生效
第 4 步：获取凭证
- 进入「凭证与基础信息」页面
- 复制并保存以下两项：
- 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 步：订阅事件
- 在飞书开放平台，进入「事件与回调」
- 订阅方式选择「长连接」（配合第 5 步，无需提供回调 URL）
- 添加事件：
im.message.receive_v1（接收消息）
第 7 步：发布应用
- 进入「版本管理与发布」
- 创建版本并发布
第 8 步：配对验证
- 在飞书中搜索机器人名称
- 给机器人发一条消息
- 命令行会提示配对命令，运行它：
hermes pairing approve<用户ID>- 配对成功后，再次发消息测试
验证命令：
hermes gateway status# 确认飞书连接状态为 connected三、接入企业微信
企业微信同样非常简单，利用智能机器人的WebSocket 长连接特性，也可以在无公网 IP 的环境下稳定运行。
第 1 步：创建机器人
- 登录企业微信管理后台
- 进入「管理工具」→「智能机器人」
- 点击「创建机器人」
- 填写机器人名称和描述
- 选择「API 模式」创建
第 2 步：获取凭证
创建后，你会得到：
- Bot ID：格式类似
wwxxxxxxxx - Bot Secret：一串密钥
保存好这两个值。
第 3 步：配置 Hermes Gateway
hermes gateway setup1. 选择配置聊天平台 → 选 WeCom（企业微信） 2. 输入 Bot ID 3. 输入 Bot Secret 4. 配置允许使用的用户 5. 确认安装服务第 4 步：测试对话
- 在企业微信中找到机器人
- 发一条消息测试
验证命令：
hermes gateway status# 确认 WeCom 连接状态为 connected四、双平台同时接入
Hermes 支持同时接入多个平台。
配置方法
hermes gateway setup在配置向导中，可以依次配置：
- 飞书
- 企业微信
- 其他平台
完成后，所有平台的消息都会汇总到同一个 Hermes 对话中。
查看连接状态
hermes platforms输出示例：
Connected platforms: - Feishu: ✅ Online - WeCom: ✅ Online五、常见问题排错
飞书：消息发出去没有回应
检查步骤：
- 确认 Hermes Gateway 在运行：
hermes gateway status- 检查事件订阅是否生效：
- 飞书开放平台 → 事件与回调 → 确认「长连接」状态为绿色
- 检查 App ID 和 App Secret 是否正确：
hermes config show|grepfeishu- 查看日志：
hermes logs--platformfeishu企业微信：机器人无法响应
检查步骤：
- 确认 Bot ID 和 Secret 配置正确：
hermes config show|grepwecom- 确认机器人已添加到正确的群聊
- 重启 Gateway：
hermes gateway restart配对失败
原因：首次使用需要配对命令授权。
解决方法：
- 给机器人发任意消息
- 命令行会显示配对命令，类似：
Run: hermes pairing approve <user_id>- 复制命令并运行
- 再次发消息测试
六、安全建议
限制使用人员
在配置时，务必设置允许的用户列表，避免陌生人调用 Hermes：
hermes configsetallowed_users user1,user2,user3敏感信息处理
- 不要在对话中透露核心业务数据
- 定期检查
~/.hermes/memory/目录，清除敏感记忆 - API Key 和 Token 妥善保管，不要写入代码库
监控使用情况
hermes usage--days7查看近 7 天的使用量，及时发现异常。
七、进阶玩法
定时任务推送
配置 Cron 任务，每天定时推送到飞书或企业微信：
hermescronadd\--name"daily-report"\--schedule"0 9 * * *"\--message"早安！今日资讯摘要..."\--platformfeishu多机器人协同
在同一个群里添加多个 Hermes 实例，分别负责不同任务：
- 机器人 A：负责技术问答
- 机器人 B：负责日程提醒
接入钉钉（补充）
虽然官方文档主要介绍飞书和企业微信，但 Hermes 也支持钉钉：
hermes gateway setup# 选择配置 DingTalk# 输入 App ID 和 App Secret钉钉同样支持长连接模式，配置流程与飞书类似。
八、配置对比
| 平台 | 是否需要公网 IP | 配置难度 | 适合场景 |
|---|---|---|---|
| 飞书 | ❌ 不需要 (支持 WebSocket) | ⭐⭐⭐ 中等 | 企业内部协作 |
| 企业微信 | ❌ 不需要 (支持 WebSocket) | ⭐⭐ 简单 | 快速验证、小团队 |
| 钉钉 | ❌ 不需要 (支持 Stream 模式) | ⭐⭐⭐ 中等 | 阿里系企业 |
九、完成
飞书和企业微信都接入后，你就有了随时可用的 AI 助手。
资源链接
- 飞书开放平台
- 企业微信管理后台
- Hermes 官方文档
- Hermes 中文用户组
点点赞和关注不迷路，后续还会分享更多 AI 效率工具。
👨💻 H先生出品 | 专注 AI 工具与效率提升
