use-clawrss

# 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`, `openclaw_rss_delete_feed` - web results and article records: `web_search`, `openclaw_rss_ingest`, `openclaw_rss_pull`, `openclaw_rss_mark` - digests: `openclaw_rss_save_digest`, `openclaw_rss_pull_digests`, `openclaw_rss_get_digest`, `openclaw_push_notify_digest` - generic push: `openclaw_push_get_status`, `openclaw_push_notify` 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. 2. Call `openclaw_rss_upsert_feed`. 3. Call `openclaw_rss_list_feeds` with the same `namespace`. 4. Confirm success only if the feed appears in the list result. For remove requests: 1. Use the exact stored feed URL when possible. 2. Call `openclaw_rss_delete_feed`. 3. 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. 2. Normalize results into `title`, `url`, `kind`, `snippet`, and optional `sourceHost`, `score`, `publishedAt`. 3. Default `kind` to `article`. Use `rss` only for confirmed feed URLs. 4. Call `openclaw_rss_ingest`. 5. 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`. 2. Use `openclaw_rss_pull_digests` to list saved digests. 3. Use `openclaw_rss_get_digest` to read a specific digest. 4. 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.