← Back to Skills Marketplace
robbyczgw-cla

topic-monitor

by Robby · GitHub ↗ · v1.6.0 · MIT-0
cross-platform ✓ Security Clean
11117
Downloads
27
Stars
0
Active Installs
17
Versions
Install in OpenClaw
/install topic-monitor
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.
Usage Guidance
Install only if you are comfortable with your configured topics, queries, feed URLs, and GitHub repositories being sent to the relevant search providers and feed hosts. Keep WEB_SEARCH_PLUS_PATH pointed at a trusted local script, avoid importing untrusted OPML/feed lists, and choose a TOPIC_MONITOR_DATA_DIR location appropriate for locally stored findings and alert history.
Capability Assessment
Credentials
Environment variables for Telegram target, data directory, search provider keys, and WEB_SEARCH_PLUS_PATH are disclosed and purpose-aligned; the configurable search helper path is a local execution surface users should keep pointed at a trusted script.
Install Mechanism
The package exposes manual Python scripts; setup writes config.json, and setup_cron.py emits cron JSON for the agent rather than directly modifying crontab.
Instruction Scope
The runtime instructions are mostly scoped to user-configured topics, feeds, repositories, and alert channels, but the README privacy language understates that feed discovery and feed polling make direct network requests to configured URLs.
Persistence & Privilege
The skill persists config, state, findings, feed cache metadata, sentiment history, and alert queues under the skill directory or TOPIC_MONITOR_DATA_DIR, and can be scheduled by user-directed cron configuration; no privilege escalation or destructive behavior was found.
Purpose & Capability
The stated purpose is proactive topic monitoring via web search, RSS/Atom feeds, and GitHub releases; the inspected scripts implement configuration, polling, scoring, digesting, and local alert queues in line with that purpose.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install topic-monitor
  3. After installation, invoke the skill by name or use /topic-monitor
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.6.0
**Skill version 1.6.0 — topic-monitor** - Internal dependency vendoring: Adds `feedparser` and `sgmllib3k` vendor packages under `scripts/_vendor/` for improved feed parsing consistency. - Updates to skill metadata: Environment variable requirements are now clearly structured. - Removes unused files (`package.json`, `skill-card.md`). - Documentation refinements in `SKILL.md` for setup and configuration clarity.
v1.5.2
- Bump version to 1.5.2. - Documentation updates in SKILL.md and CHANGELOG.md. - No functional changes; package and skill metadata updated for release.
v1.5.1
topic-monitor v1.5.1 - Minor update with documentation and metadata improvements. - Updated SKILL.md and package metadata to reflect new version. - No functional changes to code logic.
v1.5.0
v1.5.0 adds feed and GitHub release monitoring, advanced filters, and sentiment tracking. - Added first-class support for monitoring RSS/Atom feeds and GitHub releases as sources per topic - New options: required_keywords and exclude_keywords for advanced boolean result filtering - Sentiment analysis now applied to all findings; supports sentiment shift alerts - Feed auto-discovery and OPML import simplify subscribing to many feeds - All sources (web, feed, GitHub) now unified in one scoring and alerting pipeline
v1.3.5
b70db6d chore: release v1.3.5 1248efa Sync version with ClawHub (v1.3.4) dd4580b security: remove crontab manipulation, sanitize subprocess query input
v1.3.4
Security: setup_cron outputs JSON (no crontab manipulation), query input sanitized.
v1.3.3
Security: sanitized subprocess env (allowlist only), removed direct Discord webhook HTTP calls.
v1.3.2
Fix: SKILL.md metadata updated to openclaw format. Env vars declared as optional.
v1.3.1
Security: removed hardcoded paths (/root/), hardcoded Telegram ID, hardcoded web-search-plus path. All now configurable via env vars or use safe defaults.
v1.3.0
Implemented real alerting (was stub). State files moved to memory/monitors/. Switched to web-search-plus for searches.
v1.2.1
- Added CHANGELOG.md file for improved documentation of changes. - Updated version to 1.2.1 in SKILL.md and package.json. - Minor documentation or metadata updates; no functional changes to core logic.
v1.2.0
**Quick setup for single-topic monitoring added in v1.2.0:** - Introduced `quick.py` for instant, one-command topic monitoring with sensible defaults. - Added "Quick Start" instructions and comparison table to documentation. - No changes to existing setup or core monitoring processes. - Improvements to SKILL.md for clarity and ease of onboarding.
v1.1.2
Add ClawHub runtime requirements metadata (SKILL.md frontmatter)
v1.1.1
Add runtime requirements metadata for ClawHub discovery
v1.1.0
Version 1.1.0 - Added interactive setup wizard (`scripts/setup.py`) for first-time configuration. - Included `skill.json` to define skill metadata. - Updated documentation to guide users through the new setup wizard and quick start methods. - Streamlined onboarding by prompting new users to configure topics and preferences interactively. - No changes to core monitoring logic or alerting features.
v1.0.1
- Renamed the skill from "proactive-research" to "topic-monitor" throughout documentation. - Updated all branding and references in commands, examples, file paths, and cron setup to reflect the new skill name. - No changes to features or functionality—documentation updates only. - All usage instructions and configuration samples remain unchanged except for the updated name.
v1.0.0
Automated topic monitoring with AI importance scoring
Metadata
Slug topic-monitor
Version 1.6.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 17
Frequently Asked Questions

What is topic-monitor?

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. It is an AI Agent Skill for Claude Code / OpenClaw, with 11117 downloads so far.

How do I install topic-monitor?

Run "/install topic-monitor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is topic-monitor free?

Yes, topic-monitor is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does topic-monitor support?

topic-monitor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created topic-monitor?

It is built and maintained by Robby (@robbyczgw-cla); the current version is v1.6.0.

💬 Comments