AI-powered market news briefings with configurable language output and automated delivery via WhatsApp/Telegram.
First-Time Setup
Run the interactive setup wizard:
finance-news setup
The wizard configures RSS feeds, markets (US/Europe/Japan/Asia), delivery channels (WhatsApp/Telegram), language (English/German), and cron schedule.
Configure individual sections:
finance-news setup --section feeds # Just RSS feeds
finance-news setup --section delivery # Just delivery channels
finance-news setup --section schedule # Just cron schedule
finance-news setup --reset # Reset to defaults
Verify setup completed correctly:
finance-news config # Show current config
finance-news briefing --morning # Test a dry-run briefing
Quick Start
finance-news briefing --morning # Morning briefing
finance-news briefing --evening --send --group "Market Briefing" # Evening + WhatsApp
finance-news market # Market overview
finance-news portfolio # Portfolio news
finance-news news AAPL # Ticker-specific news
See COMMANDS.md for the full CLI reference including portfolio management, cron setup, and configuration details.
Cron Jobs
Scheduled morning/evening briefings run via openclaw cron — the add/verify commands (and the manual crontab fallback) live in COMMANDS.md → Cron Jobs. Quick check: openclaw cron list.
Integration
Combine with OpenBB for detailed quotes before news:
openbb-quote AAPL && finance-news news AAPL
Run briefings via Lobster for approval gates and resumability — see workflows/README.md for full documentation:
lobster "workflows.run --file workflows/briefing.yaml"
Troubleshooting
| Issue | Fix |
|---|---|
| Briefing writer failing | Verify KALLIOPE_SERVING_API_KEY is set and the Kalliope Ornith route (http://100.124.155.99:4000/v1) is reachable; scheduled runs fail closed and do not select another model |
| RSS feeds timing out | Check network; WSJ/Barron's may need subscription cookies; CNBC/Yahoo always work |
| WhatsApp delivery failing | Verify group exists and bot has access; run openclaw doctor |