Super RSS Agent

在 OpenClaw 中直接管理和消费 RSS 订阅。本 skill 替代传统 RSS 阅读器，提供 AI 驱动的摘要、渐进式阅读、文章追踪和自动化推送。

快速开始

CODEBLOCK0

所有命令均支持 --db <路径> 全局参数指定自定义数据库文件。

CLI 命令

list - 列出订阅

CODEBLOCK1

add - 添加订阅

CODEBLOCK2

Feed 自动发现：输入博客主页 URL 时，代理会自动发现 RSS/Atom 订阅源：

1. 1. 搜索 HTML 中的 <link rel="alternate"> 标签
2. 尝试常见路径：/feed、/rss、/feed.xml、/atom.xml 等

remove - 删除订阅

CODEBLOCK3

update - 更新订阅信息

CODEBLOCK4

scan - 扫描新文章

CODEBLOCK5

扫描器的工作流程：

1. 1. 优先尝试 RSS/Atom 订阅源
2. 如果没有 feed_url，自动发现 Feed 并更新记录
3. 如果配置了 scrape_selector，回退到 HTML 抓取
4. 按 URL 自动去重
5. 将新文章存入数据库
6. 扫描完成后自动清理旧的已读文章（可通过 config 关闭）

articles - 列出文章

CODEBLOCK6

search - 搜索文章

CODEBLOCK7

read / unread - 标记文章状态

CODEBLOCK8

read-all - 全部标记为已读

CODEBLOCK9

check - 健康检查

CODEBLOCK10

fetch - 实时拉取内容

CODEBLOCK11

digest - 每日摘要

CODEBLOCK12

stats - 订阅统计

CODEBLOCK13

显示内容：总订阅数、总文章数、未读数、数据库大小、按分类分组的各源活跃度和未读积压、疑似死源检测。

config - 查看/修改配置

super_rss_agent config                        # 列出所有配置
super_rss_agent config auto_purge false       # 关闭自动清理
super_rss_agent config auto_purge_days 30     # 修改清理天数
super_rss_agent config auto_purge --reset     # 恢复默认值

配置项	默认值	说明
INLINECODE23	INLINECODE24	扫描后是否自动清理旧的已读文章
INLINECODE25

90 | 自动清理多少天前的已读文章 |

purge - 手动清理旧文章

CODEBLOCK15

test - 测试订阅

CODEBLOCK16

执行 5 步诊断：URL 验证 → 连通性测试 → Feed 类型检测 → Feed 自动发现 → 解析并展示样本文章。

export - 导出为 OPML

CODEBLOCK17

import - 从 OPML 导入

CODEBLOCK18

命令速查表

命令	说明	常用参数
INLINECODE31	列出所有订阅	INLINECODE32 分类, -v 详细
INLINECODE34

添加订阅 | -n 名称, -c 分类, --feed-url, --scrape-selector | | remove | 删除订阅 | -y 跳过确认 | | update | 更新订阅信息 | -n 名称, -c 分类, --feed-url, --url | | check | 健康检查 | — | | scan | 扫描新文章 | -w 线程数, -s 静默 | | articles | 列出文章 | -a 含已读, -b 按博客, -c 按分类, -n 每页条数, --offset | | search | 搜索文章 | -a 含已读, -b 按博客, -c 按分类, -n 数量 | | read | 标记已读 | 文章 ID | | unread | 标记未读 | 文章 ID | | read-all | 全部已读 | -b 按博客, -c 按分类, -y 跳过确认 | | fetch | 实时拉取 | -n 条数, -v 详细, --full-content | | digest | 每日摘要 | -d 天数, -n 条数, -c 分类 | | stats | 订阅统计 | --stale-days 死源阈值 | | config | 查看/修改配置 | key, value, --reset | | purge | 清理旧文章 | -d 天数, -b 按博客, --include-unread, -y | | export | 导出 OPML | -o 输出文件 | | import | 导入 OPML | OPML 文件路径 | | test | 测试订阅 | --scrape-selector |

数据存储

• - 数据库：<skill-root>/super_rss_agent.db（SQLite，与 SKILL.md 同级目录）
• 数据表结构：

CODEBLOCK19

• - 文章按 URL 自动去重（UNIQUE 约束）
• 删除博客时，其下所有文章一并删除（CASCADE）
• 配置存储在 config 表中，未修改过的配置项使用代码中的默认值

定时自动化（Cron）

通过 OpenClaw 的 cron 工具定时执行 RSS 更新：

扫描 + 摘要示例

CODEBLOCK20

代理执行流程

当被要求检查 RSS 订阅时，代理会：

1. 1. 执行 python3 scripts/super_rss_agent.py scan 拉取并存储新文章
2. 执行 python3 scripts/super_rss_agent.py articles --category <分类> 列出未读
3. 如有需要，使用 web_fetch 获取文章全文
4. 生成摘要并格式化输出
5. 执行 python3 scripts/super_rss_agent.py read-all -y 将已处理的文章标记为已读

全文提取

部分 RSS 订阅源通过 content:encoded（RSS 2.0）或 content（Atom）字段提供文章全文。使用 --full-content 参数可直接提取并阅读：

CODEBLOCK21

工作原理：

• - RSS 2.0 带 content:encoded 字段 → 可获取全文
• Atom 带 content 字段 → 可获取全文
• 仅有 description/summary → 只能获取摘要

说明：

• - 全文提取会自动去除 HTML 标签，提升可读性
• 对于不提供全文的订阅源，可使用 web_fetch 或 browser 工具作为备选

渐进式阅读

本 skill 支持三级渐进式阅读：

第 1 层 - 标题速览：通过 super_rss_agent articles 快速浏览
第 2 层 - 摘要概述：代理通过 super_rss_agent fetch 总结感兴趣的文章
第 3 层 - 全文阅读：使用 super_rss_agent fetch --full-content 或 web_fetch 获取完整文章

交互示例：
CODEBLOCK22

自动清理机制

每次执行 scan 命令后，系统会自动清理超过 auto_purge_days 天的已读文章（仅已读，未读文章不受影响）。清理结果在非静默模式下打印一行提示。可通过 config auto_purge false 关闭。手动清理使用 purge 命令。

文件结构

CODEBLOCK23

使用技巧

• - 定期执行 super_rss_agent scan（或通过 cron 自动执行）保持文章列表最新
• 使用 super_rss_agent articles 快速查看新内容收件箱
• 使用 super_rss_agent search 按关键词快速检索文章
• 使用 super_rss_agent stats 查看订阅统计和死源检测
• 使用 super_rss_agent check 定期清理失效的订阅源
• 使用 super_rss_agent test <url> 在添加前测试 URL 是否可订阅
• 善用分类功能，按主题组织订阅，实现精准阅读
• 对没有 RSS 的网站，添加时设置 --scrape-selector 进行 HTML 抓取
• 配合 tts 工具可实现语音新闻播报
• 对 web_fetch 无法访问的复杂网站，使用 browser 工具
• 优先尝试 super_rss_agent fetch --full-content，比 web_fetch 更快（对支持的订阅源）