Go back
More in category Open on GitHub

Jump to related tools in the same category or review the original source on GitHub.

Self-Hosted & Automation @nickian Updated 1/28/2026

Freshrss Reader OpenClaw Plugin & Skill | ClawHub

Looking to integrate Freshrss Reader into your AI workflows? This free OpenClaw plugin from ClawHub helps you automate self-hosted & automation tasks instantly, without having to write custom tools from scratch.

What this skill does

Query headlines and articles from a self-hosted FreshRSS instance. Use when the user asks for RSS news, latest headlines, feed updates, or wants to browse articles from their FreshRSS reader. Supports filtering by category, time range, and count.

Install

npx clawhub@latest install freshrss-reader

Full SKILL.md

Open original
Metadata table.
namedescription
freshrssQuery headlines and articles from a self-hosted FreshRSS instance. Use when the user asks for RSS news, latest headlines, feed updates, or wants to browse articles from their FreshRSS reader. Supports filtering by category, time range, and count.

SKILL.md content below is scrollable.

FreshRSS

Query headlines from a self-hosted FreshRSS instance via the Google Reader compatible API.

Setup

Set these environment variables:

export FRESHRSS_URL="https://your-freshrss-instance.com"
export FRESHRSS_USER="your-username"
export FRESHRSS_API_PASSWORD="your-api-password"

API password is set in FreshRSS → Settings → Profile → API Management.

Commands

Get latest headlines

{baseDir}/scripts/freshrss.sh headlines --count 10

Get headlines from the last N hours

{baseDir}/scripts/freshrss.sh headlines --hours 2

Get headlines from a specific category

{baseDir}/scripts/freshrss.sh headlines --category "Technology" --count 15

Get only unread headlines

{baseDir}/scripts/freshrss.sh headlines --unread --count 20

Combine filters

{baseDir}/scripts/freshrss.sh headlines --category "News" --hours 4 --count 10 --unread

List categories

{baseDir}/scripts/freshrss.sh categories

List feeds

{baseDir}/scripts/freshrss.sh feeds

Output

Headlines are formatted as:

[date] [source] Title
  URL
  Categories: cat1, cat2

Notes

  • Default count is 20 headlines if not specified
  • Time filtering uses --hours for relative time (e.g., last 2 hours)
  • Category names are case-sensitive and must match your FreshRSS categories
  • Use categories command first to see available category names
Original Repository URL: https://github.com/openclaw/skills/blob/main/skills/nickian/freshrss-reader
Latest commit: https://github.com/openclaw/skills/commit/73541fc770b368feabdf1fe7790b52995260f819

Related skills

If this matches your use case, these are close alternatives in the same category.

beacon

Agent-to-agent protocol for social coordination, crypto payments, and P2P mesh.

bridle

Unified configuration manager for AI coding assistants. Manage profiles, install skills/agents/commands, and switch configurations across Claude Code, OpenCode, Goose, and Amp.

casual-cron

Create Clawdbot cron jobs from natural language with strict run-guard rules. Use when: users ask to schedule reminders or messages (recurring or one-shot), especially via Telegram, or when they use /at or /every. Examples: 'Create a daily reminder at 8am', 'Remind me in 20 minutes', 'Send me a Telegram message at 3pm', '/every 2h'.

claw-sync

Secure sync for OpenClaw memory and workspace. Use /sync to push, /restore to pull, /sync-status to check. Supports versioned backups and disaster recovery.

cron-backup

Set up scheduled automated backups with version tracking and cleanup. Use when users need to (1) Schedule periodic backups of directories or files, (2) Monitor version changes and backup on updates, (3) Automatically clean up old backups to save space, (4) Create backup strategies for configuration files, code repositories, or user data.

cron-retry

Auto-retry failed cron jobs on connection recovery. Use when cron jobs fail due to network errors and should be retried when connectivity is restored. Integrates with heartbeat to detect failed jobs and re-run them automatically.