Use ClawRSS
Use this skill when the user wants to work with ClawRSS after the plugin is installed.
Typical requests:
- - add, list, or remove RSS feeds
- search the web and save results into ClawRSS
- pull saved RSS/article items and mark a cursor consumed
- save, list, read, or push digest articles
- send a short Apple push notification through the configured ClawRSS push target
Required workspace rule
ClawRSS is workspace-based.
- - Reuse the exact workspace ID as
namespace for every ClawRSS tool call. - For
openclaw_rss_pull and openclaw_rss_mark, use that same value as both namespace and consumer. - If the workspace ID is missing and cannot be inferred from the current ClawRSS context, ask for it before writing.
Tool mapping
Use these tools for the matching data type:
- - feeds:
openclaw_rss_upsert_feed, openclaw_rss_list_feeds, INLINECODE7 - web results and article records:
web_search, openclaw_rss_ingest, openclaw_rss_pull, INLINECODE11 - digests:
openclaw_rss_save_digest, openclaw_rss_pull_digests, openclaw_rss_get_digest, INLINECODE15 - generic push:
openclaw_push_get_status, INLINECODE17
Do not confuse feeds, article records, and digest records.
- - Do not call only
openclaw_rss_ingest and then say a feed was subscribed. - Do not use
openclaw_rss_save_digest for normal article search results. - Do not claim push delivery succeeded if push is not configured.
Feed workflow
For add or subscribe requests:
- 1. Determine the real RSS or Atom feed URL.
- Call
openclaw_rss_upsert_feed. - Call
openclaw_rss_list_feeds with the same namespace. - Confirm success only if the feed appears in the list result.
For remove requests:
- 1. Use the exact stored feed URL when possible.
- Call
openclaw_rss_delete_feed. - Re-list feeds if the user expects verification.
If the user gives only a normal website page and you cannot confirm a real feed URL, say it was not subscribed yet.
Search plus persistence workflow
For latest, trending, breaking, or web-fresh information:
- 1. Search the web first.
- Normalize results into
title, url, kind, snippet, and optional sourceHost, score, publishedAt. - Default
kind to article. Use rss only for confirmed feed URLs. - Call
openclaw_rss_ingest. - If the user also wants to follow a confirmed feed URL, separately call
openclaw_rss_upsert_feed.
Pull and mark workflow
For sync or "show what is stored" requests:
- - Call
openclaw_rss_pull with the workspace as both namespace and consumer. - Use
cursor = null unless the user provides a checkpoint. - Use
kind = "all" unless the user explicitly wants only rss or only article.
For acknowledge or completion requests:
- - Call
openclaw_rss_mark only when the user wants to mark a pulled cursor as consumed. - Reuse the same workspace value as both
namespace and consumer.
Digest workflow
For summaries or scheduled reports:
- 1. Call
openclaw_rss_save_digest with jobID, scheduledFor, title, bodyRaw, and bodyFormat. - Use
openclaw_rss_pull_digests to list saved digests. - Use
openclaw_rss_get_digest to read a specific digest. - Use
openclaw_push_notify_digest when the user wants the saved digest delivered.
Default digest delivery to background_then_alert unless the user explicitly asks for only background or only alert.
Generic push workflow
Use openclaw_push_notify only for short manual notifications or task completion notices.
- - Keep title and body brief and factual.
- If configuration is uncertain, check
openclaw_push_get_status first. - Prefer
openclaw_push_notify_digest when the notification is about a stored digest article.
Response contract
When you finish, report:
- - workspace used
- tools called
- what was saved, updated, deleted, pulled, marked, or pushed
- what was verified
- any missing user input still required
If the plugin is missing
If the ClawRSS tools are unavailable, tell the user to install or enable the ClawRSS plugin first. Use the standalone install-clawrss skill when available.
使用 ClawRSS
当用户安装插件后想要使用 ClawRSS 时，使用此技能。
典型请求：
- - 添加、列出或删除 RSS 订阅源
- 搜索网页并将结果保存到 ClawRSS
- 拉取已保存的 RSS/文章条目并标记游标已消费
- 保存、列出、阅读或推送摘要文章
- 通过已配置的 ClawRSS 推送目标发送简短的 Apple 推送通知
必需的工作区规则
ClawRSS 基于工作区。
- - 每次调用 ClawRSS 工具时，重复使用确切的工作区 ID 作为 namespace。
- 对于 openclawrsspull 和 openclawrssmark，使用相同的值作为 namespace 和 consumer。
- 如果缺少工作区 ID 且无法从当前 ClawRSS 上下文中推断，请在写入前询问。
工具映射
对匹配的数据类型使用以下工具：
- - 订阅源：openclawrssupsertfeed、openclawrsslistfeeds、openclawrssdeletefeed
- 网页结果和文章记录：websearch、openclawrssingest、openclawrsspull、openclawrssmark
- 摘要：openclawrsssavedigest、openclawrsspulldigests、openclawrssgetdigest、openclawpushnotifydigest
- 通用推送：openclawpushgetstatus、openclawpush_notify
不要混淆订阅源、文章记录和摘要记录。
- - 不要仅调用 openclawrssingest 然后就说已订阅订阅源。
- 不要对普通文章搜索结果使用 openclawrsssave_digest。
- 如果未配置推送，不要声称推送投递成功。
订阅源工作流程
对于添加或订阅请求：
- 1. 确定真实的 RSS 或 Atom 订阅源 URL。
- 调用 openclawrssupsertfeed。
- 使用相同的 namespace 调用 openclawrsslistfeeds。
- 仅当订阅源出现在列表结果中时才确认成功。
对于移除请求：
- 1. 尽可能使用确切的已存储订阅源 URL。
- 调用 openclawrssdelete_feed。
- 如果用户期望验证，则重新列出订阅源。
如果用户只提供普通网站页面且您无法确认真实的订阅源 URL，则说明尚未订阅。
搜索加持久化工作流程
对于最新、热门、突发或网络新鲜信息：
- 1. 首先搜索网页。
- 将结果规范化为 title、url、kind、snippet 以及可选的 sourceHost、score、publishedAt。
- 默认 kind 为 article。仅对已确认的订阅源 URL 使用 rss。
- 调用 openclawrssingest。
- 如果用户还想关注已确认的订阅源 URL，则单独调用 openclawrssupsert_feed。
拉取和标记工作流程
对于同步或显示已存储内容的请求：
- - 使用工作区作为 namespace 和 consumer 调用 openclawrsspull。
- 除非用户提供检查点，否则使用 cursor = null。
- 除非用户明确只想要 rss 或只想要 article，否则使用 kind = all。
对于确认或完成请求：
- - 仅当用户想要将拉取的游标标记为已消费时，才调用 openclawrssmark。
- 重复使用相同的工作区值作为 namespace 和 consumer。
摘要工作流程
对于摘要或定时报告：
- 1. 使用 jobID、scheduledFor、title、bodyRaw 和 bodyFormat 调用 openclawrsssavedigest。
- 使用 openclawrsspulldigests 列出已保存的摘要。
- 使用 openclawrssgetdigest 读取特定摘要。
- 当用户想要投递已保存的摘要时，使用 openclawpushnotifydigest。
默认摘要投递方式为 backgroundthenalert，除非用户明确要求仅 background 或仅 alert。
通用推送工作流程
仅对简短的手动通知或任务完成通知使用 openclawpushnotify。
- - 保持标题和正文简短且基于事实。
- 如果配置不确定，先检查 openclawpushgetstatus。
- 当通知涉及已存储的摘要文章时，优先使用 openclawpushnotifydigest。
响应约定
完成后，报告：
- - 使用的工作区
- 调用的工具
- 已保存、更新、删除、拉取、标记或推送的内容
- 已验证的内容
- 任何仍需的用户输入
如果缺少插件
如果 ClawRSS 工具不可用，告知用户先安装或启用 ClawRSS 插件。可用时使用独立的 install-clawrss 技能。
