介绍
# Finance News Skill
AI 驱动的市场新闻简报，支持可配置的语言输出和自动投递。
## 首次设置
运行交互式设置向导来配置您的数据源、投递渠道和计划：
```bash finance-news setup ```
该向导将引导您完成以下步骤： - 📰 **RSS 订阅源：** 启用/禁用 WSJ、Barron's、CNBC、Yahoo 等。 - 📊 **市场：** 选择区域（美国、欧洲、日本、亚洲） - 📤 **投递：** 配置 WhatsApp/Telegram 群组 - 🌐 **语言：** 设置默认语言（英语/德语） - ⏰ **计划：** 配置早晨/晚间 cron 时间
您也可以配置特定部分： ```bash 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 finance-news config # Show current config ```
## 快速开始
```bash # Generate morning briefing finance-news briefing --morning
# View market overview finance-news market
# Get news for your portfolio finance-news portfolio
# Get news for specific stock finance-news news AAPL ```
## 功能
### 📊 市场覆盖 - **美国市场：** S&P 500、道琼斯、NASDAQ - **欧洲：** DAX、STOXX 50、FTSE 100 - **日本：** 日经 225
### 📰 新闻来源 - **付费：** WSJ、Barron's（RSS 订阅源） - **免费：** CNBC、Yahoo Finance、Finnhub - **投资组合：** 来自 Yahoo 的特定代码新闻
### 🤖 AI 摘要 - 由 Gemini 提供支持的分析 - 可配置语言（英语/德语） - 简报风格：摘要、分析、标题
### 📅 自动简报 - **早晨：** 太平洋时间上午 6:30（美国市场开盘） - **晚间：** 太平洋时间下午 1:00（美国市场收盘） - **投递：** WhatsApp（在 cron 脚本中配置群组）
## 命令
### 生成简报
```bash # Morning briefing (English is default) finance-news briefing --morning
# Evening briefing with WhatsApp delivery finance-news briefing --evening --send --group "Market Briefing"
# German language option finance-news briefing --morning --lang de
# Analysis style (more detailed) finance-news briefing --style analysis ```
### 市场数据
```bash # Market overview (indices + top headlines) finance-news market
# JSON output for processing finance-news market --json ```
### 投资组合管理
```bash # List portfolio finance-news portfolio-list
# Add stock finance-news portfolio-add NVDA --name "NVIDIA Corporation" --category Tech
# Remove stock finance-news portfolio-remove TSLA
# Import from CSV finance-news portfolio-import ~/my_stocks.csv
# Interactive portfolio creation finance-news portfolio-create ```
### 代码新闻
```bash # News for specific stock finance-news news AAPL finance-news news TSLA ```
## 配置
### 投资组合 CSV 格式
位置：`~/clawd/skills/finance-news/config/portfolio.csv`
```csv symbol,name,category,notes AAPL,Apple Inc.,Tech,Core holding NVDA,NVIDIA Corporation,Tech,AI play MSFT,Microsoft Corporation,Tech, ```
### 数据源配置
位置：`~/clawd/skills/finance-news/config/config.json`（旧版回退：`config/sources.json`）
- WSJ、Barron's、CNBC、Yahoo 的 RSS 订阅源 - 按区域划分的市场指数 - 语言设置
## Cron 任务
### 通过 OpenClaw 设置
```bash # Add morning briefing cron job openclaw cron add --schedule "30 6 * * 1-5" \ --timezone "America/Los_Angeles" \ --command "bash ~/clawd/skills/finance-news/cron/morning.sh"
# Add evening briefing cron job openclaw cron add --schedule "0 13 * * 1-5" \ --timezone "America/Los_Angeles" \ --command "bash ~/clawd/skills/finance-news/cron/evening.sh" ```
### 手动 Cron (crontab)
```cron # 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 ```
## 示例输出
```markdown 🌅 **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. ```
## 集成
### 与 OpenBB（现有技能）集成 ```bash # Get detailed quote, then news openbb-quote AAPL && finance-news news AAPL ```
### 与 OpenClaw Agent 集成 当被问到以下问题时，Agent 将自动使用此技能： - "市场表现如何？" - "我的投资组合新闻" - "生成晨间简报" - "AAPL 怎么样了？"
### 与 Lobster（工作流引擎）集成 通过 [Lobster](https://github.com/openclaw/lobster) 运行简报，以实现审批门和可恢复性：
```bash # Run with approval before WhatsApp send lobster "workflows.run --file workflows/briefing.yaml"
# With custom args lobster "workflows.run --file workflows/briefing.yaml --args-json '{\"time\":\"evening\",\"lang\":\"en\"}'" ```
完整文档请参阅 `workflows/README.md`。
## 文件
``` 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 ```
## 依赖项
- Python 3.10+ - `feedparser` (`pip install feedparser`) - Gemini CLI (`brew install gemini-cli`) - OpenBB（现有的 `openbb-quote` 封装器） - OpenClaw 消息工具（用于 WhatsApp 投递）
## 故障排除
### Gemini 无法工作 ```bash # Authenticate Gemini gemini # Follow login flow ```
### RSS 订阅源超时 - 检查网络连接 - WSJ/Barron's 的部分内容可能需要订阅 Cookie - 免费订阅源（CNBC、Yahoo）应该始终可用
### WhatsApp 投递失败 - 验证 WhatsApp 群组是否存在且机器人拥有访问权限 - 检查 `openclaw doctor` 查看 WhatsApp 状态