X Timeline Digest

通过 bird 读取 X/Twitter 的 For You 与 Following 时间线，按增量与文本相似度去重、排序裁剪后输出结构化 JSON，再结合 PROMPT.md 提示与 LLM 生成中文分类摘要。技能本身不负责推送/通知，需预先安装并登录 bird，只读使用。

seandong

热度 93.89

最近更新 2026-05-11 15:52:12

分类：搜索依赖：代码执行 / 读写文件 / 第三方 API / 内部调用大模型应用场景：摘要总结 / 社交媒体 / 研究

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add x-timeline-digest

Metadata

name: x-timeline-digest
version: 1.0.2
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:

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.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

Fetch from For You and Following
Incremental filter using lastRunAt
Hard deduplication by tweet id
Near-duplicate merge using text similarity
Rank and trim to maxItemsPerDigest
Generate a Categorized Chinese Digest (via PROMPT.md + LLM)
- Categories: 🤖 AI & Tech, 💰 Crypto & Markets, 💡 Insights, 🗞️ Other
- Language: Simplified Chinese
- Format: Author: Summary
- Denoising: Remove ads and low-value content

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"] } ] }