介绍
# x-timeline-digest ## 概述 此技能使用 bird 读取 X/Twitter 时间线并构建高信噪比的摘要。 来源： - For You 时间线（推荐） - Following 时间线（关注） 功能： 1. 获取最近推文 2. 增量过滤（避免重复处理） 3. 去重（ID + 近似文本） 4. 排序与裁剪 5. 生成中文摘要 6. 输出结构化负载 > 投递（Telegram、邮件等）不在此处处理。 > 上游 OpenClaw 工作流决定如何通知用户。 --- ## 配置 所有配置均读取自：skills.entries["x-timeline-digest"].config ### 配置字段 | 名称 | 类型 | 默认值 | 描述 | |----|----|----|----| | intervalHours | number | 6 | 时间窗口（小时） | | fetchLimitForYou | number | 100 | 从 For You 获取的推文数 | | fetchLimitFollowing | number | 60 | 从 Following 获取的推文数 | | maxItemsPerDigest | number | 25 | 单次摘要的最大推文数 | | similarityThreshold | number | 0.9 | 近似重复的相似度阈值 | | statePath | string | ~/.openclaw/state/x-timeline-digest.json | 状态文件路径 | --- ## 依赖 - 必须安装 bird 且在 PATH 中可用 - 必须已完成 bird 认证（Cookie 登录） - 仅限读取使用
## 使用方法
### 1. 基础（原始 JSON） 运行摘要生成器以获取干净、去重后的 JSON 负载： ```bash node skills/x-timeline-digest/digest.js ```
### 2. 智能摘要（推荐） 生成“智能简报”（已分类、已总结、已降噪）： 1. 运行脚本：`node skills/x-timeline-digest/digest.js > digest.json` 2. 读取提示词模板：`read skills/x-timeline-digest/PROMPT.md` 3. 将提示词发送给您的 LLM，在 `{{JSON_DATA}}` 处注入 `digest.json` 的内容。
*注意：脚本在输出 JSON 之前会自动应用启发式过滤（移除“gm”、广告、短垃圾信息）。*
## 使用的 Bird 命令 For You 时间线： bird home -n <N> --json Following 时间线： bird home --following -n <N> --json --- ## 状态管理 状态持久化存储于 statePath。 ### 状态结构 { "lastRunAt": "2026-02-01T00:00:00+08:00", "sentTweetIds": { "123456789": "2026-02-01T00:00:00+08:00" } } ### 规则 - 已在 sentTweetIds 中的推文不得再次包含 - 成功运行后： - 更新 lastRunAt - 将推送的推文 ID 添加到 sentTweetIds - 保留 ID 至少 30 天 --- ## 处理流水线 1. 从 For You 和 Following 获取 2. 使用 lastRunAt 进行增量过滤 3. 按推文 ID 进行硬去重 4. 使用文本相似度进行近似合并 5. 排序并裁剪至 maxItemsPerDigest 6. 总结为中文摘要 --- ## 输出 该技能返回一个 JSON 对象： { "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"] } ] }