個人財務管理技能

個人財務管理技能 (Personal Finance Skill)

提供 75 個工具、橫跨 7 個擴充套件的全方位個人財務管理技能，涵蓋銀行、投資、稅務、市場情報、社群情緒及財務分析工作流程。

使用時機

當使用者提出以下要求時，請啟用此技能：

• 帳戶整合 — 連結銀行帳戶、檢視餘額、同步交易紀錄
• 淨值 / 現金流 — 計算總額、追蹤支出、分析儲蓄率
• 投資組合監控 — 持倉部位、資產配置、績效、偏離偵測
• 交易 — 下單/取消訂單、市場數據、資產查詢 (Alpaca)
• 稅務優化 — 估計稅務負擔、稅損收割候選項目、洗售規則檢查、季度付款
• 稅務文件處理 — 解析 W-2, 1099-B/DIV/INT, K-1, Form 1040, Schedule 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	交換公開 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	淨值時間序列與報酬率	唯讀
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	計算替代最低稅 (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 (檢查偏離)
  → alpaca_portfolio_history (績效趨勢)
  → 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 閘道 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 Token
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 範例

每週

…

[原文於此處截斷，待翻譯]