Structured Digest

Name: Structured Digest
Rating: 3.5 (1 reviews)
Author: jbillington

By jbillington 👁 64 views ▲ 0 votes

Deterministic, modular daily digest plugin for OpenClaw

GitHub

Install

npm install -g

README

# OpenClaw Structured Digest Plugin

A deterministic, modular CLI plugin for OpenClaw that delivers personalized daily digests via email.

## Status

🚧 **Planning Phase** - MVP implementation plan in progress

## What This Does

Solves the problem of erratic AI news summaries by enforcing a rigid pipeline:
- **Deterministic** fetching and filtering (RSS, weather, stocks, sports)
- **LanceDB-backed** deduplication (no repeated stories)
- **Constrained LLM** summarization (strict output format)
- **Beautiful HTML** email templates (mobile-responsive)

## Key Features

- ✅ Zero-friction setup (uses OpenClaw's existing LanceDB + scheduler)
- ✅ Modular data sources (news, weather, stocks, sports)
- ✅ Keyword filtering (include/exclude before LLM sees data)
- ✅ Custom HTML templates
- ✅ No Docker required

## Quick Start (Planned)

```bash
npm install -g openclaw-structured-digest
openclaw digest init
openclaw digest add https://news.ycombinator.com/rss
openclaw digest module add weather --zip 94110
openclaw digest run --dry-run
openclaw digest schedule --cron '0 7 * * *'
```

## Documentation

- [PRD.md](./PRD.md) - Full product requirements
- IMPLEMENTATION-PLAN.md _(coming soon)_
- ARCHITECTURE.md _(coming soon)_
- CLI-DESIGN.md _(coming soon)_

## Built On Lessons From

This plugin builds on proven patterns from the [digest-system](https://github.com/openclaw/digest-system) personal implementation:
- Modular architecture (data collection, research, intelligence, assembly)
- Fixture-based testing
- Validation gates before delivery
- Clean separation of deterministic vs LLM-powered steps

## Target Timeline

- **Week 1:** Foundation + core RSS pipeline
- **Week 2:** Multi-module support + security hardening

## Contributing

Coming soon - see QUICKSTART.md for developer onboarding

## License

MIT

---

**Author:** John Billington  
**Built for:** OpenClaw community  
**Status:** Planning → Implementation

tools