AI-powered news digest tool. Automatically generates structured summaries (4H/daily/weekly/monthly) from Twitter and RSS feeds.
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.
# Install dependencies
npm install
# Copy environment config
cp .env.example .env
# Edit .env with your settings
# Start API server
npm start
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 |
Runs on port 8767 by default. Set DIGEST_PORT env to change.
| 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 | - |
Serve web/index.html via your reverse proxy or any static file server.
templates/curation-rules.md — Customize feed curation rulestemplates/digest-prompt.md — Customize the AI summarization promptCopy config.example.json to config.json and edit. See README for details.
handle /digest/api/* {
uri strip_prefix /digest/api
reverse_proxy localhost:8767
}
handle_path /digest/* {
root * /path/to/clawfeed/web
file_server
}
共 1 个版本