Habilidad de Finanzas Personales
Una habilidad integral de gestión de finanzas personales con 75 herramientas en 7 extensiones para flujos de trabajo bancarios, de inversión, fiscales, de inteligencia de mercado, sentimiento social y análisis financiero.
Cuándo Usarla
Active esta habilidad cuando un usuario pregunte por:
- Agregación de cuentas — conectar cuentas bancarias, ver saldos, sincronizar transacciones
- Patrimonio neto / flujo de caja — calcular totales, rastrear gastos, análisis de tasa de ahorro
- Monitoreo de cartera — posiciones, asignación, rendimiento, detección de desviaciones
- Operaciones — colocar/cancelar órdenes, datos de mercado, búsqueda de activos (Alpaca)
- Optimización fiscal — responsabilidad estimada, candidatos para cosecha de pérdidas, verificación de wash sale, pagos trimestrales
- Procesamiento de documentos fiscales — parsear W-2, 1099-B/DIV/INT, K-1, Formulario 1040, Anexos A-E/SE, Formulario 8949, Formulario 6251 (AMT), declaraciones estatales
- Inteligencia de mercado — noticias de empresas, presentaciones ante la SEC, recomendaciones de analistas, datos económicos (FRED, BLS), sentimiento de noticias
- Sentimiento social — sentimiento de StockTwits, análisis de cashtags en X/Twitter, símbolos populares, operaciones del Congreso
- Seguimiento de gastos recurrentes — suscripciones, facturas, flujos de ingresos
- Detección de anomalías — transacciones inusuales, caídas de saldo, cargos duplicados
- Informes financieros — resúmenes semanales/mensuales con elementos de acción
- Flujos de trabajo financieros programados — escaneos basados en cron, alertas, informes
Resumen de Arquitectura
Siete extensiones organizadas en tres capas:
Capa de Inteligencia
tax-engine (23 herramientas) — parseo (15), responsabilidad fiscal, cosecha de pérdidas, wash sales, lotes,
cómputo del Anexo D, impuesto estatal, AMT
market-intel (10 herramientas) — noticias, fundamentos, presentaciones SEC, datos económicos
social-sentiment (6 herramientas) — StockTwits, X/Twitter, operaciones del Congreso
Adaptadores de Fuentes de Datos
plaid-connect (8) alpaca-trading (10) ibkr-portfolio (9)
Capa Base
finance-core (9 herramientas) — modelos canónicos, almacenamiento, normalización,
verificaciones de políticas, detección de anomalías, informes
Flujo de datos: Los adaptadores obtienen datos de los proveedores → finance-core normaliza y almacena → la capa de inteligencia analiza → el motor de políticas controla las acciones.
Catálogo de Herramientas
finance-core — 9 herramientas
| Herramienta | Descripción | Riesgo |
|---|---|---|
finance_upsert_snapshot | Almacenar una instantánea de datos financieros normalizados (idempotente) | BAJO |
finance_get_state | Obtener el estado financiero actual (cuentas, posiciones, etc.) | LECTURA |
finance_get_transactions | Consultar transacciones con filtros y paginación | LECTURA |
finance_get_net_worth | Calcular el desglose del patrimonio neto por categoría/cuenta | LECTURA |
finance_detect_anomalies | Escanear transacciones inusuales, caídas de saldo, picos de tarifas | LECTURA |
finance_cash_flow_summary | Ingresos vs gastos por categoría con tasa de ahorro | LECTURA |
finance_subscription_tracker | Identificar cargos recurrentes y patrones de suscripción | LECTURA |
finance_generate_brief | Crear un resumen financiero estructurado con elementos de acción | LECTURA |
finance_policy_check | Validar una acción propuesta contra las reglas de política | LECTURA |
Esquemas completos: references/ext-finance-core.md
plaid-connect — 8 herramientas
| Herramienta | Descripción | Riesgo |
|---|---|---|
plaid_create_link_token | Inicializar Plaid Link para conectar cuentas | BAJO |
plaid_exchange_token | Intercambiar token público por acceso permanente | MEDIO |
plaid_get_accounts | Listar cuentas conectadas con saldos | LECTURA |
plaid_get_transactions | Obtener transacciones mediante sincronización basada en cursor | LECTURA |
plaid_get_investments | Obtener tenencias, valores y transacciones de inversión | LECTURA |
plaid_get_liabilities | Obtener datos de crédito, préstamos estudiantiles e hipotecas | LECTURA |
plaid_get_recurring | Identificar flujos recurrentes de entrada/salida | LECTURA |
plaid_webhook_handler | Procesar eventos webhook entrantes de Plaid | BAJO |
Esquemas completos: references/ext-plaid-connect.md
alpaca-trading — 10 herramientas
| Herramienta | Descripción | Riesgo |
|---|---|---|
alpaca_get_account | Obtener saldos de cuenta, poder de compra, estado | LECTURA |
alpaca_list_positions | Listar todas las posiciones abiertas | LECTURA |
alpaca_get_position | Obtener una posición individual por símbolo | LECTURA |
alpaca_list_orders | Listar órdenes con filtros de estado/fecha | LECTURA |
alpaca_create_order | Enviar orden de compra/venta con verificaciones de seguridad | ALTO |
alpaca_cancel_order | Cancelar una orden pendiente | MEDIO |
alpaca_portfolio_history | Historial de capital y P/L a lo largo del tiempo | LECTURA |
alpaca_get_assets | Buscar activos negociables por clase/bolsa | LECTURA |
alpaca_market_data | Obtener instantáneas, barras o cotizaciones de símbolos | LECTURA |
alpaca_clock | Verificar si el mercado está abierto, próxima apertura/cierre | LECTURA |
Esquemas completos: references/ext-alpaca-trading.md
ibkr-portfolio — 9 herramientas
| Herramienta | Descripción | Riesgo |
|---|---|---|
ibkr_auth_status | Verificar estado de autenticación de la puerta de enlace | LECTURA |
ibkr_tickle | Mantener viva la sesión de la puerta de enlace (~1 min de intervalo) | BAJO |
ibkr_list_accounts | Listar cuentas (debe llamarse primero) | LECTURA |
ibkr_get_positions | Obtener posiciones de una cuenta (paginadas) | LECTURA |
ibkr_portfolio_allocation | Asignación por clase de activo, sector, grupo | LECTURA |
ibkr_portfolio_performance | Serie temporal de NAV y rendimientos | LECTURA |
ibkr_search_contracts | Buscar contratos por símbolo/nombre/tipo | LECTURA |
ibkr_market_snapshot | Datos de mercado en tiempo real para contratos | LECTURA |
ibkr_get_orders | Obtener órdenes activas actuales | LECTURA |
Esquemas completos: references/ext-ibkr-portfolio.md
tax-engine — 23 herramientas
| Herramienta | Descripción | Riesgo |
|---|---|---|
tax_parse_1099b | Parsear 1099-B (ingresos, base de costo, wash sales) | LECTURA |
tax_parse_1099div | Parsear 1099-DIV (dividendos, ganancias de capital) | LECTURA |
tax_parse_1099int | Parsear 1099-INT (intereses, primas de bonos) | LECTURA |
tax_parse_w2 | Parsear W-2 (salarios, retenciones, SS/Medicare) | LECTURA |
tax_parse_k1 | Parsear Anexo K-1 (asociación pasante) | LECTURA |
tax_parse_1040 | Parsear Formulario 1040 (declaración federal principal) | LECTURA |
tax_parse_schedule_a | Parsear Anexo A (deducciones detalladas, límite SALT) | LECTURA |
tax_parse_schedule_b | Parsear Anexo B (pagadores de intereses/dividendos) | LECTURA |
tax_parse_schedule_c | Parsear Anexo C (ingresos por trabajo por cuenta propia) | LECTURA |
tax_parse_schedule_d | Parsear Anexo D (compensación de ganancias de capital) | LECTURA |
tax_parse_schedule_e | Parsear Anexo E (alquiler/regalías/asociación) | LECTURA |
tax_parse_schedule_se | Parsear Anexo SE (impuesto de trabajo por cuenta propia) | LECTURA |
tax_parse_form_8949 | Parsear Formulario 8949 (ventas y disposiciones) | LECTURA |
tax_parse_state_return | Parsear declaración estatal (CA 540, NY IT-201, etc.) | LECTURA |
tax_parse_form_6251 | Parsear Formulario 6251 (AMT) | LECTURA |
tax_estimate_liability | Calcular impuesto federal/estatal con tramos | LECTURA |
tax_find_tlh_candidates | Identificar oportunidades de cosecha de pérdidas fiscales | LECTURA |
tax_check_wash_sales | Validar cumplimiento de la regla de wash sale (período de 61 días) | LECTURA |
tax_lot_selection | Comparar FIFO/LIFO/ID específico para una venta propuesta | LECTURA |
tax_quarterly_estimate | Pagos trimestrales estimados con puerto seguro | LECTURA |
tax_compute_schedule_d | Calcular compensación del Anexo D con arrastre de pérdidas | LECTURA |
tax_compute_state_tax | Calcular impuesto estatal para CA/NY/NJ/IL/PA/MA/TX/FL | LECTURA |
tax_compute_amt | Calcular Impuesto Mínimo Alternativo (Formulario 6251) | LECTURA |
Esquemas completos: references/ext-tax-engine.md
market-intel — 10 herramientas
| Herramienta | Descripción | Riesgo |
|---|---|---|
intel_company_news | Obtener artículos de noticias recientes de una empresa (Finnhub) | LECTURA |
intel_market_news | Obtener noticias generales del mercado por categoría (Finnhub) | LECTURA |
intel_stock_fundamentals | Obtener estados financieros reportados (Finnhub) | LECTURA |
intel_analyst_recommendations | Obtener consenso de analistas compra/mantén/venta (Finnhub) | LECTURA |
intel_sec_filings | Listar presentaciones SEC de una empresa por ticker (EDGAR) | LECTURA |
intel_sec_search | Búsqueda de texto completo en presentaciones SEC (EDGAR) | LECTURA |
intel_fred_series | Obtener series temporales económicas (PIB, IPC, tasas) (FRED) | LECTURA |
intel_fred_search | Buscar series FRED por palabra clave | LECTURA |
intel_bls_data | Obtener series temporales de estadísticas laborales/precios (BLS) | LECTURA |
intel_news_sentiment | Obtener noticias con sentimiento puntuado por IA (Alpha Vantage) | LECTURA |
Esquemas completos: references/ext-market-intel.md
social-sentiment — 6 herramientas
| Herramienta | Descripción | Riesgo |
|---|---|---|
social_stocktwits_sentiment | Obtener sentimiento alcista/bajista para una acción (StockTwits) | LECTURA |
social_stocktwits_trending | Obtener símbolos populares actualmente (StockTwits) | LECTURA |
social_x_search | Buscar tweets recientes por palabra clave (X/Twitter) | LECTURA |
social_x_user_timeline | Obtener tweets recientes de un usuario (X/Twitter) | LECTURA |
social_x_cashtag | Buscar cashtag con puntuación de sentimiento por palabra clave (X) | LECTURA |
social_quiver_congress | Obtener divulgaciones de operaciones bursátiles del Congreso (Quiver) | LECTURA |
Esquemas completos: references/ext-social-sentiment.md
Flujos de Trabajo Clave
1. Incorporación — Conectar Cuentas
plaid_create_link_token(products: ["transactions", "investments", "liabilities"])
→ El usuario completa 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 → presentar línea base al usuario
2. Escaneo Diario — Detección de Anomalías
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)
→ Alertar sobre hallazgos de gravedad media/alta
3. Cosecha de Pérdidas Fiscales
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")
→ [Si se aprueba] alpaca_create_order(side: "sell", ...)
4. Revisión Fiscal Trimestral
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. Monitoreo de Cartera
alpaca_list_positions + ibkr_get_positions
→ finance_upsert_snapshot (ambas fuentes)
→ ibkr_portfolio_allocation (verificar desviación)
→ alpaca_portfolio_history (tendencia de rendimiento)
→ finance_detect_anomalies
→ finance_generate_brief(period: "weekly")
6. Investigación de Empresas — Inteligencia de Mercado
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. Panorama Económico
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. Procesamiento Completo de Declaración de Impuestos
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. Señales de Operaciones del Congreso
social_quiver_congress(daysBack: 30)
→ Filtrar por compras grandes
→ intel_company_news(symbol: <top_ticker>)
→ alpaca_market_data(symbols: <top_ticker>)
→ social_stocktwits_sentiment(symbol: <top_ticker>)
Configuración
Variables de Entorno
| Variable | Extensión | Descripción |
|---|---|---|
PLAID_CLIENT_ID | plaid-connect | ID de cliente de la API de Plaid |
PLAID_SECRET | plaid-connect | Clave secreta de la API de Plaid |
PLAID_ENV | plaid-connect | sandbox / development / production |
ALPACA_API_KEY | alpaca-trading | Clave API de Alpaca |
ALPACA_API_SECRET | alpaca-trading | Secreto API de Alpaca |
ALPACA_ENV | alpaca-trading | paper / live |
IBKR_BASE_URL | ibkr-portfolio | URL de la puerta de enlace del portal de cliente |
FINNHUB_API_KEY | market-intel | Clave API de Finnhub (finnhub.io) |
FRED_API_KEY | market-intel | Clave API de FRED (fred.stlouisfed.org) |
BLS_API_KEY | market-intel | Clave de registro de BLS (v2) |
ALPHA_VANTAGE_API_KEY | market-intel | Clave API de Alpha Vantage |
X_API_BEARER_TOKEN | social-sentiment | Token Bearer OAuth 2.0 de X/Twitter |
QUIVER_API_KEY | social-sentiment | Clave API de Quiver Quantitative |
Configuración de Extensiones
Cada extensión tiene un openclaw.plugin.json con un configSchema. Configuraciones clave:
- 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
Ejemplos de Cron
Semanalmente
...