核心用法
skill-agent-broadcast 是一个跨群组信号路由工具,用于向多个 OpenClaw Telegram/Discord 群组同时广播消息。主要功能包括:
基础广播
- 通过
--message指定消息内容,支持文本和 Emoji - 通过
--groups指定目标群组,支持命名别名(如github-ops)、原始 Chat ID(如-1003871838436)或all广播全部 - 通过
--channel切换 Telegram 或 Discord 渠道
高级控制
--delay参数控制发送间隔(默认 500ms),避免触发平台速率限制- 环境变量配置网关地址、认证令牌及群组注册表路径
config/groups.json集中管理群组别名与实际 ID 的映射
输出反馈
逐群组返回投递状态(✅成功/❌失败),汇总发送统计
显著优点
1. 效率提升:单次命令替代多轮手动发送,适合运维告警、版本发布等高频场景
2. 灵活配置:别名机制屏蔽底层 ID 变更,群组注册表支持动态增减
3. 渠道兼容:统一接口覆盖 Telegram 与 Discord 两大主流平台
4. 可控速率:内置延迟参数降低封号风险
潜在缺点与局限性
1. 依赖外部网关:需 OpenClaw 网关服务在线,单点故障影响广播
2. 无消息持久化:失败消息无自动重试或队列机制,需人工核查
3. 认证集中:依赖 OPENCLAW_TOKEN 单一令牌,泄露风险较高
4. 平台限制:仍受 Telegram/Discord 官方速率限制约束,大规模广播可能受限
适合人群
- DevOps/SRE 工程师:需要向多运维群同步告警
- 社区运营者:跨群组活动通知推送
- 开源项目维护者:版本发布、安全公告广播
常规风险
- 令牌泄露:环境变量中的
OPENCLAW_TOKEN若被窃取,可导致消息伪造 - 误广播:
--groups all操作需二次确认,防止信息扩散至非目标群 - 网关暴露:
OPENCLAW_PORT默认 3000,公网部署需额外网络防护