webhook-promo-scheduler
Schedule and send promo/alert messages to a Discord webhook URL with an anti-spam ledger.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/marcia-assistant/webhook-promo-schedulerwebhook-promo-scheduler
Schedule and send promo/alert messages to a Discord webhook URL with an anti-spam ledger.
What it does
- Posts to a Discord webhook (JSON payload with
content) - Maintains a JSONL ledger to enforce max 1 successful post per day per channel
- Provides a rotation mode that cycles through a message list
- Supports
--dry-runso you can validate cadence/ledger without sending anything
Positioning (best angle)
- Ship updates without becoming a spammer (or leaking a webhook): strict cadence + audit trail.
Files
scripts/post_webhook.py: Discord webhook POST helper (stdlib only)scripts/ledger.py: JSONL ledger helpers (stdlib only)scripts/promo_scheduler.py: CLI tool (stdlib only)
Ledger
- Default:
~/.openclaw/webhook-promo-ledger.jsonl - Override:
--ledger-path /path/to/ledger.jsonl - JSONL fields (per line):
date,channel,status,hash
Safety
- The CLI refuses to print the webhook URL.
- Logs redact any webhook URL if it would appear.
- Recommended: keep the webhook in a private channel, rotate it if leaked, and use
--dry-runbefore enabling live sends.
FAQ (security)
Q: This exposes a Discord webhook — is that dangerous?
A: Treat it like a password. This tool won’t print it, supports secret injection, and has --dry-run + a ledger so you can validate behavior before turning on live posting. If you want zero direct exposure, put a relay (Cloudflare Worker / Supabase Edge Function) in front and keep the real webhook private.
Usage
One-shot post:
python3 {baseDir}/scripts/promo_scheduler.py post \
--webhook-url <URL> \
--channel openclaw-discord \
--message "Hello from OpenClaw!"
Draft rotation:
python3 {baseDir}/scripts/promo_scheduler.py rotate \
--webhook-url <URL> \
--channel openclaw-discord \
--messages-file messages.txt
messages.txt format:
- One message per non-empty line
- Lines starting with
#are ignored
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-marcia-assistant-webhook-promo-scheduler": {
"enabled": true,
"auto_update": true
}
}
}