Pull RSS and Atom feeds into ɳClaw, summarize every article with AI, and get breaking-news alerts when topics you care about hit the wire. Ask ɳClaw "what happened in AI today" and it answers from your private news store.
claw-news requires nself-ai for summarization and topic classification. nself-notify is optional for push/SMS breaking alerts.
nself license set nself_pro_xxxxx
nself plugin install ai claw-news
nself build && nself startclaw-news polls RSS and Atom feeds on a configurable schedule. Each ingested article is sent to the ai plugin, which produces a plain-language summary, assigns a topic label, and scores sentiment. Articles land in Postgres with full-text indexes — ɳClaw queries them as a tool when you ask about current events.
Breaking-news alerts let you define topics by keyword. When a matching article arrives, claw-news fires an alert through the notify plugin — push notification, SMS, or Slack — so you hear about important stories immediately. Alert deduplication prevents repeat notifications for the same story.
A daily digest job rolls the most relevant articles per user into a single AI-generated markdown summary. Pair with the cron plugin to deliver it to your inbox or Telegram at a fixed time each morning.
| Variable | Required | Default | Description |
|---|---|---|---|
DATABASE_URL | Yes | — | PostgreSQL connection string (set by nself automatically) |
PORT | No | 3718 | Plugin listen port |
PLUGIN_AI_INTERNAL_URL | No | http://plugin-ai:3401 | Internal URL of nself-ai (required for summarization) |
PLUGIN_NOTIFY_URL | No | — | Internal URL of nself-notify (required for breaking-news push alerts) |
| Method | Path | Description |
|---|---|---|
| GET | /health | Liveness probe |
| GET | /articles | List and search articles (filter: topic, date range, source, sentiment) |
| GET | /articles/:id | Get one article with AI summary and sentiment score |
| GET | /sources | List configured RSS / Atom sources |
| POST | /sources | Register a new feed (name, url, poll interval in seconds) |
| DELETE | /sources/:id | Remove a feed source |
| GET | /topics | List user-defined topics |
| POST | /topics | Create a topic (keywords, alert threshold, notify channel) |
| DELETE | /topics/:id | Delete a topic |
| GET | /alerts | List recent fired alerts with delivery status |
| POST | /alerts | Manually fire an alert for a topic |
| PATCH | /alerts/:id | Update alert status (mark read, snooze) |
| DELETE | /alerts/:id | Delete an alert record |
| GET | /digest | Generate AI digest for a time window (returns markdown) |
| GET | /news/metrics | Ingestion stats — articles per day, source health, alert counts |
| GET | /config | Current plugin configuration |
| PUT | /config | Update plugin configuration |
| Event | When it fires |
|---|---|
article.created | New article ingested from an RSS feed |
article.summarized | AI summary generated for an article |
alert.fired | Breaking-news alert triggered for a matching topic |
digest.generated | Daily digest produced by the scheduled job |
| Table | Purpose |
|---|---|
np_news_sources | RSS / Atom feed definitions with poll interval and last-fetch timestamp |
np_news_articles | Ingested articles with original content, AI summary, topic label, sentiment score |
np_news_topics | User-defined topics with keywords, alert threshold, notify channel config |
np_news_alerts | Fired alert records with dedupe state and delivery status |
All tables use source_account_id for multi-app isolation.
claw-news registers its tool surface with the claw plugin at startup. No extra configuration is needed. Once running, ɳClaw can answer news queries from your private article store:
You: What happened in AI today?
ɳClaw: Here are the top 5 AI stories from your feeds in the last 24 hours...
You: Set up an alert for "AI regulation" news
ɳClaw: Created topic "AI regulation" with keywords [AI regulation, EU AI Act, AI safety].
I'll notify you via Telegram when matching articles arrive.
You: Send me a morning digest at 7am
ɳClaw: I'll pair claw-news with cron to deliver a daily briefing to your Telegram at 7:00 AM.curl -X POST https://api.example.com/news/sources \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Hacker News",
"url": "https://hnrss.org/frontpage",
"poll_interval_seconds": 600
}'curl -X POST https://api.example.com/news/topics \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "AI policy",
"keywords": ["AI regulation", "AI safety act", "EU AI"],
"alert_threshold": 1
}'| Feature | claw-news | Feedly AI / Inoreader |
|---|---|---|
| Data ownership | Your Postgres instance | Vendor servers |
| Ask in natural language | Yes — via ɳClaw | No |
| AI summaries | Every article, via nself-ai | Paid tier (Leo AI) |
| Breaking alerts | Yes — keyword topics + notify plugin | Yes (paid tier) |
| Cost | $0.99/mo (ɳClaw bundle) | $6–$10/mo |
| Issue | Fix |
|---|---|
| Articles not appearing | Check /news/metrics for feed poll errors; verify the source URL returns valid RSS/Atom |
| Summaries missing | Verify PLUGIN_AI_INTERNAL_URL is reachable from the claw-news container |
| Alerts not firing | Confirm PLUGIN_NOTIFY_URL is set and the notify plugin is running |
| ɳClaw can't find news tools | Restart the claw plugin after installing claw-news so it re-fetches the tool manifest |
nself plugin remove claw-newsPort: 3718 | Bundle: ɳClaw ($0.99/mo) or ɳSelf+ ($3.99/mo) | Requires: nself-ai | Last Updated: May 2026 | Plugin Version 1.1.1