个人理财技能

个人理财技能 是做什么的？

一个全面的个人理财管理技能，提供 75 个工具，横跨 7 个扩展模块，用于银行、投资、税务、市场情报、社交情绪和财务分析工作流。

何时使用

当用户提出以下要求时，激活此技能：

• 账户聚合 — 连接银行账户、查看余额、同步交易
• 净值 / 现金流 — 计算总额、追踪支出、储蓄率分析
• 投资组合监控 — 持仓、配置、表现、偏离检测
• 交易 — 下单/撤单、市场数据、资产查询 (Alpaca)
• 税务优化 — 估算负债、税收亏损收割候选、虚假交易检查、季度付款
• 税务文件处理 — 解析 W-2、1099-B/DIV/INT、K-1、Form 1040、附表 A-E/SE、Form 8949、Form 6251 (AMT)、州报税表
• 市场情报 — 公司新闻、SEC 文件、分析师推荐、经济数据 (FRED、BLS)、新闻情绪
• 社交情绪 — StockTwits 情绪、X/Twitter 话题标签分析、趋势符号、国会交易
• 经常性支出追踪 — 订阅、账单、收入来源
• 异常检测 — 异常交易、余额骤降、重复扣款
• 财务简报 — 带有行动项的每周/每月摘要
• 定时财务工作流 — 基于 cron 的扫描、告警、报告

架构概览

七个扩展模块组织为三层：

智能层
  tax-engine (23 个工具) — 解析 (15)、负债、税收亏损收割、虚假交易、
    批次、Schedule D 计算、州税、AMT
  market-intel (10 个工具) — 新闻、基本面、SEC 文件、经济数据
  social-sentiment (6 个工具) — StockTwits、X/Twitter、国会交易

数据源适配器
  plaid-connect (8)   alpaca-trading (10)   ibkr-portfolio (9)

基础层
  finance-core (9 个工具) — 规范模型、存储、标准化、
    策略检查、异常检测、简报

数据流：适配器获取提供商数据 → finance-core 标准化并存储 → 智能层分析 → 策略引擎门控操作。

工具目录

finance-core — 9 个工具

工具	描述	风险
finance_upsert_snapshot	存储标准化的财务数据快照（幂等）	低
finance_get_state	获取当前财务状态（账户、持仓等）	只读
finance_get_transactions	使用筛选和分页查询交易	只读
finance_get_net_worth	按类别/账户计算净值细分	只读
finance_detect_anomalies	扫描异常交易、余额骤降、费用激增	只读
finance_cash_flow_summary	按类别的收入 vs 支出及储蓄率	只读
finance_subscription_tracker	识别经常性扣款和订阅模式	只读
finance_generate_brief	创建包含行动项的结构化财务摘要	只读
finance_policy_check	根据策略规则验证提议的操作	只读

完整模式： references/ext-finance-core.md

plaid-connect — 8 个工具

工具	描述	风险
plaid_create_link_token	初始化 Plaid Link 以连接账户	低
plaid_exchange_token	将公开令牌交换为永久访问令牌	中
plaid_get_accounts	列出带有余额的已连接账户	只读
plaid_get_transactions	通过基于游标的同步获取交易	只读
plaid_get_investments	获取持仓、证券、投资交易	只读
plaid_get_liabilities	获取信贷、学生贷款和抵押数据	只读
plaid_get_recurring	识别经常性流入/流出流	只读
plaid_webhook_handler	处理传入的 Plaid Webhook 事件	低

完整模式： references/ext-plaid-connect.md

alpaca-trading — 10 个工具

工具	描述	风险
alpaca_get_account	获取账户余额、购买力、状态	只读
alpaca_list_positions	列出所有未平仓头寸	只读
alpaca_get_position	按证券代码获取单个头寸	只读
alpaca_list_orders	按状态/日期筛选列出订单	只读
alpaca_create_order	提交买入/卖出订单并执行安全检查	高
alpaca_cancel_order	取消待处理订单	中
alpaca_portfolio_history	历史权益和盈亏随时间变化	只读
alpaca_get_assets	按类别/交易所搜索可交易资产	只读
alpaca_market_data	获取证券代码的快照、K线图或报价	只读
alpaca_clock	检查市场是否开市、下一次开/闭市时间	只读

完整模式： references/ext-alpaca-trading.md

ibkr-portfolio — 9 个工具

工具	描述	风险
ibkr_auth_status	检查网关认证状态	只读
ibkr_tickle	保持网关会话活跃（约 1 分钟间隔）	低
ibkr_list_accounts	列出账户（必须先调用）	只读
ibkr_get_positions	获取账户的头寸（分页）	只读
ibkr_portfolio_allocation	按资产类别、行业、分组的配置	只读
ibkr_portfolio_performance	NAV 时间序列和回报率	只读
ibkr_search_contracts	按代码/名称/类型搜索合约	只读
ibkr_market_snapshot	合约的实时市场数据	只读
ibkr_get_orders	获取当前有效订单	只读

完整模式： references/ext-ibkr-portfolio.md

tax-engine — 23 个工具

工具	描述	风险
tax_parse_1099b	解析 1099-B（收益、成本基础、虚假交易）	只读
tax_parse_1099div	解析 1099-DIV（股息、资本利得）	只读
tax_parse_1099int	解析 1099-INT（利息、债券溢价）	只读
tax_parse_w2	解析 W-2（工资、预扣税、社保/医保）	只读
tax_parse_k1	解析 Schedule K-1（合伙传递实体）	只读
tax_parse_1040	解析 Form 1040（主联邦申报表）	只读
tax_parse_schedule_a	解析 Schedule A（逐项扣除、SALT 上限）	只读
tax_parse_schedule_b	解析 Schedule B（利息/股息付款人）	只读
tax_parse_schedule_c	解析 Schedule C（自雇收入）	只读
tax_parse_schedule_d	解析 Schedule D（资本利得净额结算）	只读
tax_parse_schedule_e	解析 Schedule E（租金/特许权使用费/合伙）	只读
tax_parse_schedule_se	解析 Schedule SE（自雇税）	只读
tax_parse_form_8949	解析 Form 8949（销售和处置）	只读
tax_parse_state_return	解析州报税表（CA 540、NY IT-201 等）	只读
tax_parse_form_6251	解析 Form 6251（AMT）	只读
tax_estimate_liability	按税率档计算联邦/州税	只读
tax_find_tlh_candidates	识别税收亏损收割机会	只读
tax_check_wash_sales	验证虚假交易规则合规性（61 天窗口期）	只读
tax_lot_selection	比较提议销售的 FIFO/LIFO/特定 ID	只读
tax_quarterly_estimate	季度预估付款及安全港规则	只读
tax_compute_schedule_d	计算 Schedule D 净额结算及亏损结转	只读
tax_compute_state_tax	计算州税（CA/NY/NJ/IL/PA/MA/TX/FL）	只读
tax_compute_amt	计算替代最低税（Alt Minimum Tax，Form 6251）	只读

完整模式： references/ext-tax-engine.md

market-intel — 10 个工具

工具	描述	风险
intel_company_news	获取公司的最新新闻文章（Finnhub）	只读
intel_market_news	按类别获取一般市场新闻（Finnhub）	只读
intel_stock_fundamentals	获取已报告的财务报表（Finnhub）	只读
intel_analyst_recommendations	获取分析师买入/持有/卖出共识（Finnhub）	只读
intel_sec_filings	按股票代码列出公司的 SEC 文件（EDGAR）	只读
intel_sec_search	全文搜索 SEC 文件（EDGAR）	只读
intel_fred_series	获取经济时间序列（GDP、CPI、利率）（FRED）	只读
intel_fred_search	按关键词搜索 FRED 序列	只读
intel_bls_data	获取劳动力/价格统计时间序列（BLS）	只读
intel_news_sentiment	获取带有 AI 评分情绪的新闻（Alpha Vantage）	只读

完整模式： references/ext-market-intel.md

social-sentiment — 6 个工具

工具	描述	风险
social_stocktwits_sentiment	获取股票的看涨/看跌情绪（StockTwits）	只读
social_stocktwits_trending	获取当前趋势符号（StockTwits）	只读
social_x_search	按关键词搜索最近的推文（X/Twitter）	只读
social_x_user_timeline	获取用户最近的推文（X/Twitter）	只读
social_x_cashtag	搜索带有关键词情绪评分的话题标签（X）	只读
social_quiver_congress	获取国会股票交易披露（Quiver）	只读

完整模式： references/ext-social-sentiment.md

关键工作流

1. 引导 — 连接账户

plaid_create_link_token(products: ["transactions", "investments", "liabilities"])
  → 用户完成 Plaid Link
  → plaid_exchange_token(publicToken)
  → plaid_get_accounts → finance_upsert_snapshot(source: "plaid")
  → plaid_get_transactions → finance_upsert_snapshot
  → plaid_get_investments → finance_upsert_snapshot
  → finance_get_net_worth → 向用户展示基线

2. 每日扫描 — 异常检测

plaid_get_transactions(cursor) → finance_upsert_snapshot
alpaca_list_positions → finance_upsert_snapshot(source: "alpaca")
ibkr_auth_status → ibkr_get_positions → finance_upsert_snapshot(source: "ibkr")
  → finance_detect_anomalies(lookbackDays: 7)
  → 按中/高风险发现发出警报

3. 税收亏损收割

finance_get_state(include: ["positions"])
  → tax_find_tlh_candidates(positions, marginalRate)
  → tax_check_wash_sales(proposedSales, recentPurchases)
  → tax_lot_selection(symbol, qty, lots)
  → finance_policy_check(actionType: "tax_move")
  → [如果批准] alpaca_create_order(side: "sell", ...)

4. 季度税务审查

tax_parse_w2 + tax_parse_1099b + tax_parse_1099div + tax_parse_1099int
  → tax_estimate_liability(filingStatus, income)
  → tax_quarterly_estimate(projectedIncome, priorYearTax, paymentsMade)
  → finance_generate_brief(period: "quarterly")

5. 投资组合监控

alpaca_list_positions + ibkr_get_positions
  → finance_upsert_snapshot (both sources)
  → ibkr_portfolio_allocation (check drift)
  → alpaca_portfolio_history (performance trend)
  → finance_detect_anomalies
  → finance_generate_brief(period: "weekly")

6. 公司研究 — 市场情报

intel_company_news(symbol: "AAPL", limit: 10)
  → intel_analyst_recommendations(symbol: "AAPL")
  → intel_stock_fundamentals(symbol: "AAPL", freq: "quarterly")
  → intel_sec_filings(symbol: "AAPL", formType: "10-K")
  → intel_news_sentiment(tickers: "AAPL")
  → social_stocktwits_sentiment(symbol: "AAPL")
  → social_x_cashtag(symbol: "AAPL")

7. 经济概览

intel_fred_series(seriesId: "GDP")
  → intel_fred_series(seriesId: "CPIAUCSL")
  → intel_fred_series(seriesId: "UNRATE")
  → intel_bls_data(seriesIds: ["CES0000000001"])
  → intel_fred_series(seriesId: "DFF")

8. 完整税务申报处理

tax_parse_1040(rawData) → tax_parse_schedule_a(rawData)
  → tax_parse_schedule_b(rawData) → tax_parse_schedule_c(rawData)
  → tax_parse_schedule_d(rawData) → tax_parse_schedule_e(rawData)
  → tax_parse_form_8949(rawData) → tax_parse_schedule_se(rawData)
  → tax_compute_schedule_d(gains, losses, carryovers)
  → tax_compute_state_tax(stateCode, taxableIncome, filingStatus)
  → tax_compute_amt(taxableIncome, adjustments, regularTax)
  → tax_parse_state_return(rawData)

9. 国会交易信号

social_quiver_congress(daysBack: 30)
  → 筛选出大额购买
  → intel_company_news(symbol: <top_ticker>)
  → alpaca_market_data(symbols: <top_ticker>)
  → social_stocktwits_sentiment(symbol: <top_ticker>)

配置

环境变量

变量	扩展	描述
PLAID_CLIENT_ID	plaid-connect	Plaid API 客户端 ID
PLAID_SECRET	plaid-connect	Plaid API 密钥
PLAID_ENV	plaid-connect	sandbox / development / production
ALPACA_API_KEY	alpaca-trading	Alpaca API 密钥
ALPACA_API_SECRET	alpaca-trading	Alpaca API 密钥
ALPACA_ENV	alpaca-trading	paper / live
IBKR_BASE_URL	ibkr-portfolio	Client Portal Gateway URL
FINNHUB_API_KEY	market-intel	Finnhub API 密钥 (finnhub.io)
FRED_API_KEY	market-intel	FRED API 密钥 (fred.stlouisfed.org)
BLS_API_KEY	market-intel	BLS 注册密钥 (v2)
ALPHA_VANTAGE_API_KEY	market-intel	Alpha Vantage API 密钥
X_API_BEARER_TOKEN	social-sentiment	X/Twitter OAuth 2.0 Bearer 令牌
QUIVER_API_KEY	social-sentiment	Quiver Quantitative API 密钥

扩展配置

每个扩展都有一个 openclaw.plugin.json 文件，包含 configSchema。关键设置：

• finance-core: storageDir, anomalyThresholds, policyRulesPath
• plaid-connect: plaidEnv, webhookUrl, clientName, countryCodes
• alpaca-trading: env (paper/live), maxOrderQty, maxOrderNotional
• ibkr-portfolio: baseUrl, defaultAccountId
• tax-engine: defaultFilingStatus, defaultState, defaultTaxYear
• market-intel: finnhubApiKeyEnv, fredApiKeyEnv, blsApiKeyEnv, alphaVantageApiKeyEnv, secEdgarUserAgent
• social-sentiment: xApiBearerTokenEnv, quiverApiKeyEnv

Cron 示例

周

…

[因截断而省略]