Persönliche Finanzverwaltung (Personal Finance Skill)
Eine umfassende Fähigkeit zur persönlichen Finanzverwaltung mit 75 Tools in 7 Erweiterungen für Bankgeschäfte, Investitionen, Steuern, Marktinformationen, soziale Stimmungen und Finanzanalyse-Workflows.
Wann verwenden
Aktiviere diese Fähigkeit, wenn ein Benutzer Folgendes anfragt:
- Kontenaggregation — Verknüpfung von Bankkonten, Anzeigen von Salden, Synchronisieren von Transaktionen
- Vermögen / Cashflow — Berechnung von Summen, Verfolgung von Ausgaben, Sparquotenanalyse
- Portfolio-Überwachung — Positionen, Allokation, Performance, Drift-Erkennung
- Handel — Platzieren/Stornieren von Orders, Marktdaten, Asset-Suche (Alpaca)
- Steueroptimierung — geschätzte Steuerschuld, TLH-Kandidaten, Wash-Sale-Prüfungen, vierteljährliche Zahlungen
- Steuerdokumentenverarbeitung — Parsen von W-2, 1099-B/DIV/INT, K-1, Formular 1040, Anlagen A-E/SE, Formular 8949, Formular 6251 (AMT), Landessteuererklärungen
- Marktinformationen — Unternehmensnachrichten, SEC-Einreichungen, Analystenempfehlungen, Wirtschaftsdaten (FRED, BLS), Nachrichtenstimmung
- Soziale Stimmung — StockTwits-Stimmung, X/Twitter-Cashtag-Analyse, trendende Symbole, Kongresshandel
- Wiederkehrende Ausgaben verfolgen — Abonnements, Rechnungen, Einkommensströme
- Anomalieerkennung — ungewöhnliche Transaktionen, Saldoabfälle, doppelte Belastungen
- Finanzbriefings — wöchentliche/monatliche Zusammenfassungen mit Aktionspunkten
- Geplante Finanz-Workflows — Cron-basierte Scans, Benachrichtigungen, Berichte
Architekturüberblick
Sieben Erweiterungen, organisiert in drei Schichten:
Intelligence-Schicht
tax-engine (23 Tools) — Parsen (15), Steuerschuld, TLH, Wash Sales, Losauswahl,
Schedule-D-Berechnung, Landessteuer, AMT
market-intel (10 Tools) — Nachrichten, Fundamentalaten, SEC-Einreichungen, Wirtschaftsdaten
social-sentiment (6 Tools) — StockTwits, X/Twitter, Kongresshandel
Datenquellen-Adapter
plaid-connect (8) alpaca-trading (10) ibkr-portfolio (9)
Grundschicht
finance-core (9 Tools) — kanonische Modelle, Speicherung, Normalisierung,
Richtlinienprüfungen, Anomalieerkennung, Briefings
Datenfluss: Adapter rufen Daten von Anbietern ab → finance-core normalisiert und speichert → Intelligence-Schicht analysiert → Policy-Engine steuert Aktionen.
Tool-Katalog
finance-core — 9 Tools
| Tool | Beschreibung | Risiko |
|---|---|---|
finance_upsert_snapshot | Normalisierten Finanzdaten-Snapshot speichern (idempotent) | NIEDRIG |
finance_get_state | Aktuellen Finanzstatus abrufen (Konten, Positionen usw.) | LESEN |
finance_get_transactions | Transaktionen mit Filtern und Paginierung abfragen | LESEN |
finance_get_net_worth | Vermögensaufstellung nach Kategorie/Konto berechnen | LESEN |
finance_detect_anomalies | Nach ungewöhnlichen Transaktionen, Saldoabfällen, Gebührenspitzen scannen | LESEN |
finance_cash_flow_summary | Einnahmen vs. Ausgaben nach Kategorie mit Sparquote | LESEN |
finance_subscription_tracker | Wiederkehrende Belastungen und Abonnementmuster identifizieren | LESEN |
finance_generate_brief | Strukturierte Finanzübersicht mit Aktionspunkten erstellen | LESEN |
finance_policy_check | Vorgeschlagene Aktion gegen Richtlinienregeln validieren | LESEN |
Vollständige Schemas: references/ext-finance-core.md
plaid-connect — 8 Tools
| Tool | Beschreibung | Risiko |
|---|---|---|
plaid_create_link_token | Plaid Link zur Kontoverbindung initialisieren | NIEDRIG |
plaid_exchange_token | Öffentlichen Token gegen dauerhaften Zugriff austauschen | MITTEL |
plaid_get_accounts | Verbundene Konten mit Salden auflisten | LESEN |
plaid_get_transactions | Transaktionen mittels Cursor-basierter Synchronisation abrufen | LESEN |
plaid_get_investments | Bestände, Wertpapiere, Investitionstransaktionen abrufen | LESEN |
plaid_get_liabilities | Kredit-, Studienkredit- und Hypothekendaten abrufen | LESEN |
plaid_get_recurring | Wiederkehrende Ein-/Ausgangsströme identifizieren | LESEN |
plaid_webhook_handler | Eingehende Plaid-Webhook-Ereignisse verarbeiten | NIEDRIG |
Vollständige Schemas: references/ext-plaid-connect.md
alpaca-trading — 10 Tools
| Tool | Beschreibung | Risiko |
|---|---|---|
alpaca_get_account | Kontosalden, Kaufkraft, Status abrufen | LESEN |
alpaca_list_positions | Alle offenen Positionen auflisten | LESEN |
alpaca_get_position | Einzelne Position nach Symbol abrufen | LESEN |
alpaca_list_orders | Orders mit Status-/Datumsfiltern auflisten | LESEN |
alpaca_create_order | Kauf-/Verkaufsorder mit Sicherheitsprüfungen einreichen | HOCH |
alpaca_cancel_order | Eine ausstehende Order stornieren | MITTEL |
alpaca_portfolio_history | Historisches Eigenkapital und Gewinn/Verlust im Zeitverlauf | LESEN |
alpaca_get_assets | Handelbare Vermögenswerte nach Klasse/Börse durchsuchen | LESEN |
alpaca_market_data | Snapshots, Balken oder Kurse für Symbole abrufen | LESEN |
alpaca_clock | Prüfen, ob der Markt geöffnet ist, nächster Öffnungs-/Schlusszeitpunkt | LESEN |
Vollständige Schemas: references/ext-alpaca-trading.md
ibkr-portfolio — 9 Tools
| Tool | Beschreibung | Risiko |
|---|---|---|
ibkr_auth_status | Gateway-Authentifizierungsstatus prüfen | LESEN |
ibkr_tickle | Gateway-Sitzung am Leben halten (~1 Min. Intervall) | NIEDRIG |
ibkr_list_accounts | Konten auflisten (muss zuerst aufgerufen werden) | LESEN |
ibkr_get_positions | Positionen für ein Konto abrufen (paginiert) | LESEN |
ibkr_portfolio_allocation | Allokation nach Anlageklasse, Sektor, Gruppe | LESEN |
ibkr_portfolio_performance | NAV-Zeitreihen und Renditen | LESEN |
ibkr_search_contracts | Verträge nach Symbol/Name/Typ durchsuchen | LESEN |
ibkr_market_snapshot | Echtzeit-Marktdaten für Verträge | LESEN |
ibkr_get_orders | Aktuelle Live-Orders abrufen | LESEN |
Vollständige Schemas: references/ext-ibkr-portfolio.md
tax-engine — 23 Tools
| Tool | Beschreibung | Risiko |
|---|---|---|
tax_parse_1099b | 1099-B parsen (Erlöse, Kostenbasis, Wash Sales) | LESEN |
tax_parse_1099div | 1099-DIV parsen (Dividenden, Kapitalgewinne) | LESEN |
tax_parse_1099int | 1099-INT parsen (Zinsen, Anleiheprämien) | LESEN |
tax_parse_w2 | W-2 parsen (Löhne, Steuerabzug, SV/Medicare) | LESEN |
tax_parse_k1 | Schedule K-1 parsen (Partnerschaftsdurchlauf) | LESEN |
tax_parse_1040 | Formular 1040 parsen (Hauptsteuererklärung Bund) | LESEN |
tax_parse_schedule_a | Anlage A parsen (Einzelabzüge, SALT-Grenze) | LESEN |
tax_parse_schedule_b | Anlage B parsen (Zins-/Dividendenzahler) | LESEN |
tax_parse_schedule_c | Anlage C parsen (Selbstständigeneinkommen) | LESEN |
tax_parse_schedule_d | Anlage D parsen (Kapitalgewinne saldieren) | LESEN |
tax_parse_schedule_e | Anlage E parsen (Mieteinnahmen/Lizenzen/Partnerschaft) | LESEN |
tax_parse_schedule_se | Anlage SE parsen (Selbstständigensteuer) | LESEN |
tax_parse_form_8949 | Formular 8949 parsen (Verkäufe und Veräußerungen) | LESEN |
tax_parse_state_return | Landessteuererklärung parsen (CA 540, NY IT-201 usw.) | LESEN |
tax_parse_form_6251 | Formular 6251 parsen (AMT) | LESEN |
tax_estimate_liability | Bundes-/Landessteuer mit Steuerklassen berechnen | LESEN |
tax_find_tlh_candidates | Möglichkeiten zur Steuerverlusternte identifizieren | LESEN |
tax_check_wash_sales | Einhaltung der Wash-Sale-Regel prüfen (61-Tage-Fenster) | LESEN |
tax_lot_selection | FIFO/LIFO/spezifische ID für einen vorgeschlagenen Verkauf vergleichen | LESEN |
tax_quarterly_estimate | Vierteljährliche geschätzte Zahlungen mit Safe Harbor | LESEN |
tax_compute_schedule_d | Anlage-D-Saldierung mit Verlustvortrag berechnen | LESEN |
tax_compute_state_tax | Landessteuer für CA/NY/NJ/IL/PA/MA/TX/FL berechnen | LESEN |
tax_compute_amt | Alternative Minimum Tax (Formular 6251) berechnen | LESEN |
Vollständige Schemas: references/ext-tax-engine.md
market-intel — 10 Tools
| Tool | Beschreibung | Risiko |
|---|---|---|
intel_company_news | Aktuelle Nachrichtenartikel zu einem Unternehmen abrufen (Finnhub) | LESEN |
intel_market_news | Allgemeine Marktnachrichten nach Kategorie abrufen (Finnhub) | LESEN |
intel_stock_fundamentals | Gemeldete Finanzberichte abrufen (Finnhub) | LESEN |
intel_analyst_recommendations | Analysten-Konsens zu Kauf/Halten/Verkaufen abrufen (Finnhub) | LESEN |
intel_sec_filings | SEC-Einreichungen für ein Unternehmen nach Ticker auflisten (EDGAR) | LESEN |
intel_sec_search | Volltextsuche in SEC-Einreichungen (EDGAR) | LESEN |
intel_fred_series | Wirtschaftszeitreihen abrufen (BIP, VPI, Zinssätze) (FRED) | LESEN |
intel_fred_search | Nach FRED-Reihen nach Stichwort suchen | LESEN |
intel_bls_data | Arbeits-/Preisstatistik-Zeitreihen abrufen (BLS) | LESEN |
intel_news_sentiment | Nachrichten mit KI-bewerteter Stimmung abrufen (Alpha Vantage) | LESEN |
Vollständige Schemas: references/ext-market-intel.md
social-sentiment — 6 Tools
| Tool | Beschreibung | Risiko |
|---|---|---|
social_stocktwits_sentiment | Bullen-/Bären-Stimmung für eine Aktie abrufen (StockTwits) | LESEN |
social_stocktwits_trending | Derzeit trendende Symbole abrufen (StockTwits) | LESEN |
social_x_search | Nach aktuellen Tweets nach Stichwort suchen (X/Twitter) | LESEN |
social_x_user_timeline | Aktuelle Tweets eines Benutzers abrufen (X/Twitter) | LESEN |
social_x_cashtag | Cashtag mit Stichwort-Stimmungsbewertung suchen (X) | LESEN |
social_quiver_congress | Offenlegungen von Aktienhandel durch Kongressmitglieder abrufen (Quiver) | LESEN |
Vollständige Schemas: references/ext-social-sentiment.md
Wichtige Workflows
1. Onboarding — Konten verbinden
plaid_create_link_token(products: ["transactions", "investments", "liabilities"])
→ Benutzer schließt Plaid Link ab
→ 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 → Basislinie dem Benutzer präsentieren
2. Täglicher Scan — Anomalieerkennung
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)
→ Bei mittleren/hohen Schweregraden alarmieren
3. Steuerverlusternte (Tax-Loss Harvesting)
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")
→ [Wenn genehmigt] alpaca_create_order(side: "sell", ...)
4. Vierteljährliche Steuerüberprüfung
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. Portfolio-Überwachung
alpaca_list_positions + ibkr_get_positions
→ finance_upsert_snapshot (beide Quellen)
→ ibkr_portfolio_allocation (Drift prüfen)
→ alpaca_portfolio_history (Performancetrend)
→ finance_detect_anomalies
→ finance_generate_brief(period: "weekly")
6. Unternehmensrecherche — Marktinformationen
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. Wirtschaftlicher Überblick
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. Vollständige Steuererklärungsverarbeitung
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. Kongresshandelssignale
social_quiver_congress(daysBack: 30)
→ Nach großen Käufen filtern
→ intel_company_news(symbol: <top_ticker>)
→ alpaca_market_data(symbols: <top_ticker>)
→ social_stocktwits_sentiment(symbol: <top_ticker>)
Konfiguration
Umgebungsvariablen
| Variable | Erweiterung | Beschreibung |
|---|---|---|
PLAID_CLIENT_ID | plaid-connect | Plaid API-Client-ID |
PLAID_SECRET | plaid-connect | Plaid API-Geheimschlüssel |
PLAID_ENV | plaid-connect | sandbox / development / production |
ALPACA_API_KEY | alpaca-trading | Alpaca API-Schlüssel |
ALPACA_API_SECRET | alpaca-trading | Alpaca API-Geheimnis |
ALPACA_ENV | alpaca-trading | paper / live |
IBKR_BASE_URL | ibkr-portfolio | Client Portal Gateway-URL |
FINNHUB_API_KEY | market-intel | Finnhub API-Schlüssel (finnhub.io) |
FRED_API_KEY | market-intel | FRED API-Schlüssel (fred.stlouisfed.org) |
BLS_API_KEY | market-intel | BLS-Registrierungsschlüssel (v2) |
ALPHA_VANTAGE_API_KEY | market-intel | Alpha Vantage API-Schlüssel |
X_API_BEARER_TOKEN | social-sentiment | X/Twitter OAuth 2.0 Bearer-Token |
QUIVER_API_KEY | social-sentiment | Quiver Quantitative API-Schlüssel |
Erweiterungskonfiguration
Jede Erweiterung hat eine openclaw.plugin.json mit einem configSchema. Wichtige Einstellungen:
- 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-Beispiele
Wöchentlich
…
[gekürzt zur Übersetzung]