x-timeline-digest

name	x-timeline-digest
description	Build a deduplicated digest from X (Twitter) For You and Following timelines using bird. Outputs a payload for upstream delivery.
homepage	https://github.com/seandong
metadata	{"openclaw":{"emoji":"🐦","requires":{"bins":["bird"]}}}

x-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:

1. Fetch recent tweets
2. Filter incrementally (avoid reprocessing)
3. Deduplicate (ID + near-duplicate text)
4. Rank and trim
5. Generate a Chinese digest
6. 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):

1. Run the script: node skills/x-timeline-digest/digest.js > digest.json
2. Read the prompt template: read skills/x-timeline-digest/PROMPT.md
3. Send the prompt to your LLM, injecting the content of digest.json where {{JSON_DATA}} is.

Note: The script automatically applies heuristic filtering (removes "gm", ads, short spam) before outputting JSON.

Bird Commands Used

For You timeline: bird home -n --json Following timeline: bird home --following -n --json

State Management

State is persisted to statePath.

State structure

{ "lastRunAt": "2026-02-01T00:00:00+08:00", "sentTweetIds": { "123456789": "2026-02-01T00:00:00+08:00" } }

Rules

• Tweets already in sentTweetIds must not be included again
• After a successful run:
• Update lastRunAt
• Add pushed tweet IDs to sentTweetIds
• Keep IDs for at least 30 days

---

Processing Pipeline

1. Fetch from For You and Following
2. Incremental filter using lastRunAt
3. Hard deduplication by tweet id
4. Near-duplicate merge using text similarity
5. Rank and trim to maxItemsPerDigest
6. Summarize into Chinese digest

---

Output

The skill returns one JSON object: { "window": { "start": "2026-02-01T00:00:00+08:00", "end": "2026-02-01T06:00:00+08:00", "intervalHours": 6 }, "counts": { "forYouFetched": 100, "followingFetched": 60, "afterIncremental": 34, "afterDedup": 26, "final": 20 }, "digestText": "中文摘要内容", "items": [ { "id": "123456", "author": "@handle", "createdAt": "2026-02-01T02:15:00+08:00", "text": "tweet text", "url": "https://x.com/handle/status/123456", "sources": ["following"] } ] }