A powerful bridge between your self-hosted FreshRSS instance and your AI agent for streamlined news consumption.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install freshrss-reader
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install freshrss-reader using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is FreshRSS?
The FreshRSS skill for Openclaw Skills enables users to interact directly with their self-hosted RSS reader through a Google Reader compatible API. It empowers developers and power users to fetch the latest headlines, filter content by category or timeframe, and manage unread articles without leaving their terminal or agent interface. By leveraging Openclaw Skills, you can turn your RSS aggregator into a searchable, queryable knowledge base for your AI workflows.
FreshRSS Use Cases
- Get a summary of the latest technology news from the last 2 hours.
- Filter unread articles from specific categories like Finance or DevOps.
- Automate news briefings by fetching headlines from preferred sources.
- Browse feeds and categories to stay updated on self-hosted content.
How FreshRSS Works
- Connects to the FreshRSS instance using the Google Reader compatible API and provided credentials.
- Authenticates via environment variables to ensure secure access to private RSS data.
- Executes shell commands to retrieve feeds, categories, or specific headlines based on user-defined parameters.
- Parses the API response into a readable format containing dates, sources, titles, and direct URLs.
FreshRSS Setup
To get started with this skill in the Openclaw Skills ecosystem, set the following environment variables:
export FRESHRSS_URL="https://your-freshrss-instance.com"
export FRESHRSS_USER="your-username"
export FRESHRSS_API_PASSWORD="your-api-password"
Note: The API password is found in your FreshRSS settings under Profile -> API Management.
FreshRSS Data Schema & Taxonomy
The skill organizes data retrieved from the FreshRSS API into standardized text outputs.
| Field | Description |
|---|---|
| Date | The publication timestamp of the article. |
| Source | The name of the RSS feed providing the content. |
| Title | The headline of the article. |
| URL | The direct link to the original source. |
| Categories | A comma-separated list of associated labels. |
FreshRSS Advanced Features
- Relative time filtering using the
--hoursflag for real-time updates. - Granular control over the number of results with the
--countparameter. - Integrated unread status filtering to focus on new content.
- Case-sensitive category matching for precise organizational control.
SKILL.md
Loading
Related Openclaw Skills
Pinch to Post (WP Pinch)
A comprehensive suite of 54 MCP tools to manage WordPress content, media, and site health directly from your AI agent.
claw-me-maybe
A unified messaging skill for Clawdbot that integrates with the Beeper Desktop API to manage chats across multiple platforms from a single interface.
Fundamental Stock Analysis
A structured equity analysis tool that scores and ranks stocks using a comprehensive fundamental playbook.
Robonet Workbench
A comprehensive MCP-powered toolkit for building, optimizing, and deploying automated trading strategies across crypto and prediction markets.
Karakeep Bookmark Manager
A streamlined integration for saving bookmarks and notes to a private, self-hosted Karakeep instance directly from your development environment.
NocoDB
Manage NocoDB bases, tables, and records through a powerful REST API integration for AI agents.
Featured*
