← Back to Skills Marketplace
ma-star

Clawfeed

by Ma-star · GitHub ↗ · v0.1.0
cross-platform ⚠ suspicious
468
Downloads
0
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install clawfeed-3
Description
AI tool that generates structured news digests from Twitter and RSS feeds with summaries available in 4-hour, daily, weekly, or monthly formats.
README (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
}
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install clawfeed-3
  3. After installation, invoke the skill by name or use /clawfeed-3
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Slug clawfeed-3
Version 0.1.0
License
All-time Installs 2
Active Installs 2
Total Versions 1
Frequently Asked Questions

What is Clawfeed?

AI tool that generates structured news digests from Twitter and RSS feeds with summaries available in 4-hour, daily, weekly, or monthly formats. It is an AI Agent Skill for Claude Code / OpenClaw, with 468 downloads so far.

How do I install Clawfeed?

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

Is Clawfeed free?

Yes, Clawfeed is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Clawfeed support?

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

Who created Clawfeed?

It is built and maintained by Ma-star (@ma-star); the current version is v0.1.0.

💬 Comments