核心用法
skill-agent-broadcast 是一款面向 OpenClaw 生态的跨群组消息广播工具，核心功能是将单条消息同步分发至多个 Telegram 或 Discord 群组。通过命名群组或原始 Chat ID 指定目标，支持 --delay 参数控制发送间隔以避免触发平台速率限制。
典型场景：
- 部署完成后的多团队通知
- 系统异常时的紧急告警广播
- 日常运维状态的批量同步
显著优点
- 多平台支持：原生支持 Telegram 与 Discord 双通道
- 灵活的目标指定：支持友好名称（如
github-ops）或原始 ID，也可一键广播至全部注册群组 - 速率保护：内置可配置的延迟机制（默认 500ms），降低被封禁风险
- 清晰回执：逐群组返回投递状态，失败原因可见
潜在局限
- 依赖 OpenClaw 网关：需运行中的 OpenClaw 实例及有效
OPENCLAW_TOKEN - 配置中心化：群组映射集中存储于
config/groups.json，分布式场景下维护成本较高 - 无消息模板：暂不支持变量插值或富文本格式化，复杂通知需外部预处理
- 单向广播：无消息确认或回执回调机制，失败仅能通过状态码感知
适合人群
- 运维工程师（SRE/DevOps）需批量通知多团队协作群
- 开源项目维护者管理多个社区频道
- 小型团队构建轻量级内部告警体系
常规风险
- Token 泄露：
OPENCLAW_TOKEN具备网关访问权限，需按机密凭据管理 - 消息误发：使用
--groups all时若配置错误可能导致敏感信息扩散至非预期群组 - 频率超限：即使开启延迟，高频广播仍可能触发 Telegram/Discord 反垃圾机制，导致临时限制
- 配置漂移：
groups.json手动维护易产生 ID 变更后的投递失败
使用建议
生产环境建议结合 CI/CD 流水线调用，避免本地人工执行；敏感操作前优先使用 --groups 指定明确目标，慎用 all；定期审计 config/groups.json 中的群组有效性。