DingTalk 设置
Hermes Agent 与 DingTalk（钉钉）作为聊天机器人集成。机器人通过 DingTalk 的 Stream Mode 连接——一个持久的 WebSocket 连接，无需公共 URL 或 webhook 服务器。
前置要求
pip install dingtalk-stream httpx
设置步骤
步骤 1：创建 DingTalk 应用
- 进入 DingTalk Developer Console
- 创建自定义应用
- 复制 Client ID 和 Client Secret
步骤 2：启用机器人能力
- 在应用设置中添加 Robot 能力
- 选择 Stream Mode（推荐）
步骤 3：配置 Hermes
hermes gateway setup # 选择 DingTalk
或手动：
DINGTALK_CLIENT_ID=你的-app-key
DINGTALK_CLIENT_SECRET=你的-app-secret
DINGTALK_ALLOWED_USERS=user-id-1
行为
| 上下文 | 行为 |
|---|---|
| DM | Hermes 响应每条消息 |
| 群聊 | 需要 @mention 才响应 |
故障排除
| 问题 | 解决方案 |
|---|---|
| "dingtalk-stream not installed" | pip install dingtalk-stream httpx |
| 机器人不响应 | 检查 DINGTALK_ALLOWED_USERS 包含你的用户 ID |
安全
注意
始终设置 DINGTALK_ALLOWED_USERS 限制谁可以与机器人交互。