← 返回 Skills 市场
ma-star

Clawfeed

作者 Ma-star · GitHub ↗ · v0.1.0
cross-platform ⚠ suspicious
468
总下载
0
收藏
2
当前安装
1
版本数
在 OpenClaw 中安装
/install clawfeed-3
功能描述
AI tool that generates structured news digests from Twitter and RSS feeds with summaries available in 4-hour, daily, weekly, or monthly formats.
使用说明 (SKILL.md)

ClawFeed

AI-powered news digest tool. Automatically generates structured summaries (4H/daily/weekly/monthly) from Twitter and RSS feeds.

Credentials & Dependencies

ClawFeed runs in read-only mode with zero credentials — browse digests, view feeds, switch languages. Authentication features (bookmarks, sources, packs) require additional credentials.

Credential Purpose Required
GOOGLE_CLIENT_ID Google OAuth login For auth features
GOOGLE_CLIENT_SECRET Google OAuth login For auth features
SESSION_SECRET Session cookie encryption For auth features
API_KEY Digest creation endpoint protection For write API

Runtime dependency: SQLite via better-sqlite3 (native addon, bundled). No external database server required.

Setup

# Install dependencies
npm install

# Copy environment config
cp .env.example .env
# Edit .env with your settings

# Start API server
npm start

Environment Variables

Configure in .env file:

Variable Description Required Default
DIGEST_PORT Server port No 8767
GOOGLE_CLIENT_ID Google OAuth client ID For auth -
GOOGLE_CLIENT_SECRET Google OAuth client secret For auth -
SESSION_SECRET Session cookie encryption key For auth -
API_KEY Digest creation API key For write API -
AI_DIGEST_DB SQLite database path No data/digest.db
ALLOWED_ORIGINS CORS allowed origins No localhost

API Server

Runs on port 8767 by default. Set DIGEST_PORT env to change.

Endpoints

Method Path Description Auth
GET /api/digests List digests (?type=4h|daily|weekly&limit=20&offset=0) -
GET /api/digests/:id Get single digest -
POST /api/digests Create digest (internal) -
GET /api/auth/google Start Google OAuth flow -
GET /api/auth/callback OAuth callback endpoint -
GET /api/auth/me Get current user info Yes
POST /api/auth/logout Logout user Yes
GET /api/marks List user bookmarks Yes
POST /api/marks Add bookmark Yes
DELETE /api/marks/:id Remove bookmark Yes
GET /api/config Get configuration -
PUT /api/config Update configuration -

Web Dashboard

Serve web/index.html via your reverse proxy or any static file server.

Templates

  • templates/curation-rules.md — Customize feed curation rules
  • templates/digest-prompt.md — Customize the AI summarization prompt

Configuration

Copy config.example.json to config.json and edit. See README for details.

Reverse Proxy (Caddy example)

handle /digest/api/* {
    uri strip_prefix /digest/api
    reverse_proxy localhost:8767
}
handle_path /digest/* {
    root * /path/to/clawfeed/web
    file_server
}
安全使用建议
What to check before installing/running ClawFeed: - Metadata vs code: The registry claims an 'instruction-only' skill with no env vars, but the repository contains a runnable Node server and DB migrations. Treat this as a small web app you will be starting locally (not just a prompt file). - Secrets required: SKILL.md expects GOOGLE_CLIENT_ID/GOOGLE_CLIENT_SECRET, SESSION_SECRET, and API_KEY for write endpoints. Do not supply these credentials to the skill unless you trust the source. The registry omitted these — ask the publisher why. - LLM / external API ambiguity: The docs describe AI summarization but do not list which LLM provider or API keys (OpenAI, Anthropic, self-hosted) are used. Inspect src/server.mjs and code paths that perform summarization to see whether the app makes outbound calls and to which hosts before running. - Network exposure & persistence: npm start will run a server (default port 8767) and create a local SQLite DB. Run it in an isolated environment (container, VM) and bind it to localhost only if you do not want it reachable from the network. - Native build: better-sqlite3 is a native addon; npm install will compile / download binaries. Ensure build tools are acceptable in your environment. - Review code: Because full source is included, scan src/server.mjs and src/db.mjs for any hidden outbound endpoints, telemetry, or code that reads unexpected config paths. Look for any hard-coded URLs/webhooks (e.g., feedback webhook) before providing credentials. If you want higher confidence: request the publisher to update registry metadata to declare required env vars and an install spec, and to document the LLM/provider used. If you cannot audit the code, run the service in a container/VM and restrict network access until you confirm behavior.
功能分析
Type: OpenClaw Skill Name: clawfeed-3 Version: 0.1.0 ClawFeed is a well-documented and professionally structured AI-powered news digest tool. The bundle contains a Node.js server (src/server.mjs), SQLite database logic (src/db.mjs), and an extensive end-to-end test suite (test/e2e.sh). Security best practices are evident, including robust SSRF protection in the URL resolver (assertSafeFetchUrl in src/server.mjs), HMAC-signed OAuth state validation, and the use of prepared statements to prevent SQL injection. No evidence of data exfiltration, malicious backdoors, or prompt injection attacks was found; the code logic is entirely consistent with the stated purpose of curating and summarizing news feeds.
能力评估
Purpose & Capability
The name/description and SKILL.md describe a web service that generates digests from Twitter/RSS (expected). However the registry metadata claims 'instruction-only' with no required env vars, while the bundled repository contains a full Node API server (src/server.mjs, src/db.mjs) and runtime instructions that require npm install and env configuration. That mismatch (registry saying 'no env vars / instruction-only' vs. repository containing runnable server code and env vars) is incoherent and worth caution.
Instruction Scope
SKILL.md instructs the agent/user to run npm install, copy .env.example, set GOOGLE_CLIENT_ID/GOOGLE_CLIENT_SECRET/SESSION_SECRET/API_KEY and start the server — all appropriate for a web dashboard. The instructions do not ask the agent to read unrelated system files. However SKILL.md describes AI summarization (LLM usage) and no LLM API key or provider env var is declared; it's unclear how summarization is performed (local model vs external API). This ambiguity increases risk because running the service may cause unexpected outbound LLM/API calls.
Install Mechanism
Registry lists no install spec (instruction-only), but the package includes a full Node app and expects 'npm install' (native addon better-sqlite3). There is no remote download of arbitrary archives, which is good, but the lack of an install spec in the registry (despite substantial code) is inconsistent and means the agent/platform may not be aware this skill will compile native modules and spawn a networked server if the user follows SKILL.md.
Credentials
SKILL.md lists multiple secrets (GOOGLE_CLIENT_ID/SECRET, SESSION_SECRET, API_KEY, AI_DIGEST_DB path, ALLOWED_ORIGINS). The registry metadata shows 'required env vars: none' and 'primary credential: none' — a clear mismatch. The declared env vars are plausible for the app, but the registry omission could mislead users or automated installers about what secrets will be requested. Also the instructions don't declare any LLM/third-party API keys despite describing an AI summarization pipeline, which is an important omission to clarify.
Persistence & Privilege
The skill does not request always:true and is user-invocable (normal). Running the skill as instructed will start a persistent server (npm start) and create/modify a local SQLite DB (data/digest.db by default). That persistence is expected for a web service, but users should be aware the skill will open network ports and write local data if installed and started.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install clawfeed-3
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /clawfeed-3 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.1.0
Initial release of ClawFeed news digest tool. - Generates structured news digests (4-hourly, daily, weekly, monthly) from Twitter and RSS feeds. - API server supports viewing digests, bookmarks, feeds, and user authentication (Google OAuth). - Runs in read-only mode by default; authentication enables personal features like bookmarks. - Uses SQLite (bundled, no external DB needed). - Includes web dashboard and customizable templates for curation and summarization. - Simple environment configuration and reverse proxy setup instructions provided.
元数据
Slug clawfeed-3
版本 0.1.0
许可证
累计安装 2
当前安装数 2
历史版本数 1
常见问题

Clawfeed 是什么?

AI tool that generates structured news digests from Twitter and RSS feeds with summaries available in 4-hour, daily, weekly, or monthly formats. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 468 次。

如何安装 Clawfeed?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install clawfeed-3」即可一键安装,无需额外配置。

Clawfeed 是免费的吗?

是的,Clawfeed 完全免费(开源免费),可自由下载、安装和使用。

Clawfeed 支持哪些平台?

Clawfeed 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Clawfeed?

由 Ma-star(@ma-star)开发并维护,当前版本 v0.1.0。

💬 留言讨论