Miniflux News：RSS 分选与 AI 摘要 - Openclaw Skills

什么是 Miniflux News？

Miniflux News 技能通过 Openclaw Skills 将您的个人 RSS 聚合器直接集成到 AI 工作流中。它允许您查询 Miniflux 实例中的未读条目，检索文章全文，并在不离开智能体环境的情况下进行智能分选。通过利用 Miniflux REST API，该技能在您精心策划的新闻源与 AI 驱动的内容分析之间架起了一座无缝桥梁，使其成为 Openclaw Skills 集合中不可或缺的一部分。

下载入口:https://github.com/openclaw/skills/tree/main/skills/hartlco/miniflux-news

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install miniflux-news

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 miniflux-news。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

Miniflux News 应用场景

• 按类别过滤的未读 RSS 项目快速每日简报。
• 将复杂的专业技术文章或新闻报告总结为可操作的要点。
• 分选海量新闻源以识别关键更新。
• 通过 AI 辅助审查后将条目标记为已读，从而组织和清理未读队列。

Miniflux News 工作原理

1. 技能使用提供的 API 令牌和基础 URL 与您的 Miniflux 实例进行身份验证。
2. 它查询 Miniflux API 以获取未读条目列表或通过 ID 获取特定项目。
3. 技能检索文章全文（HTML 或文本），为 AI 智能体提供充足的上下文进行分析。
4. 利用 Openclaw Skills 逻辑，智能体根据用户定义的特定规则生成简洁的摘要。
5. 分选操作（如将项目标记为已读）通过明确的用户命令执行，以实现精确控制。

Miniflux News 配置指南

要在您的 Openclaw Skills 环境中开始使用此技能，请配置您的凭据：

1. 在 ~/.config/clawdbot/miniflux-news.json 创建配置文件：

{
  "url": "https://your-miniflux.example",
  "token": "your-api-token"
}

2. 或者，使用随附的 Python 脚本配置技能：

python3 skills/miniflux-news/scripts/miniflux.py configure --url "https://your-miniflux.example" --token "your-api-token"

3. 您也可以设置环境变量进行临时覆盖：

export MINIFLUX_URL="https://your-miniflux.example"
export MINIFLUX_TOKEN="your-api-token"

Miniflux News 数据架构与分类体系

Miniflux News 技能通过 Openclaw Skills 中的以下结构管理数据：

数据组件	描述
配置文件	在 ~/.config/clawdbot/miniflux-news.json 存储 url 和 token。
条目元数据	包括用于列表显示的 id、title、url 和 feed_title。
内容负载	获取全文 content 或 snippet 用于摘要任务。
类别	检索类别名称和 ID 列表，用于定向过滤。

name: miniflux-news
description: Fetch and triage the latest unread RSS/news entries from a Miniflux instance via its REST API using an API token. Use when the user asks to get the latest Miniflux unread items, list recent entries with titles/links, or generate short summaries of specific Miniflux entries. Includes a bundled script to query Miniflux (/v1/entries and /v1/entries/{id}) using credentials from ~/.config/clawdbot/miniflux-news.json (or MINIFLUX_URL and MINIFLUX_TOKEN overrides).

Miniflux News

Use the bundled script to fetch entries, then format a clean list and optionally write summaries.

Setup (credentials)

This skill reads Miniflux credentials from a local config file by default.

Config file (recommended)

Path:

• ~/.config/clawdbot/miniflux-news.json

Format:

{
  "url": "https://your-miniflux.example",
  "token": ""
}

Create/update it using the script:

python3 skills/miniflux-news/scripts/miniflux.py configure r
  --url "https://your-miniflux.example" r
  --token ""

Environment variables (override)

You can override the config file (useful for CI):

export MINIFLUX_URL="https://your-miniflux.example"
export MINIFLUX_TOKEN=""

Token scope: Miniflux API token with read access.

Fetch latest entries

List latest unread items (default):

python3 skills/miniflux-news/scripts/miniflux.py entries --limit 20

Filter by category (by name):

python3 skills/miniflux-news/scripts/miniflux.py entries --category "News" --limit 20

If you need machine-readable output:

python3 skills/miniflux-news/scripts/miniflux.py entries --limit 50 --json

Response formatting

• Return a tight bullet list: [id] title — feed + link.
• Ask how many the user wants summarized (e.g., “summarize 3” or “summarize ids 123,124”).

View full content

Show the full article content stored in Miniflux (useful for reading or for better summaries):

python3 skills/miniflux-news/scripts/miniflux.py entry 123 --full --format text

If you want the raw HTML as stored by Miniflux:

python3 skills/miniflux-news/scripts/miniflux.py entry 123 --full --format html

Categories

List categories:

python3 skills/miniflux-news/scripts/miniflux.py categories

Mark entries as read (explicit only)

This skill must never mark anything as read implicitly. Only do it when the user explicitly asks to mark specific ids as read.

Mark specific ids as read:

python3 skills/miniflux-news/scripts/miniflux.py mark-read 123 124 --confirm

Mark all unread entries in a category as read (still explicit, requires --confirm; includes a safety --limit):

python3 skills/miniflux-news/scripts/miniflux.py mark-read-category "News" --confirm --limit 500

Summarize entries

Fetch full content for a specific entry id (machine-readable):

python3 skills/miniflux-news/scripts/miniflux.py entry 123 --json

Summarization rules:

• Prefer 3–6 bullets max.
• Lead with the “so what” in 1 sentence.
• If content is empty or truncated, say so and summarize from title + available snippet.
• Don’t invent facts; quote key numbers/names if present.

Troubleshooting

• If the script says missing credentials: set MINIFLUX_URL/MINIFLUX_TOKEN or create ~/.config/clawdbot/miniflux-news.json.
• If you get HTTP 401: token is wrong/expired.
• If you get HTTP 404: base URL is wrong (should be the Miniflux web root).