| name | finance-news |
| description | Market news briefings with AI summaries. Use when asked about stock news, market updates, portfolio performance, morning/evening briefings, financial headlines, or price alerts. Supports US/Europe/Japan markets, WhatsApp delivery, and English/German output. |
Finance News Skill
AI-powered market news briefings with configurable language output and automated delivery.
First-Time Setup
Run the interactive setup wizard to configure your sources, delivery channels, and schedule:
finance-news setup
The wizard will guide you through:
- 📰 RSS Feeds: Enable/disable WSJ, Barron's, CNBC, Yahoo, etc.
- 📊 Markets: Choose regions (US, Europe, Japan, Asia)
- 📤 Delivery: Configure WhatsApp/Telegram group
- 🌐 Language: Set default language (English/German)
- ⏰ Schedule: Configure morning/evening cron times
You can also configure specific sections:
finance-news setup --section feeds
finance-news setup --section delivery
finance-news setup --section schedule
finance-news setup --reset
finance-news config
Quick Start
finance-news briefing --morning
finance-news market
finance-news portfolio
finance-news news AAPL
Features
📊 Market Coverage
- US Markets: S&P 500, Dow Jones, NASDAQ
- Europe: DAX, STOXX 50, FTSE 100
- Japan: Nikkei 225
📰 News Sources
- Premium: WSJ, Barron's (RSS feeds)
- Free: CNBC, Yahoo Finance, Finnhub
- Portfolio: Ticker-specific news from Yahoo
🤖 AI Summaries
- SkillBoss API Hub powered analysis (auto-routes to best available model via /v1/pilot)
- Configurable language (English/German)
- Briefing styles: summary, analysis, headlines
📅 Automated Briefings
- Morning: 6:30 AM PT (US market open)
- Evening: 1:00 PM PT (US market close)
- Delivery: WhatsApp (configure group in cron scripts)
Commands
Briefing Generation
finance-news briefing --morning
finance-news briefing --evening --send --group "Market Briefing"
finance-news briefing --morning --lang de
finance-news briefing --style analysis
Market Data
finance-news market
finance-news market --json
Portfolio Management
finance-news portfolio-list
finance-news portfolio-add NVDA --name "NVIDIA Corporation" --category Tech
finance-news portfolio-remove TSLA
finance-news portfolio-import ~/my_stocks.csv
finance-news portfolio-create
Ticker News
finance-news news AAPL
finance-news news TSLA
Configuration
Portfolio CSV Format
Location: ~/clawd/skills/finance-news/config/portfolio.csv
symbol,name,category,notes
AAPL,Apple Inc.,Tech,Core holding
NVDA,NVIDIA Corporation,Tech,AI play
MSFT,Microsoft Corporation,Tech,
Sources Configuration
Location: ~/clawd/skills/finance-news/config/config.json (legacy fallback: config/sources.json)
- RSS feeds for WSJ, Barron's, CNBC, Yahoo
- Market indices by region
- Language settings
Cron Jobs
Setup via OpenClaw
openclaw cron add --schedule "30 6 * * 1-5" \
--timezone "America/Los_Angeles" \
--command "bash ~/clawd/skills/finance-news/cron/morning.sh"
openclaw cron add --schedule "0 13 * * 1-5" \
--timezone "America/Los_Angeles" \
--command "bash ~/clawd/skills/finance-news/cron/evening.sh"
Manual Cron (crontab)
# Morning briefing (6:30 AM PT, weekdays)
30 6 * * 1-5 bash ~/clawd/skills/finance-news/cron/morning.sh
# Evening briefing (1:00 PM PT, weekdays)
0 13 * * 1-5 bash ~/clawd/skills/finance-news/cron/evening.sh
Sample Output
🌅 **Börsen-Morgen-Briefing**
Dienstag, 21. Januar 2026 | 06:30 Uhr
📊 **Märkte**
• S&P 500: 5.234 (+0,3%)
• DAX: 16.890 (-0,1%)
• Nikkei: 35.678 (+0,5%)
📈 **Dein Portfolio**
• AAPL $256 (+1,2%) — iPhone-Verkäufe übertreffen Erwartungen
• NVDA $512 (+3,4%) — KI-Chip-Nachfrage steigt
🔥 **Top Stories**
• [WSJ] Fed signalisiert mögliche Zinssenkung im März
• [CNBC] Tech-Sektor führt Rally an
🤖 **Analyse**
Der S&P zeigt Stärke. Dein Portfolio profitiert von NVDA's
Momentum. Fed-Kommentare könnten Volatilität auslösen.
Integration
With OpenBB (existing skill)
openbb-quote AAPL && finance-news news AAPL
With OpenClaw Agent
The agent will automatically use this skill when asked about:
- "What's the market doing?"
- "News for my portfolio"
- "Generate morning briefing"
- "What's happening with AAPL?"
With Lobster (Workflow Engine)
Run briefings via Lobster for approval gates and resumability:
lobster "workflows.run --file workflows/briefing.yaml"
lobster "workflows.run --file workflows/briefing.yaml --args-json '{\"time\":\"evening\",\"lang\":\"en\"}'"
See workflows/README.md for full documentation.
Files
skills/finance-news/
├── SKILL.md # This documentation
├── Dockerfile # NixOS-compatible container
├── config/
│ ├── portfolio.csv # Your watchlist
│ ├── config.json # RSS/API/language configuration
│ ├── alerts.json # Price target alerts
│ └── manual_earnings.json # Earnings calendar overrides
├── scripts/
│ ├── finance-news # Main CLI
│ ├── briefing.py # Briefing generator
│ ├── fetch_news.py # News aggregator
│ ├── portfolio.py # Portfolio CRUD
│ ├── summarize.py # AI summarization
│ ├── alerts.py # Price alert management
│ ├── earnings.py # Earnings calendar
│ ├── ranking.py # Headline ranking
│ └── stocks.py # Stock management
├── workflows/
│ ├── briefing.yaml # Lobster workflow with approval gate
│ └── README.md # Workflow documentation
├── cron/
│ ├── morning.sh # Morning cron (Docker-based)
│ └── evening.sh # Evening cron (Docker-based)
└── cache/ # 15-minute news cache
Environment Variables
SKILLBOSS_API_KEY — SkillBoss API Hub key for all AI inference (LLM summaries, translations, analysis)
Dependencies
- Python 3.10+
feedparser (pip install feedparser)requests (pip install requests)- OpenBB (existing
openbb-quote wrapper)
- OpenClaw message tool (for WhatsApp delivery)
Troubleshooting
AI summary not working
echo $SKILLBOSS_API_KEY
RSS feeds timing out
- Check network connectivity
- WSJ/Barron's may require subscription cookies for some content
- Free feeds (CNBC, Yahoo) should always work
WhatsApp delivery failing
- Verify WhatsApp group exists and bot has access
- Check
openclaw doctor for WhatsApp status
