ClawFeed

Stop scrolling. Start knowing.

Live Demo: 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 / Zylos 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)

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

Quick Start

# 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:

*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
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

Auth

Marks (Bookmarks)

Sources

Source Packs

Feeds

Config

Reverse Proxy

Example Caddy configuration:

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

Development

npm run dev  # Start with --watch for auto-reload

Testing

cd test
./setup.sh    # Create test users
./e2e.sh      # Run 66 E2E tests
./teardown.sh # Clean up

Architecture

See docs/ARCHITECTURE.md for multi-tenant design and scale analysis.

Roadmap

See 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 for details.

Copyright 2026 Kevin He