ClawGold v2.0
Descrição: ClawGold é um sistema autônomo de negociação de XAUUSD (Ouro vs Dólar Americano) alimentado por agentes de IA. Ele oferece integração com múltiplos provedores de LLM via LiteLLM, um backend robusto com APScheduler, análise técnica avançada, análise de sentimento em tempo real e execução automatizada de trades.
Última Atualização: Fase 1 (v2.0.0) — Integração LiteLLM, migração para APScheduler, melhoria de logging com Rich.
Desempenho: Chamadas de LLM em sub-segundo com fallback automático; recuperação persistente de jobs; ~10-15% de melhoria na confiabilidade.
Segurança: Arquitetura local-first, bancos de dados SQLite auto-hospedados, sem compartilhamento de dados. Todos os sinais de negociação são recomendações assistidas por IA.
Fase 1: Novidades
🚀 Integração LiteLLM
- Interface de IA Unificada: OpenCode, KiloCode, Gemini, Codex via uma única API LiteLLM
- Fallback Automático: Encadeie provedores; tente novamente chamadas com falha usando backoff exponencial
- Rastreamento de Custos: Registro de custos de LLM em tempo real no SQLite (
data/llm_costs.db) - Maior Confiabilidade: Redução de 10-15% nas falhas de API
📅 Migração para APScheduler
- Persistência de Jobs: Tarefas agendadas sobrevivem a reinicializações (armazenadas em
data/scheduler.db) - Três Modos de Agendamento: Diário (baseado em horário), intervalo (segundos), cron (padrões avançados)
- Pool de Threads: Máximo de 4 jobs concorrentes para uso eficiente de recursos
- Recuperação Graciosa: Período de carência de 30 segundos para jobs perdidos
🎨 Logging com Rich
- Saída Aprimorada no Console: Logs coloridos, painéis, tabelas, barras de progresso
- Melhor UX: Depuração mais rápida com hierarquia visual
- Logging em Arquivo: Todos os logs salvos em
logs/clawgold.logcom timestamps
Funcionalidades
Mecanismo Central de Negociação
- Monitoramento de Preços: Captura de preço XAUUSD em tempo real via Yahoo Finance
- Análise Técnica: Cálculo de médias móveis, cruzamentos de EMA, análise multi-timeframe (M15, H1, H4, D1)
- Geração de Sinais: Sinais automatizados de compra/venda/espera baseados em cruzamento de MA e consenso de IA
- Simulação de Trades: Execução realista de trades com rastreamento de portfólio
- Gerenciamento de Portfólio: Monitoramento de saldo, rastreamento de posições, cálculo de P&L
Melhorias da Fase 1
- Integração LiteLLM: Interface unificada multi-provedor de IA (OpenCode, KiloCode, Gemini, Codex)
- Fallback Automático: Encadeie múltiplos provedores; repetição automática com backoff exponencial
- Backend APScheduler: Agendamento persistente de jobs em segundo plano com recuperação de falhas
- Saída de Console com Rich: Logs coloridos, painéis, tabelas, barras de progresso
- Rastreamento de Custos: Análise de custos de LLM em tempo real por provedor (armazenamento SQLite)
Análise Alimentada por IA
- Pesquisa Multi-IA: Consultas paralelas a múltiplos provedores de IA para análise de mercado
- Análise de Sentimento: Pontuação de sentimento em tempo real de múltiplas fontes
- Pesquisa de Mercado: Perspectivas de mercado e previsões de tendências geradas por IA
- Avaliação de Risco: Recomendações de dimensionamento de posição e gerenciamento de risco alimentadas por IA
- Agregação de Notícias: Coleta automatizada de notícias com análise de sentimento
Estratégias Avançadas de Negociação
- Stops Móveis: Ajuste automático de stop-loss seguindo o movimento do preço
- Grid Trading: Ordens de compra/venda em múltiplos níveis para capturar volatilidade
- Detecção de Rompimentos: Sinais automatizados de entrada em rompimentos
- Modo Scalping: Trades de alta frequência em micro-tendências
- Gerenciamento de Risco: Limites diários de perda, monitoramento de margem, dimensionamento de posição
Aplicações
- Negociação Autônoma: Negociação 24/7 sem intervenção manual
- Decisões Assistidas por IA: Obtenha consenso de IA sobre a direção do mercado antes de negociar
- Teste de Estratégias: Backtest e simule ideias de negociação com condições realistas
- Educação: Aprenda conceitos avançados de negociação com orientação de IA
- Pesquisa: Agregue notícias de mercado e sentimento em um único painel
Ferramentas
get_xauusd_price
- Descrição: Obtém o preço atual do XAUUSD do Yahoo Finance.
- Parâmetros: Nenhum
- Retorno: String com o preço atual em USD por onça.
- Exemplo: "Current XAUUSD price: 5146.9 USD per ounce"
calculate_moving_average
- Descrição: Calcula a média móvel simples para XAUUSD no período especificado.
- Parâmetros:
- period (inteiro, padrão 20): Número de dias para a média móvel.
- Retorno: String com o valor da SMA.
- Exemplo: "SMA(20): 5123.45"
generate_trading_signal
- Descrição: Gera um sinal de negociação baseado na estratégia de cruzamento de médias móveis.
- Parâmetros:
- short_period (inteiro, padrão 10): Período da MA curta.
- long_period (inteiro, padrão 20): Período da MA longa.
- Retorno: String indicando COMPRA, VENDA ou ESPERA.
- Exemplo: "BUY signal"
simulate_trade
- Descrição: Simula a compra ou venda de XAUUSD com o valor especificado.
- Parâmetros:
- action (string): "BUY" ou "SELL"
- amount (float): Quantidade de ouro em onças.
- Retorno: String com o resultado do trade.
- Exemplo: "Simulated BUY: 0.1 oz at 5146.90 USD"
get_portfolio_status
- Descrição: Recupera o status atual do portfólio simulado.
- Parâmetros: Nenhum
- Retorno: String com saldo e posições.
- Exemplo: "Balance: 9742.60 USD\nPositions:\n BUY 0.05 oz at 5148.00 USD\nTotal trades: 2"
ai_research
- Descrição: Realiza pesquisa de mercado alimentada por IA usando múltiplas ferramentas CLI (OpenCode, KiloCode, Gemini).
- Parâmetros:
- query (string): Pergunta de pesquisa sobre condições de mercado.
- tools (lista, opcional): Lista de ferramentas de IA a serem usadas. Padrão: ['opencode', 'kilocode', 'gemini']
- Retorno: Resultados de pesquisa agregados com análise de sentimento.
- Exemplo: "AI Research Summary: BULLISH consensus from 3 tools"
Ferramentas CLI de IA
As seguintes ferramentas CLI de IA são suportadas para pesquisa de mercado:
| Ferramenta | Instalação | Uso |
|---|---|---|
| OpenCode | npm install -g opencode | opencode run "<prompt>" |
| KiloCode | https://kilo.ai | kilo run "<prompt>" |
| Gemini | npm install -g @google/gemini-cli | gemini "<prompt>" |
Uso
- Instalação ClawFlow:
clawflow install claw-gold - Configuração: Edite
config.yamlpara personalizar as configurações. - Integração: Use com o agente OpenClaw para assistência de negociação.
Suporte e Comunidade
Documentação
Suporte Comunitário
- GitHub Issues: Relatórios de bugs e solicitações de funcionalidades
Versão: 2.0.0 Status: Pronto para Produção (Fase 1 Completa) Licença: MIT Mantenedores: JonusNattapong Última Atualização: 4 de Março de 2026
Notas de Lançamento da Fase 1
- ✅ Interface unificada de provedores de IA com LiteLLM
- ✅ Agendamento persistente de jobs com APScheduler
- ✅ Logging aprimorado no console com Rich
- ✅ Rastreamento e análise automática de custos
- ✅ 100% compatível com versões anteriores
Próximo: Fase 2 (PydanticAI + Langfuse SDK) em breve.