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 startEnvironment 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
}