/install clawfeed-3
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 rulestemplates/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
}
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install clawfeed-3 - After installation, invoke the skill by name or use
/clawfeed-3 - Provide required inputs per the skill's parameter spec and get structured output
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.