Communitygithub.com

OpenKrab/ClawGold

Sistema de negociação de XAUUSD com IA, utilizando LiteLLM, APScheduler e estratégias avançadas.

O que é ClawGold?

ClawGold é um sistema autônomo de negociação de XAUUSD (Ouro vs Dólar Americano) alimentado por agentes de IA. Ele integra múltiplos provedores de LLM através do LiteLLM, oferece um backend robusto de agendamento de tarefas com APScheduler, realiza análises técnicas avançadas, análises de sentimento em tempo real e execução automatizada de trades. O sistema prioriza segurança mantendo arquitetura local-first, com bancos de dados SQLite auto-hospedados e sem compartilhamento de dados. Suporta ferramentas CLI de IA como OpenCode, KiloCode e Gemini para pesquisas de mercado paralelas, e fornece ferramentas como get_xauusd_price, calculate_moving_average, generate_trading_signal, simulate_trade, get_portfolio_status e ai_research. Ideal para traders que buscam automação com supervisão de IA, permitindo testes de estratégias sem risco real.

Funciona com~Claude Code✓Codex CLI~Cursor✓Gemini CLI✓OpenCode
npx skills add OpenKrab/ClawGold

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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.log com 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:

FerramentaInstalaçãoUso
OpenCodenpm install -g opencodeopencode run "<prompt>"
KiloCodehttps://kilo.aikilo run "<prompt>"
Gemininpm install -g @google/gemini-cligemini "<prompt>"

Uso

  • Instalação ClawFlow: clawflow install claw-gold
  • Configuração: Edite config.yaml para 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.

Habilidades Relacionadas