Habilidade de Finanças Pessoais
Uma habilidade abrangente de gestão financeira pessoal com 75 ferramentas em 7 extensões para fluxos de trabalho bancários, de investimento, tributários, inteligência de mercado, sentimento social e análise financeira.
Quando Usar
Ative esta habilidade quando um usuário solicitar:
- Agregação de contas — conectar contas bancárias, visualizar saldos, sincronizar transações
- Patrimônio líquido / fluxo de caixa — calcular totais, rastrear gastos, análise da taxa de poupança
- Monitoramento de portfólio — posições, alocação, desempenho, detecção de desvio
- Negociação — colocar/cancelar ordens, dados de mercado, consulta de ativos (Alpaca)
- Otimização tributária — estimativa de passivo, candidatos à colheita de prejuízos fiscais, verificações de wash sale, pagamentos trimestrais
- Processamento de documentos fiscais — análise de W-2, 1099-B/DIV/INT, K-1, Formulário 1040, Anexos A-E/SE, Formulário 8949, Formulário 6251 (AMT), declarações estaduais
- Inteligência de mercado — notícias da empresa, arquivos da SEC, recomendações de analistas, dados econômicos (FRED, BLS), sentimento de notícias
- Sentimento social — sentimento do StockTwits, análise de cashtag no X/Twitter, símbolos em tendência, negociações congressuais
- Rastreamento de despesas recorrentes — assinaturas, contas, fluxos de receita
- Detecção de anomalias — transações incomuns, quedas de saldo, cobranças duplicadas
- Briefings financeiros — resumos semanais/mensais com itens de ação
- Fluxos de trabalho financeiros agendados — varreduras baseadas em cron, alertas, relatórios
Visão Geral da Arquitetura
Sete extensões organizadas em três camadas:
Camada de Inteligência
tax-engine (23 ferramentas) — análise (15), passivo, colheita de prejuízos fiscais, wash sales, lotes,
cálculo do Anexo D, imposto estadual, AMT
market-intel (10 ferramentas) — notícias, fundamentos, arquivos da SEC, dados econômicos
social-sentiment (6 ferramentas) — StockTwits, X/Twitter, negociações congressuais
Adaptadores de Fonte de Dados
plaid-connect (8) alpaca-trading (10) ibkr-portfolio (9)
Camada de Fundação
finance-core (9 ferramentas) — modelos canônicos, armazenamento, normalização,
verificações de política, detecção de anomalias, briefings
Fluxo de dados: Adaptadores buscam dados do provedor → finance-core normaliza e armazena → camada de inteligência analisa → mecanismo de políticas controla ações.
Catálogo de Ferramentas
finance-core — 9 ferramentas
| Ferramenta | Descrição | Risco |
|---|---|---|
finance_upsert_snapshot | Armazenar instantâneo de dados financeiros normalizados (idempotente) | BAIXO |
finance_get_state | Obter estado financeiro atual (contas, posições, etc.) | LEITURA |
finance_get_transactions | Consultar transações com filtros e paginação | LEITURA |
finance_get_net_worth | Calcular detalhamento do patrimônio líquido por categoria/conta | LEITURA |
finance_detect_anomalies | Escanear transações incomuns, quedas de saldo, picos de taxas | LEITURA |
finance_cash_flow_summary | Receitas vs despesas por categoria com taxa de poupança | LEITURA |
finance_subscription_tracker | Identificar cobranças recorrentes e padrões de assinatura | LEITURA |
finance_generate_brief | Criar resumo financeiro estruturado com itens de ação | LEITURA |
finance_policy_check | Validar ação proposta contra regras de política | LEITURA |
Esquemas completos: references/ext-finance-core.md
plaid-connect — 8 ferramentas
| Ferramenta | Descrição | Risco |
|---|---|---|
plaid_create_link_token | Inicializar Plaid Link para conexão de conta | BAIXO |
plaid_exchange_token | Trocar token público por acesso permanente | MÉDIO |
plaid_get_accounts | Listar contas conectadas com saldos | LEITURA |
plaid_get_transactions | Buscar transações via sincronização baseada em cursor | LEITURA |
plaid_get_investments | Buscar participações, títulos, transações de investimento | LEITURA |
plaid_get_liabilities | Buscar dados de crédito, empréstimos estudantis e hipotecas | LEITURA |
plaid_get_recurring | Identificar fluxos recorrentes de entrada/saída | LEITURA |
plaid_webhook_handler | Processar eventos de webhook do Plaid recebidos | BAIXO |
Esquemas completos: references/ext-plaid-connect.md
alpaca-trading — 10 ferramentas
| Ferramenta | Descrição | Risco |
|---|---|---|
alpaca_get_account | Obter saldos da conta, poder de compra, status | LEITURA |
alpaca_list_positions | Listar todas as posições abertas | LEITURA |
alpaca_get_position | Obter posição única por símbolo | LEITURA |
alpaca_list_orders | Listar ordens com filtros de status/data | LEITURA |
alpaca_create_order | Enviar ordem de compra/venda com verificações de segurança | ALTO |
alpaca_cancel_order | Cancelar uma ordem pendente | MÉDIO |
alpaca_portfolio_history | Histórico de patrimônio líquido e P/L ao longo do tempo | LEITURA |
alpaca_get_assets | Pesquisar ativos negociáveis por classe/bolsa | LEITURA |
alpaca_market_data | Obter snapshots, barras ou cotações para símbolos | LEITURA |
alpaca_clock | Verificar se o mercado está aberto, próxima abertura/fechamento | LEITURA |
Esquemas completos: references/ext-alpaca-trading.md
ibkr-portfolio — 9 ferramentas
| Ferramenta | Descrição | Risco |
|---|---|---|
ibkr_auth_status | Verificar status de autenticação do gateway | LEITURA |
ibkr_tickle | Manter sessão do gateway ativa (~intervalo de 1 min) | BAIXO |
ibkr_list_accounts | Listar contas (deve ser chamado primeiro) | LEITURA |
ibkr_get_positions | Obter posições para uma conta (paginado) | LEITURA |
ibkr_portfolio_allocation | Alocação por classe de ativo, setor, grupo | LEITURA |
ibkr_portfolio_performance | Série temporal do NAV e retornos | LEITURA |
ibkr_search_contracts | Pesquisar contratos por símbolo/nome/tipo | LEITURA |
ibkr_market_snapshot | Dados de mercado em tempo real para contratos | LEITURA |
ibkr_get_orders | Obter ordens atuais em aberto | LEITURA |
Esquemas completos: references/ext-ibkr-portfolio.md
tax-engine — 23 ferramentas
| Ferramenta | Descrição | Risco |
|---|---|---|
tax_parse_1099b | Analisar 1099-B (receitas, base de custo, wash sales) | LEITURA |
tax_parse_1099div | Analisar 1099-DIV (dividendos, ganhos de capital) | LEITURA |
tax_parse_1099int | Analisar 1099-INT (juros, prêmios de títulos) | LEITURA |
tax_parse_w2 | Analisar W-2 (salários, retenções, SS/Medicare) | LEITURA |
tax_parse_k1 | Analisar Anexo K-1 (pass-through de parceria) | LEITURA |
tax_parse_1040 | Analisar Formulário 1040 (declaração federal principal) | LEITURA |
tax_parse_schedule_a | Analisar Anexo A (deduções detalhadas) | LEITURA |
tax_parse_schedule_b | Analisar Anexo B (pagadores de juros/dividendos) | LEITURA |
tax_parse_schedule_c | Analisar Anexo C (renda de trabalho autônomo) | LEITURA |
tax_parse_schedule_d | Analisar Anexo D (compensação de ganhos de capital) | LEITURA |
tax_parse_schedule_e | Analisar Anexo E (aluguéis/royalties/parcerias) | LEITURA |
tax_parse_schedule_se | Analisar Anexo SE (imposto de trabalho autônomo) | LEITURA |
tax_parse_form_8949 | Analisar Formulário 8949 (vendas e alienações) | LEITURA |
tax_parse_state_return | Analisar declaração estadual (CA 540, NY IT-201, etc.) | LEITURA |
tax_parse_form_6251 | Analisar Formulário 6251 (AMT) | LEITURA |
tax_estimate_liability | Calcular imposto federal/estadual com faixas | LEITURA |
tax_find_tlh_candidates | Identificar oportunidades de colheita de prejuízos fiscais | LEITURA |
tax_check_wash_sales | Validar conformidade com a regra de wash sale (janela de 61 dias) | LEITURA |
tax_lot_selection | Comparar FIFO/LIFO/ID específico para uma venda proposta | LEITURA |
tax_quarterly_estimate | Pagamentos estimados trimestrais com safe harbor | LEITURA |
tax_compute_schedule_d | Calcular compensação do Anexo D com carryover de perdas | LEITURA |
tax_compute_state_tax | Calcular imposto estadual para CA/NY/NJ/IL/PA/MA/TX/FL | LEITURA |
tax_compute_amt | Calcular Imposto Mínimo Alternativo (Formulário 6251) | LEITURA |
Esquemas completos: references/ext-tax-engine.md
market-intel — 10 ferramentas
| Ferramenta | Descrição | Risco |
|---|---|---|
intel_company_news | Obter artigos de notícias recentes para uma empresa (Finnhub) | LEITURA |
intel_market_news | Obter notícias gerais de mercado por categoria (Finnhub) | LEITURA |
intel_stock_fundamentals | Obter demonstrações financeiras relatadas (Finnhub) | LEITURA |
intel_analyst_recommendations | Obter consenso de analistas comprar/manter/vender (Finnhub) | LEITURA |
intel_sec_filings | Listar arquivos da SEC para uma empresa por ticker (EDGAR) | LEITURA |
intel_sec_search | Pesquisa de texto completo em arquivos da SEC (EDGAR) | LEITURA |
intel_fred_series | Buscar séries temporais econômicas (PIB, IPC, taxas) (FRED) | LEITURA |
intel_fred_search | Pesquisar séries FRED por palavra-chave | LEITURA |
intel_bls_data | Buscar séries temporais de estatísticas trabalhistas/preços (BLS) | LEITURA |
intel_news_sentiment | Obter notícias com sentimento pontuado por IA (Alpha Vantage) | LEITURA |
Esquemas completos: references/ext-market-intel.md
social-sentiment — 6 ferramentas
| Ferramenta | Descrição | Risco |
|---|---|---|
social_stocktwits_sentiment | Obter sentimento otimista/pessimista para uma ação (StockTwits) | LEITURA |
social_stocktwits_trending | Obter símbolos atualmente em tendência (StockTwits) | LEITURA |
social_x_search | Pesquisar tweets recentes por palavra-chave (X/Twitter) | LEITURA |
social_x_user_timeline | Obter tweets recentes de um usuário (X/Twitter) | LEITURA |
social_x_cashtag | Pesquisar cashtag com pontuação de sentimento por palavra-chave (X) | LEITURA |
social_quiver_congress | Obter divulgações de negociação de ações do congresso (Quiver) | LEITURA |
Esquemas completos: references/ext-social-sentiment.md
Fluxos de Trabalho Principais
1. Integração — Conectar Contas
plaid_create_link_token(products: ["transactions", "investments", "liabilities"])
→ Usuário completa o 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 → apresentar linha de base ao usuário
2. Varredura Diária — Detecção de Anomalias
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 achados de gravidade média/alta
3. Colheita de Prejuízos Fiscais
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")
→ [Se aprovado] alpaca_create_order(side: "sell", ...)
4. Revisão 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. Monitoramento de Portfólio
alpaca_list_positions + ibkr_get_positions
→ finance_upsert_snapshot (ambas as fontes)
→ ibkr_portfolio_allocation (verificar desvio)
→ alpaca_portfolio_history (tendência de desempenho)
→ finance_detect_anomalies
→ finance_generate_brief(period: "weekly")
6. Pesquisa de Empresa — Inteligência 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. Visão Geral Econômica
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. Processamento Completo de Declaração de Imposto
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. Sinais de Negociação do Congresso
social_quiver_congress(daysBack: 30)
→ Filtrar por grandes compras
→ intel_company_news(symbol: <top_ticker>)
→ alpaca_market_data(symbols: <top_ticker>)
→ social_stocktwits_sentiment(symbol: <top_ticker>)
Configuração
Variáveis de Ambiente
| Variável | Extensão | Descrição |
|---|---|---|
PLAID_CLIENT_ID | plaid-connect | ID do cliente da API Plaid |
PLAID_SECRET | plaid-connect | Chave secreta da API Plaid |
PLAID_ENV | plaid-connect | sandbox / development / production |
ALPACA_API_KEY | alpaca-trading | Chave da API Alpaca |
ALPACA_API_SECRET | alpaca-trading | Segredo da API Alpaca |
ALPACA_ENV | alpaca-trading | paper / live |
IBKR_BASE_URL | ibkr-portfolio | URL do Gateway do Portal do Cliente |
FINNHUB_API_KEY | market-intel | Chave da API Finnhub (finnhub.io) |
FRED_API_KEY | market-intel | Chave da API FRED (fred.stlouisfed.org) |
BLS_API_KEY | market-intel | Chave de registro BLS (v2) |
ALPHA_VANTAGE_API_KEY | market-intel | Chave da API Alpha Vantage |
X_API_BEARER_TOKEN | social-sentiment | Token de Portador OAuth 2.0 do X/Twitter |
QUIVER_API_KEY | social-sentiment | Chave da API Quiver Quantitative |
Configuração das Extensões
Cada extensão possui um openclaw.plugin.json com um configSchema. Configurações principais:
- 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
Exemplos de Cron
Semanal
...