clawfeed
ClawFeed — AI-powered news digest with structured summaries from Twitter/RSS feeds and web dashboard
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/kevinho--clawfeed)HTML
<a href="/listings/kevinho--clawfeed"><img src="/api/listings/kevinho--clawfeed/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Option 1: ClawHub (recommended)
clawhub install clawfeed
Option 2: OpenClaw Skill
cd ~/.openclaw/skills/ git clone https://github.com/kevinho/clawfeed.git
OpenClaw auto-detects `SKILL.md` and loads the skill. The agent can then generate digests via cron, serve the dashboard, and handle bookmark commands.
Option 3: Zylos Skill
cd ~/.zylos/skills/ git clone https://github.com/kevinho/clawfeed.git
Option 4: Standalone
git clone https://github.com/kevinho/clawfeed.git cd clawfeed npm install
Option 5: Docker
# Basic usage docker run -d -p 8767:8767 kevinho/clawfeed # With persistent data docker run -d -p 8767:8767 -v clawfeed-data:/app/data kevinho/clawfeed # With environment variables (recommended for production) docker run -d -p 8767:8767 \ -v clawfeed-data:/app/data \ -e ALLOWED_ORIGINS=https://yourdomain.com \ -e API_KEY=your-api-key \ -e GOOGLE_CLIENT_ID=your-client-id \ -e GOOGLE_CLIENT_SECRET=your-client-secret \ -e SESSION_SECRET=your-session-secret \ kevinho/clawfeed
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 91 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # 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
- ```bash
- # 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
- }
- ```
README.md · README · 252 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # ClawFeed
- > **Stop scrolling. Start knowing.**
- [](https://clawhub.ai/skills/clawfeed)
- [](https://github.com/kevinho/clawfeed)
- [](LICENSE)
- [Live Demo: https://clawfeed.kevinhe.io](https://clawfeed.kevinhe.io)
- AI-powered news digest that curates thousands of sources down to the highlights that matter. Generates structured summaries (4H/daily/weekly/monthly) from Twitter, RSS, and more. Works standalone or as an [OpenClaw](https://github.com/openclaw/openclaw) / [Zylos](https://github.com/zylos-ai) skill.
- 
- ## Features
- - 📰 **Multi-frequency digests** — 4-hourly, daily, weekly, monthly summaries
- - 📡 **Sources system** — Add Twitter feeds, RSS, HackerNews, Reddit, GitHub Trending, and more
- - 📦 **Source Packs** — Share curated source bundles with the community
- - 📌 **Mark & Deep Dive** — Bookmark content for AI-powered deep analysis
- - 🎯 **Smart curation** — Configurable rules for content filtering and noise reduction
- - 👀 **Follow/Unfollow suggestions** — Based on feed quality analysis
- - 📢 **Feed output** — Subscribe to any user's digest via RSS or JSON Feed
- - 🌐 **Multi-language** — English and Chinese UI
- - 🌙 **Dark/Light mode** — Theme toggle with localStorage persistence
- - 🖥️ **Web dashboard** — SPA for browsing and managing digests
- - 💾 **SQLite storage** — Fast, portable, zero-config database
- - 🔐 **Google OAuth** — Multi-user support with personal bookmarks and sources
- ## Installation
- ### Option 1: ClawHub (recommended)
- ```bash
- clawhub install clawfeed
- ```
- ### Option 2: OpenClaw Skill
- ```bash
- cd ~/.openclaw/skills/
- git clone https://github.com/kevinho/clawfeed.git
- ```
- OpenClaw auto-detects `SKILL.md` and loads the skill. The agent can then generate digests via cron, serve the dashboard, and handle bookmark commands.
- ### Option 3: Zylos Skill
- ```bash
- cd ~/.zylos/skills/
- git clone https://github.com/kevinho/clawfeed.git
- ```
- ### Option 4: Standalone
- ```bash
- git clone https://github.com/kevinho/clawfeed.git
- cd clawfeed
- npm install
- ```
- ### Option 5: Docker
- ```bash
- # Basic usage
- docker run -d -p 8767:8767 kevinho/clawfeed
- # With persistent data
- docker run -d -p 8767:8767 -v clawfeed-data:/app/data kevinho/clawfeed
- # With environment variables (recommended for production)
- docker run -d -p 8767:8767 \
- -v clawfeed-data:/app/data \
- -e ALLOWED_ORIGINS=https://yourdomain.com \
- -e API_KEY=your-api-key \
- -e GOOGLE_CLIENT_ID=your-client-id \
- -e GOOGLE_CLIENT_SECRET=your-client-secret \
- -e SESSION_SECRET=your-session-secret \
- kevinho/clawfeed
- ```
- ## Quick Start
- ```bash
- # 1. Copy and edit environment config
- cp .env.example .env
- # Edit .env with your settings
- # 2. Start the API server
- npm start
- # → API running on http://127.0.0.1:8767
- ```
- ## Environment Variables
- Create a `.env` file in the project root:
- | Variable | Description | Required | Default |
- |----------|-------------|----------|---------|
- | `GOOGLE_CLIENT_ID` | Google OAuth client ID | No* | - |
- | `GOOGLE_CLIENT_SECRET` | Google OAuth client secret | No* | - |
- | `SESSION_SECRET` | Session encryption key | No* | - |
- | `API_KEY` | API key for digest creation | No | - |
- | `DIGEST_PORT` | Server port | No | 8767 |
- | `ALLOWED_ORIGINS` | Allowed origins for CORS | No | localhost |
- \*Required for authentication features. Without OAuth, the app runs in read-only mode.
- ## Authentication Setup
- To enable Google OAuth login:
- 1. Go to [Google Cloud Console](https://console.cloud.google.com/)
- 2. Create a new project or select existing one
- 3. Enable the Google+ API
- 4. Create OAuth 2.0 credentials
- 5. Add your domain to authorized origins
- 6. Add callback URL: `https://yourdomain.com/api/auth/callback`
- 7. Set credentials in `.env`
- ## API
- All endpoints prefixed with `/api/`.
- ### Digests
- | Method | Endpoint | Description | Auth |
- |--------|----------|-------------|------|
- | `GET` | `/api/digests` | List digests `?type=4h&limit=20&offset=0` | - |
- | `GET` | `/api/digests/:id` | Get single digest | - |
- | `POST` | `/api/digests` | Create digest | API Key |
- ### Auth
- | Method | Endpoint | Description | Auth |
- |--------|----------|-------------|------|
- | `GET` | `/api/auth/config` | Auth availability check | - |
- | `GET` | `/api/auth/google` | Start OAuth flow | - |
- | `GET` | `/api/auth/callback` | OAuth callback | - |
- | `GET` | `/api/auth/me` | Current user info | Yes |
- | `POST` | `/api/auth/logout` | Logout | Yes |
- ### Marks (Bookmarks)
- | Method | Endpoint | Description | Auth |
- |--------|----------|-------------|------|
- | `GET` | `/api/marks` | List bookmarks | Yes |
- | `POST` | `/api/marks` | Add bookmark `{ url, title?, note? }` | Yes |
- | `DELETE` | `/api/marks/:id` | Remove bookmark | Yes |
- ### Sources
- | Method | Endpoint | Description | Auth |
- |--------|----------|-------------|------|
- | `GET` | `/api/sources` | List user's sources | Yes |
- | `POST` | `/api/sources` | Create source `{ name, type, config }` | Yes |
- | `PUT` | `/api/sources/:id` | Update source | Yes |
- | `DELETE` | `/api/sources/:id` | Soft-delete source | Yes |
- | `GET` | `/api/sources/detect` | Auto-detect source type from URL | Yes |
- ### Source Packs
- | Method | Endpoint | Description | Auth |
- |--------|----------|-------------|------|
- | `GET` | `/api/packs` | Browse public packs | - |
- | `POST` | `/api/packs` | Create pack from your sources | Yes |
- | `POST` | `/api/packs/:id/install` | Install pack (subscribe to its sources) | Yes |
- ### Feeds
- | Method | Endpoint | Description | Auth |
- |--------|----------|-------------|------|
- | `GET` | `/feed/:slug` | User's digest feed (HTML) | - |
- | `GET` | `/feed/:slug.json` | JSON Feed format | - |
- | `GET` | `/feed/:slug.rss` | RSS format | - |
- ### Config
- | Method | Endpoint | Description | Auth |
- |--------|----------|-------------|------|
- | `GET` | `/api/changelog` | Changelog `?lang=zh\|en` | - |
- | `GET` | `/api/roadmap` | Roadmap `?lang=zh\|en` | - |
- ## Reverse Proxy
- Example Caddy configuration:
- ```caddyfile
- handle /digest/api/* {
- uri strip_prefix /digest/api
- reverse_proxy localhost:8767
- }
- handle_path /digest/* {
- root * /path/to/clawfeed/web
- file_server
- }
- ```
- ## Customization
- - **Curation rules**: Edit `templates/curation-rules.md` to control content filtering
- - **Digest format**: Edit `templates/digest-prompt.md` to customize AI output format
- ## Source Types
- | Type | Example | Description |
- |------|---------|-------------|
- | `twitter_feed` | `@karpathy` | Twitter/X user feed |
- | `twitter_list` | List URL | Twitter list |
- | `rss` | Any RSS/Atom URL | RSS feed |
- | `hackernews` | HN Front Page | Hacker News |
- | `reddit` | `/r/MachineLearning` | Subreddit |
- | `github_trending` | `language=python` | GitHub trending repos |
- | `website` | Any URL | Website scraping |
- | `digest_feed` | ClawFeed user slug | Another user's digest |
- | `custom_api` | JSON endpoint | Custom API |
- ## Development
- ```bash
- npm run dev # Start with --watch for auto-reload
- ```
- ### Testing
- ```bash
- cd test
- ./setup.sh # Create test users
- ./e2e.sh # Run 66 E2E tests
- ./teardown.sh # Clean up
- ```
- ## Architecture
- See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for multi-tenant design and scale analysis.
- ## Roadmap
- See [ROADMAP.md](ROADMAP.md) or the in-app roadmap page.
- ## Contributing
- 1. Fork the repository
- 2. Create your feature branch (`git checkout -b feature/amazing-feature`)
- 3. Commit your changes (`git commit -m 'Add some amazing feature'`)
- 4. Push to the branch (`git push origin feature/amazing-feature`)
- 5. Open a Pull Request
- ## License
- MIT License — see [LICENSE](LICENSE) for details.
- Copyright 2026 Kevin He
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.