# Skill Agent Broadcast

> Broadcast a message to multiple OpenClaw group sessions simultaneously. Use for cross-agent coordination, alerts, and announcements.

- Skill: `modbender/skill-agent-broadcast` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add modbender/skill-agent-broadcast`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/skill-agent-broadcast/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/skill-agent-broadcast

---


# skill-agent-broadcast

Cross-group signal router. Send one message to multiple OpenClaw Telegram/Discord groups simultaneously.

## Usage

```bash
# Broadcast to named groups
node scripts/broadcast.js --message "Deploy complete!" --groups "github-ops,amazon-ops"

# Broadcast to all registered groups
node scripts/broadcast.js --message "⚡ System alert" --groups all

# Use raw Telegram chat IDs
node scripts/broadcast.js --message "Hello" --groups "-1003871838436,-1003578613620"

# Custom delay between sends
node scripts/broadcast.js --message "Update" --groups all --delay 1000
```

## Arguments

| Arg | Default | Description |
|---|---|---|
| `--message` / `-m` | required | Message text to broadcast |
| `--groups` / `-g` | all | Comma-separated group names or IDs. Use `all` for all registered groups |
| `--channel` | `telegram` | Channel type: `telegram` or `discord` |
| `--delay` | `500` | Milliseconds between sends (rate limiting) |

## Environment Variables

| Var | Default | Description |
|---|---|---|
| `OPENCLAW_PORT` | `3000` | OpenClaw gateway port |
| `OPENCLAW_TOKEN` | — | Gateway auth token |
| `GROUPS_CONFIG_PATH` | `config/groups.json` | Path to group registry JSON |

## Group Registry

Edit `config/groups.json` to add/remove groups:

```json
{
  "github-ops": "-1003871838436",
  "social-media": "-1003578613620",
  "amazon-ops": "-1003898064257"
}
```

## Output

Delivery receipt per group:
```
✅ github-ops (-1003871838436)
✅ amazon-ops (-1003898064257)
❌ social-media (-1003578613620) (status: 500)

✅ Broadcast complete: 2 sent, 1 failed
```