钉钉 Webhook 完全指南
基础概念与选型
在集成钉钉机器人时,通常有两种方式:OpenClaw 插件和 Webhook 机器人。插件适合简单集成和双向通信,但只能被动回复;Webhook 则支持主动推送且格式丰富,不过需要自行处理签名逻辑。
结论:如果需要主动推送消息(如报警、任务提醒),直接使用 Webhook。
| 特性 | 插件 | Webhook |
|---|---|---|
| 纯文本 | ✅ | ✅ |
| Markdown | ✅ | ✅ |
| 链接卡片 | ❌ | ✅ |
| 按钮卡片 | ❌ | ✅ |
| @ 用户 | ❌ | ✅ |
@ 用户功能的核心机制
很多开发者反馈 @ 功能不生效,核心原因通常是只满足了其中一个条件。必须同时满足以下两点:
- 消息内容中包含
@手机号或@所有人 - JSON 请求体的
at字段中指定atMobiles或isAtAll
缺一不可。下面是对应的 JSON 结构示例:
@ 所有人
{
"msgtype": "text",
"text": {
"content": "【紧急通知】@所有人 请立即查看"
},
"at": {
"isAtAll": true
}
}
@ 指定用户
{
"msgtype": "text"

