x-timeline-digest
Build a deduplicated digest from X (Twitter) For You and Following timelines using bird. Outputs a payload for upstream delivery.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/seandong/x-timeline-digestx-timeline-digest
Overview
This skill uses bird to read X/Twitter timelines and build a high-signal digest. Sources:
- For You timeline
- Following timeline What it does:
- Fetch recent tweets
- Filter incrementally (avoid reprocessing)
- Deduplicate (ID + near-duplicate text)
- Rank and trim
- Generate a Chinese digest
- Output a structured payload
Delivery (Telegram, email, etc.) is NOT handled here. Upstream OpenClaw workflows decide how to notify users.
Configuration
All config is read from: skills.entries["x-timeline-digest"].config
Config fields
| Name | Type | Default | Description |
|---|---|---|---|
| intervalHours | number | 6 | Interval window in hours |
| fetchLimitForYou | number | 100 | Tweets fetched from For You |
| fetchLimitFollowing | number | 60 | Tweets fetched from Following |
| maxItemsPerDigest | number | 25 | Max tweets in one digest |
| similarityThreshold | number | 0.9 | Near-duplicate similarity threshold |
| statePath | string | ~/.openclaw/state/x-timeline-digest.json | State file path |
Dependencies
- bird must be installed and available in PATH
- bird must already be authenticated (cookie login)
- Read-only usage
Usage
1. Basic (Raw JSON)
Run the digest generator to get a clean, deduplicated JSON payload:
node skills/x-timeline-digest/digest.js
2. Intelligent Digest (Recommended)
To generate the "Smart Brief" (Categorized, Summarized, Denoised):
- Run the script:
node skills/x-timeline-digest/digest.js > digest.json - Read the prompt template:
read skills/x-timeline-digest/PROMPT.md - Send the prompt to your LLM, injecting the content of
digest.jsonwhere{{JSON_DATA}}is.
Note: The script automatically applies heuristic filtering (removes "gm", ads, short spam) before outputting JSON.
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-seandong-x-timeline-digest": {
"enabled": true,
"auto_update": true
}
}
}