Discord Digest
by @nikolaybohdanov
Generate formatted digests from Discord servers using a user token. Reads messages from selected channels/threads and creates concise summaries with links. U...
clawhub install discord-digestπ About This Skill
name: discord-digest description: Generate formatted digests from Discord servers using a user token. Reads messages from selected channels/threads and creates concise summaries with links. Use when generating Discord server digests, monitoring Discord channels, or creating Discord activity reports. Supports multi-server configuration, interactive channel selection, token validation with expiry notifications, and configurable time periods.
Discord Digest
Generate formatted digests from Discord servers. Reads channels via user token (no bot required).
Setup
1. Set Discord User Token
Get token from browser: Discord (web) β F12 β Network β any API request β Headers β Authorization value.
python3 scripts/config_manager.py set-token "YOUR_TOKEN"
2. Scan & Select Servers
List all servers the user belongs to:
python3 scripts/discord_api.py "TOKEN" guilds
3. Scan & Select Channels
List channels for a specific server:
python3 scripts/discord_api.py "TOKEN" channels SERVER_ID
4. Add Server to Config
python3 scripts/config_manager.py add-server '{"id":"SERVER_ID","name":"Server Name","channels":[{"id":"CH_ID","name":"channel-name","type":"text"}]}'
Usage
Generate Digest
python3 scripts/run_digest.py [--hours 24] [--server SERVER_ID]
Validate Token
python3 scripts/discord_api.py "TOKEN" validate
Token Expiry Handling
Before each digest run, the token is validated via GET /users/@me. If it returns 401:
1. Notify user: "β οΈ Discord token expired, send new token"
2. Wait for new token
3. Update config: python3 scripts/config_manager.py set-token "NEW_TOKEN"
4. Retry digest
Output Format
#SERVER_NAME DD.MM.YYβpost | π channel-name
Post Title
Details: Brief 1-sentence summary of the post content
Links: source 1 | source 2
Config File
Located at ~/.openclaw/workspace/config/discord-digest.json:
{
"discord_token": "...",
"servers": [
{
"id": "829331298878750771",
"name": "DOUBLETOP SQUAD",
"channels": [
{"id": "1238663837515911198", "name": "drops-alerts", "type": "text"}
]
}
],
"digest_period_hours": 24
}
Scripts
| Script | Purpose |
|--------|---------|
| discord_api.py | Discord HTTP API client (user token auth) |
| digest_formatter.py | Format messages into digest |
| config_manager.py | Manage token, servers, channels config |
| run_digest.py | Main entry: validate β read β format |
Rate Limits
Discord API rate limits: ~1 req/sec with automatic retry on 429. The scripts include built-in rate limit handling with exponential backoff.
Important Notes
urllib, json)π‘ Examples
Generate Digest
python3 scripts/run_digest.py [--hours 24] [--server SERVER_ID]
Validate Token
python3 scripts/discord_api.py "TOKEN" validate
Token Expiry Handling
Before each digest run, the token is validated via GET /users/@me. If it returns 401:
1. Notify user: "β οΈ Discord token expired, send new token"
2. Wait for new token
3. Update config: python3 scripts/config_manager.py set-token "NEW_TOKEN"
4. Retry digest
βοΈ Configuration
1. Set Discord User Token
Get token from browser: Discord (web) β F12 β Network β any API request β Headers β Authorization value.
python3 scripts/config_manager.py set-token "YOUR_TOKEN"
2. Scan & Select Servers
List all servers the user belongs to:
python3 scripts/discord_api.py "TOKEN" guilds
3. Scan & Select Channels
List channels for a specific server:
python3 scripts/discord_api.py "TOKEN" channels SERVER_ID
4. Add Server to Config
python3 scripts/config_manager.py add-server '{"id":"SERVER_ID","name":"Server Name","channels":[{"id":"CH_ID","name":"channel-name","type":"text"}]}'