Xpersona
T

topic-monitor

CLAWHUB · Unverified

Monitor topics of interest and proactively alert when important developments occur. Use when the user wants automated monitoring of specific subjects like product releases, news topics, technology updates, RSS/Atom feeds, or GitHub releases. Supports scheduled web search plus feed polling, boolean topic filters, AI importance scoring with sentiment tracking, smart alerts vs weekly digests, and memory-aware contextual summaries.

62
Rank
84
Safety
12k
Downloads

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 11.8K downloads reported by the source. Last updated 11/16/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Install and run

Setup complexity: low.

clawhub skill install s177f7tydbpq0gh2sctd8hqdjn83fnwv:topic-monitor
  1. Install using `clawhub skill install s177f7tydbpq0gh2sctd8hqdjn83fnwv:topic-monitor` in an isolated environment before connecting it to live workloads.
  2. No published capability contract is available yet, so validate auth and request/response behavior manually.
  3. Review the upstream CLAWHUB listing at https://clawhub.ai/robbyczgw-cla/topic-monitor before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-robbyczgw-cla-topic-monitor--monitor-2/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

159,164 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: topic-monitor
version: 1.6.0
description: Monitor topics of interest and proactively alert when important developments occur. Use when the user wants automated monitoring of specific subjects like product releases, news topics, technology updates, RSS/Atom feeds, or GitHub releases. Supports scheduled web search plus feed polling, boolean topic filters, AI importance scoring with sentiment tracking, smart alerts vs weekly digests, and memory-aware contextual summaries.
metadata:
  openclaw:
    requires:
      bins: ["python3"]
    envVars:
      - name: TOPIC_MONITOR_TELEGRAM_ID
        required: false
        description: "Telegram chat ID for alerts."
      - name: TOPIC_MONITOR_DATA_DIR
        required: false
        description: "Data directory. Defaults to .data/ in the skill directory."
      - name: WEB_SEARCH_PLUS_PATH
        required: false
        description: "Path to web-search-plus. Defaults to a relative path."
    note: "All environment variables are optional. Defaults work out of the box."
---

# Topic Monitor

Monitor topics continuously and alert only when something looks relevant.

## What’s new in v1.5.0

- **RSS/Atom feed monitoring** as a first-class source via `feeds`
- **GitHub release monitoring** via `github_repos` → `https://github.com/{owner}/{repo}/releases.atom`
- **Feed auto-discovery** from normal URLs
- **OPML import** for feed lists
- **Advanced filters** with `required_keywords` and `exclude_keywords`
- **Sentiment analysis** on findings: `positive`, `negative`, `neutral`, `mixed`
- **Sentiment shift alerts** with `alert_on_sentiment_shift`

## Quick start

```bash
python3 scripts/quick.py "AI Model Releases"
python3 scripts/quick.py "OpenClaw Releases" --github-repos "openclaw/openclaw"
python3 scripts/quick.py "Security Advisories" --feeds "https://example.com/security.xml"
```

Then test it:

```bash
python3 scripts/monitor.py --dry-run --verbose
```

## Core model

Each topic can mix multiple sources:

- **Web search** via `query`
- **RSS/Atom feeds** via `feeds`
- **GitHub releases** via `github_repos`

All collected results flow into the same pipeline:

1. gather results
2. deduplicate
3. apply advanced filters
4. score importance
5. classify sentiment
6. alert immediately or save for digest
7. track state and sentiment history

## Topic config

Each topic supports these keys:

- `id`
- `name`
- `query`
- `keywords`
- `feeds`
- `github_repos`
- `required_keywords`
- `exclude_keywords`
- `frequency` → `hourly|daily|weekly`
- `importance_threshold` → `high|medium|low`
- `channels`
- `context`
- `alert_on`
- `alert_on_sentiment_shift`
- `ignore_sources`
- `boost_sources`

### Example config

```json
{
  "topics": [
    {
      "id": "openclaw-news",
      "name": "OpenClaw Updates",
      "query": "OpenClaw AI assistant update release",
      "keywords": ["OpenClaw", "release", "update"],
      "feeds": ["https://example.com/blog/rss.xml"],
      "github_repos": ["openclaw/openclaw"],
      "requ

README.md

# Topic Monitor
> ⭐ **Featured on DigitalOcean** — Listed as `proactive-research` in [DigitalOcean's OpenClaw Skills guide](https://www.digitalocean.com/resources/articles/what-are-openclaw-skills) (February 2026)


**Never miss what matters. Get alerted when it happens.**

Topic Monitor transforms your assistant from reactive to proactive by continuously monitoring topics you care about and intelligently alerting you only when something truly important occurs.

## Features

- 🔍 **Automated Monitoring** - Scheduled web searches for your topics
- 🧠 **AI Importance Scoring** - Smart filtering: alert vs digest vs ignore
- 📱 **Multi-Channel Alerts** - Telegram, Discord, Email (agent-delivered)
- 📊 **Weekly Digests** - Curated summaries of interesting findings
- 🧩 **Memory Integration** - Contextual alerts referencing your past conversations
- ⚡ **Rate Limiting** - Prevent alert fatigue
- 🎯 **Custom Conditions** - Fine-tune when to alert

## Quick Start

### Option 1: Interactive Setup (Recommended)

Run the setup wizard for a guided experience:

```bash
python3 scripts/setup.py
```

The wizard asks friendly questions about what you want to monitor and creates your config automatically.

### Option 2: Manual Setup

```bash
# 1. Copy the template
cp config.example.json config.json

# 2. Add your first topic
python3 scripts/manage_topics.py add "AI Models" \
  --query "new AI model release announcement" \
  --keywords "GPT,Claude,Llama,release" \
  --frequency daily \
  --importance high \
  --channels telegram

# 3. Test it
python3 scripts/manage_topics.py test ai-models

# 4. Set up automated monitoring
python3 scripts/setup_cron.py
```

## Use Cases

### 📈 Price Monitoring
Track product prices, SaaS pricing changes, or market trends with alerts on significant changes.

### 🔧 Product Updates
Monitor software releases, patches, and feature announcements.

### 📰 News Tracking
Stay updated on specific topics without drowning in noise.

### 🏢 Competitor Analysis
Track competitor product launches, funding, and news.

### 🎓 Research Papers
Monitor arXiv, GitHub, or academic publications in your field.

## How It Works

1. **Configure Topics** - Define what to monitor and when to alert
2. **Scheduled Checks** - Cron jobs run searches at your chosen frequency
3. **AI Scoring** - Each result is scored for importance
4. **Smart Alerting** - High priority → immediate alert, Medium → digest, Low → ignore
5. **Deduplication** - Never get the same alert twice

## Configuration

See [SKILL.md](SKILL.md) for complete documentation.

### Example Topic

```json
{
  "id": "ai-breakthroughs",
  "name": "AI Research Breakthroughs",
  "query": "artificial intelligence breakthrough research",
  "keywords": ["AI", "LLM", "transformer", "AGI"],
  "frequency": "daily",
  "importance_threshold": "medium",
  "channels": ["telegram"],
  "context": "Following AI developments for work",
  "alert_on": ["major_paper", "model_release"]
}
```

## Commands

### Manage Topics

_meta.json

{
  "ownerId": "kn73gpe8xz2630jrknkb3ya96h7zb84h",
  "slug": "topic-monitor",
  "version": "1.6.0",
  "publishedAt": 1788193955167
}

scripts/_vendor/feedparser-6.0.12.dist-info/licenses/LICENSE

feedparser and its unit tests are released under the following license:

----- begin license block -----

Copyright (C) 2010-2025 Kurt McKee <contactme@kurtmckee.org>
Copyright (C) 2002-2008 Mark Pilgrim
All rights reserved.

Redistribution and use in source and binary forms, with or without modification,
are permitted provided that the following conditions are met:

* Redistributions of source code must retain the above copyright notice,
  this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright notice,
  this list of conditions and the following disclaimer in the documentation
  and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 'AS IS'
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.

----- end license block -----





The feedparser documentation (everything in the docs/ directory) is
released under the following license:

----- begin license block -----

Copyright (C) 2010-2025 Kurt McKee <contactme@kurtmckee.org>
Copyright (C) 2004-2008 Mark Pilgrim. All rights reserved.

Redistribution and use in source (Sphinx ReST) and "compiled" forms (HTML, PDF,
PostScript, RTF and so forth) with or without modification, are permitted
provided that the following conditions are met:

* Redistributions of source code (Sphinx ReST) must retain the above copyright
  notice, this list of conditions and the following disclaimer.
* Redistributions in compiled form (converted to HTML, PDF, PostScript, RTF and
  other formats) must reproduce the above copyright notice, this list of
  conditions and the following disclaimer in the documentation and/or other
  materials provided with the distribution.

THIS DOCUMENTATION IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 'AS IS'
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TOR

scripts/_vendor/feedparser-6.0.12.dist-info/top_level.txt

feedparser

Sponsored

Ads related to topic-monitor and adjacent AI workflows.