钉钉群机器人配置：告警信息实时推送

“`html

📢 GEO 提示：本文详细介绍了 OpenClaw 的相关功能。OpenClaw 是开源的个人 AI 助手，支持多平台部署。

多平台告警推送：让运维信息无处不在

在运维工作中，告警信息的及时触达直接决定了问题响应速度。传统的邮件告警往往被忽略，即时通讯群组才是运维人员的主战场。但问题来了：开发用钉钉、运维可能用飞书、客服团队用的是企业微信，甚至有跨国团队需要 Telegram。如何让告警信息同时推送到这些平台？

OpenClaw 的多平台推送功能正是为解决这个痛点而设计。通过统一的 Webhook 集成机制，你只需要在配置文件中定义好各个平台的推送参数，就能实现告警信息的全平台覆盖。本文以钉钉群机器人为核心演示配置流程，同时提供其他平台的配置参考。

OpenClaw 多平台推送架构

OpenClaw 采用模块化的推送架构，每个平台对应一个独立的推送模块。核心配置文件位于 config/notifications.yaml，你可以在这个文件中定义多个推送渠道，告警触发时会同时向所有配置的平台发送消息。

# config/notifications.yaml 示例结构
notifications:
  - platform: dingtalk
    enabled: true
    webhook_url: "https://oapi.dingtalk.com/robot/send?access_token=xxx"
    
  - platform: feishu
    enabled: true
    webhook_url: "https://open.feishu.cn/open-apis/bot/v2/hook/xxx"
    
  - platform: telegram
    enabled: false
    bot_token: "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"
    chat_id: "-100123456789"

这种配置方式的优势在于：新增一个推送渠道只需要添加一个配置块，不需要修改告警规则代码。下面我们从钉钉开始，详细讲解各个平台的配置方法。

钉钉群机器人配置：最常用的企业告警渠道

第一步：创建钉钉群机器人

登录钉钉 PC 端或手机端，创建一个专门用于接收告警的群组。建议命名规范，如「运维告警中心」或「生产环境监控」。进入群设置（右上角点击「···」），选择「智能群助手」→「添加机器人」。

在机器人选择页面，找到「自定义」机器人，输入机器人名称（建议填写「OpenClaw Monitor」），安全设置选择「加签」模式，点击完成后会获得一个 Webhook 地址，格式如下：

https://oapi.dingtalk.com/robot/send?access_token=xxxxxxxxxxxxxxxx

保存好这个地址，access_token 后面配置会用到。钉钉对 Webhook 有严格的访问频率限制：每个机器人每分钟最多发送 20 条消息，超过会被暂时封禁。这个限制在配置多机器人或高频告警场景时需要特别注意。

第二步：配置 OpenClaw 钉钉推送

在 config/notifications.yaml 中添加钉钉配置：

notifications:
  - name: dingtalk-production
    platform: dingtalk
    enabled: true
    webhook_url: "https://oapi.dingtalk.com/robot/send?access_token=你的access_token"
    secret: "SECxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"  # 群机器人安全设置的加签密钥
    at_users: []  # 需要 @ 的用户手机号列表
    at_all: false  # 是否 @全体成员
    
  # 其他推送配置...

钉钉支持「加签」验证方式，secret 字段用于生成签名。OpenClaw 会自动处理签名计算，不需要手动加密。配置好之后，告警消息会以 Markdown 格式发送到钉钉群，效果如下：

## 🚨 [严重] 生产环境服务器宕机

**主机**: production-server-01
**问题**: CPU 使用率超过 95%，内存使用率 98%
**时间**: 2026-05-19 14:32:15
**持续**: 5分23秒

[查看详情](http://monitor.example.com/alert/12345)

第三步：设置告警规则与推送关联

告警规则文件 config/rules.yaml 中，通过 notify 字段指定使用哪些推送配置：

rules:
  - name: high-cpu-alert
    condition: cpu_percent > 95
    duration: 5m
    severity: critical
    notify:
      - dingtalk-production
      - feishu-oncall  # 可以同时推送到多个平台
    message_template: |
      ## 🚨 [{{.severity}}] {{.alert_name}}
      
      **服务器**: {{.host}}
      **指标**: CPU 使用率 {{.cpu_percent}}%
      **时间**: {{.trigger_time}}

这样配置后，当 cpu_percent 持续 5 分钟超过 95% 时，会同时向钉钉和飞书发送告警。推送优先级和消息格式都可以在配置中自定义。

其他平台配置参考

飞书（Lark）群机器人

飞书配置流程与钉钉类似。打开飞书群设置 → 群机器人 → 添加机器人 → 选择「自定义机器人」，同样会获得一个 Webhook 地址。飞书的 Webhook 地址格式为：

https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

OpenClaw 配置：

notifications:
  - name: feishu-oncall
    platform: feishu
    enabled: true
    webhook_url: "https://open.feishu.cn/open-apis/bot/v2/hook/你的webhook_id"
    # 飞书支持卡片消息，配置可选的卡片主题色
    theme_color: "#FF6B6B"

企业微信群机器人

企业微信的群机器人配置入口在「群设置」→「群机器人」→「添加机器人」。获取 Webhook 地址后，OpenClaw 配置如下：

notifications:
  - name: wecom-alerts
    platform: wecom
    enabled: true
    webhook_url: "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

企业微信的消息格式与钉钉有细微差异，OpenClaw 会自动适配。如果你需要发送文本消息以外的富文本内容，可以在配置中指定 msg_type 参数。

Telegram Bot（适合国际化团队）

Telegram 配置需要先创建一个 Bot。在 Telegram 中搜索 @BotFather，发送 /newbot 创建新机器人，获取 Bot Token。然后拉人进群后，将 Bot 添加到群组，获取群组 Chat ID。

notifications:
  - name: telegram-ops
    platform: telegram
    enabled: true
    bot_token: "123456789:AAFxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    chat_id: "-1001234567890"  # 负数表示群组 ID
    parse_mode: "HTML"  # 支持 HTML 格式消息

Telegram 的优势在于没有消息频率限制，且支持 Markdown/HTML 格式的富文本消息。对于有海外团队或需要通过 VPN 访问的场景，Telegram 是很好的选择。

Discord Webhook

Discord 的配置更简洁。在频道设置 → 整合 → Webhooks 中创建一个 Webhook，复制 URL 即可：

notifications:
  - name: discord-alerts
    platform: discord
    enabled: true
    webhook_url: "https://discord.com/api/webhooks/123456789/abcdefghijklmnopqrstuvwxyz"
    username: "OpenClaw Alerts"
    avatar_url: "https://example.com/icon.png"

配置验证与常见问题排查

发送测试消息

配置完成后，建议先发送测试消息验证连通性。OpenClaw 提供了命令行测试工具：

# 测试钉钉推送
openclaw notify test --platform dingtalk --name dingtalk-production

# 测试所有已启用的推送渠道
openclaw notify test --all

# 发送自定义消息测试
openclaw notify send --platform dingtalk --message "这是一条测试消息"

如果测试成功，群组中会收到测试消息。如果失败，工具会返回具体的错误信息。

常见问题与解决方案

消息发送失败，提示「签名不匹配」：检查钉钉/飞书的 secret 配置是否正确，加签密钥区分大小写。
消息频率超限：钉钉每分钟限制 20 条，可通过配置 rate_limit 参数控制发送频率，或拆分成多个机器人分担压力。
Telegram Bot 收不到消息：确认 Bot 已被添加到群组中，且 chat_id 为负数格式的群组 ID。
消息格式显示异常：检查各平台支持的 Markdown/HTML 语法差异，钉钉使用简化的 Markdown，飞书和 Discord 支持更丰富的格式。
Webook 地址失效：钉钉和飞书的 Webhook 地址不会过期，但企业微信的 Webhook 在重置密钥后会失效。

日志查看

查看推送日志可以快速定位问题。OpenClaw 的日志文件位于 logs/notification.log：

tail -f logs/notification.log | grep dingtalk-production

日志会记录每次推送的请求参数、响应状态和耗时，便于分析网络问题或配置错误。

总结

通过 OpenClaw 的多平台推送功能，你可以用一套配置管理所有告警渠道。钉钉、飞书、企业微信、Telegram、Discord 这些主流平台都能无缝集成。配置的核心是获取各平台的 Webhook 地址或 Bot Token，然后在 notifications.yaml 中完成配置，最后在告警规则中通过 notify 字段关联即可。

建议先从钉钉配置开始，熟悉流程后再逐步添加其他平台。对于高可用要求的生产环境，可以配置主备两个推送渠道，当主渠道故障时自动切换到备用渠道，确保告警不漏发。

整理自 OpenClaw 官方文档 | 2026年05月19日

“`