Hermes Agent 接 DingTalk,官方推荐优先用 Stream Mode,也就是基于 WebSocket 的实时收发方式。这样不需要公网回调地址,企业内网或测试环境也更容易跑通。
基础配置流程
- 在钉钉开发者后台创建机器人应用。
- 开启 Robot Capability,并选择 Message Reception 的 Stream Mode。
- 拿到应用凭据,写进
~/.hermes/.env。 - 配置
DINGTALK_ALLOWED_USERS,确保只有指定用户能操作 Hermes。 - 启动
hermes gateway,先在私聊或测试群发消息验证。
为什么明明连上了却不回
这类情况通常不是模型没出结果,而是机器人能力没开、用户 ID 没进 allowlist,或者群里消息类型没有正确接收。官方文档也特别提醒:Hermes 用的是 DingTalk User ID 做访问控制,不是你平时看到的昵称。
一句话:DingTalk 配置的关键不是回调地址,而是 Stream Mode、机器人能力和正确的用户 ID allowlist。
官方开源地址:https://github.com/NousResearch/hermes-agent;官方文档入口:https://hermes-agent.nousresearch.com/。