/install clawfeed-2
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-2 - After installation, invoke the skill by name or use
/clawfeed-2 - Provide required inputs per the skill's parameter spec and get structured output
What is Clawfeed?
AI-powered tool generating structured news summaries from Twitter and RSS feeds with digest options for 4H, daily, weekly, and monthly intervals. It is an AI Agent Skill for Claude Code / OpenClaw, with 1154 downloads so far.
How do I install Clawfeed?
Run "/install clawfeed-2" 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 94W666 (@94w666); the current version is v0.1.0.