Communitygithub.com

Degenapetrader/EVClaw

Habilidade de negociação para executar ordens de agente ao vivo na Lighter (perpétuos de cripto) e Hyperliquid (ações HIP3). Use quando o usuário perguntar sobre negociação, posições, sinais, execução de ordens, modo agente ao vivo, arquivos de ciclo ou gerenciamento de operações EVClaw.

O que é EVClaw?

O EVClaw é uma skill de trading avançada projetada para agentes de IA que desejam operar em exchanges descentralizadas como Lighter (contratos perpétuos de criptomoedas) e Hyperliquid (ações sintéticas HIP3). A skill opera em modo 'Live Agent', onde um agente principal (como o GPT-5.2) analisa o contexto de mercado gerado por ciclos de snapshot e decide se deve executar propostas de negociação via um agente executor dedicado (OpenClaw). Seus principais recursos incluem: execução por snapshot com construtor de contexto, sizing dinâmico com gerenciador de risco adaptativo, saídas baseadas em decaimento de sinal como lógica primária, stop-loss/take-profit opcional como backstop de emergência, rate limiting via token bucket (40 requisições/60s), e persistência atômica de posições para recuperação em caso de falha. A skill também suporta respostas a incidentes orientadas pelo agente, com fluxo de triagem e remediação. Suporte a múltiplas plataformas: a skill é executada em Python 3.10+ com dependências como aiohttp, pyyaml, hyperliquid-python-sdk, e lighter-sdk (opcional). As variáveis de ambiente controlam acesso a Lighter, Hyperliquid e ao tracker EVPlus, que fornece dados de mercado e sinais. A skill é configurável via arquivo `skill.yaml`, permitindo ajustar modo de trading (conservador, balanceado, agressivo), limites de exposição e pesos de sinais. A lógica de decisão combina pontuação de convicção (0.0 a 1.0) a partir de múltiplos tipos de sinal (CVD, FADE, LIQ_PNL, WHALE, etc.) com condições de veto (ex.: sinal WHALE em direção oposta). O motor de aprendizado ajusta o sizing com base no histórico de win rate por contexto. A skill também gerencia memória persistente em arquivos como signal_weights.yaml, trade_journal.yaml e circuit_breaker.yaml.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add Degenapetrader/EVClaw

Perguntar na sua IA favorita

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

Documentação

Habilidade de Trading EVClaw

Modo: Agente ao Vivo (contexto → agente principal → executar) Exchanges: Lighter (perpétuos cripto), Hyperliquid (ações HIP3)

Arquitetura

Disparo de Ciclo → Arquivo de Ciclo + Contexto → Evento do Sistema → Agente Principal (gpt-5.2)
   ↓                    ↓                             ↓                 ↓
 tracker:8443      <runtime_dir>/evclaw_*       live_agent.py      Seleção de contexto JSON
                                                     ↓
                                     <runtime_dir>/evclaw_candidates_*.json
                                                      ↓
                   Agente Principal valida + registra propostas
                                                      ↓
                   Agente OpenClaw executa propostas
                                                      ↓
                            Executor → HL e/ou Lighter

Consulte referências/architecture.md para arquitetura detalhada do sistema.

Funcionalidades Principais

  • Trading com agente ao vivo (contexto → agente principal → executar)
  • Manipulação de ciclos orientada por snapshot + construtor de contexto
  • Execução por exchange (sem exigência de que um símbolo exista em ambas as exchanges)
  • Sizing dinâmico + limites de exposição via DynamicRiskManager
  • Saídas baseadas em decaimento como lógica principal de saída
  • Backstop opcional de stop-loss/take-profit (flag de configuração)
  • Limitação de taxa com token bucket (40 req/60s)
  • Persistência atômica de posições para recuperação de falhas
  • Resposta a incidentes orientada por agente (fluxo de triagem + remediação)

Comandos

/live-agent run/execute

Fluxo principal do agente (contexto → validar → registrar propostas; agente OpenClaw executa no modo apenas-AGI).

# Registrar propostas do ciclo pendente mais recente
python3 ${EVCLAW_ROOT}/live_agent.py run --from-pending

Executar a partir de candidatos (primeiro revisão manual):

python3 ${EVCLAW_ROOT}/live_agent.py execute \
  --seq 12345 \
  --cycle-file ${EVCLAW_RUNTIME_DIR}/evclaw_cycle_12345.json \
  --candidates-file ${EVCLAW_RUNTIME_DIR}/evclaw_candidates_12345.json

cli execute --cycle-file <caminho> --symbol <símbolo> --direction LONG|SHORT --size-usd <float>

Executar uma decisão a partir de um arquivo de ciclo (execução por chamada).

Divisão importante de comandos:

  • /execute <PLAN_ID> chase|limit -> execução de plano de habilidade auxiliar (openclaw_skills/execute).
  • python3 ${EVCLAW_ROOT}/cli.py execute --cycle-file ... -> ponto de entrada do executor de baixo nível.

Parâmetros:

ParâmetroTipoPadrãoDescrição
--cycle-filestringobrigatórioCaminho para o JSON do ciclo gerado por cycle_trigger.py
--symbolstringobrigatórioSímbolo de negociação (ex.: ETH, xyz:NVDA)
--directionstringobrigatórioLONG ou SHORT
--size-usdfloatobrigatórioTamanho da posição em USD
--dry-runflagfalseSimulação (nenhuma ordem real)
python3 ${EVCLAW_ROOT}/cli.py execute \
  --cycle-file ${EVCLAW_RUNTIME_DIR}/evclaw_cycle_123.json \
  --symbol ETH --direction LONG --size-usd 500

/trade <símbolo> <direção> <tamanho_usd>

Executar uma decisão de negociação manual.

python3 ${EVCLAW_ROOT}/cli.py trade <símbolo> <direção> <tamanho_usd>

/signals [símbolo] [--min-z <float>] [--top <int>]

Visualizar sinais acionáveis atuais do tracker.

python3 ${EVCLAW_ROOT}/cli.py signals [símbolo] [--min-z <float>] [--top <int>]

/positions [--all] [--close <símbolo>] [--export]

Visualizar e gerenciar posições abertas.

python3 ${EVCLAW_ROOT}/cli.py positions [--all] [--close <símbolo>] [--export]

Scripts Python

ScriptPropósitoInvocação
main.pyLoop de análise/relatório (sem execução)python3 main.py
sse_consumer.pyCliente SSE para stream do trackerpython3 sse_consumer.py
context_builder_v2.pyConstruir contexto completo do ciclo + oportunidadesImportado por main
trading_brain.pyTomada de decisão baseada em convicçãoImportado por main
risk_manager.pySizing dinâmico + saídas por decaimentoImportado por main
executor.pyExecução de ordensUsado por cli.py execute
learning_engine.pyAprendizado de pesos de sinaispython3 learning_engine.py
cli.pyInterface de linha de comandopython3 cli.py <comando>

Modo de Análise (Sem Execução)

# Analisar um arquivo de ciclo salvo
python3 ${EVCLAW_ROOT}/main.py --cycle-file ${EVCLAW_RUNTIME_DIR}/evclaw_cycle_123.json

# Com configuração personalizada
python3 ${EVCLAW_ROOT}/main.py --config custom.yaml --cycle-file ${EVCLAW_RUNTIME_DIR}/evclaw_cycle_123.json

# Análise SSE ao vivo (apenas relatórios)
python3 ${EVCLAW_ROOT}/main.py

Testes

python3 ${EVCLAW_ROOT}/tests/test_trading_brain.py
python3 ${EVCLAW_ROOT}/tests/test_executor.py

Configuração

A configuração é carregada de skill.yaml. Configurações principais incluem:

  • config.mode_controller.mode: Modo de trading (conservative, balanced, aggressive)
  • config.brain: Limiares de convicção e pesos
  • config.risk: Sizing de posição e limites de exposição
  • config.executor: SL/TP, configurações de chase, limite de SR

Consulte referências/configuration.md para referência completa de configuração.

Roteamento de Símbolos

PadrãoExchangeExemplo
xyz:<TICKER>Carteira HIP3 (ações HIP3)xyz:NVDA, xyz:TSLA
<SYMBOL>Lighter (perpétuos cripto)ETH, BTC, kPEPE

Sobrescritas podem ser configuradas em skill.yaml sob exchanges.router.overrides.

Agente ao Vivo HIP3: Símbolos HIP3 (xyz:) são exclusivos da carteira HIP3. Se executor.hl_wallet_enabled: true, o modo ao vivo pode executar HIP3 sem exigir disponibilidade Lighter.

Lógica de Decisão

Pontuação de Convicção

  • Cada sinal contribui para uma pontuação de convicção (0.0 - 1.0)
  • Sinais são ponderados (CVD/FADE/LIQ_PNL/WHALE/DEAD/OFM/HIP3_MAIN)
  • Recomendações são produzidas acima do limiar de confiança do cérebro

Condições de Veto

CondiçãoEfeito
WHALE direção opostaVETAR negociação
CVD oposto com z-score forteVETAR negociação

Risco e Saídas

  • Sizing de risco dinâmico baseado em convicção e exposição
  • Saídas baseadas em decaimento são primárias (inversão de sinal gatilho)
  • SL/TP opcional como backstop de emergência (executor.enable_sltp_backstop)

Consulte referências/signals.md para tipos de sinal e pontuação.

Aprendizado de Contexto

O motor de aprendizado rastreia taxas de acerto por condições de contexto e ajusta o sizing de acordo:

  • Quando há dados suficientes (≥10 negociações por condição), o motor de aprendizado fornece um multiplicador
  • Taxa de acerto > 45% → aumentar sizing (até 1.5x)
  • Taxa de acerto < 45% → reduzir sizing (até 0.5x)

Características de contexto rastreadas: trend_alignment, vol_regime, funding_alignment, smart_money, signal_strength.

Consulte referências/signals.md para detalhes sobre características de contexto.

Seleção de Tipo de Ordem

Tipo de OrdemQuando Usar
CHASE LIMITAlta convicção (≥0.6), alinhado com tendência, sensível ao tempo
LIMIT ORDERMenor convicção (<0.6), contra-tendência, preferência por preenchimento paciente

Tratamento de Erros

ErroTratamento
Desconexão SSEReconexão com backoff exponencial (2s-30s)
Limite de taxa (429)Aguardar reabastecimento do token bucket
Ordem rejeitadaRegistrar e abortar (não tentar novamente)
Falha na colocação de SL/TPRegistrar aviso, posição permanece aberta
Falha na obtenção de posiçãoUsar estado em cache

Registro de Logs

Os logs são escritos em stdout com formato:

2026-01-25 12:00:00 [executor] INFO: Executando LONG para ETH

Níveis de log:

  • INFO: Execução de negociação, mudanças de posição
  • WARNING: Limites de taxa, falhas de SL/TP
  • ERROR: Falhas de ordem, erros de exchange

Arquivos de Memória

Estado persistente é armazenado em memory/:

ArquivoPropósito
signal_weights.yamlMultiplicadores de confiança por sinal
trade_journal.yamlHistórico de negociações (rolante 1000)
circuit_breaker.yamlPerda diária, estado de sequência de perdas
positions.yamlPosições ativas
symbol_blacklist.yamlSímbolos na lista negra
context_feature_stats.jsonTaxas de acerto por condição de contexto
mistakes.jsonErros de negociação classificados

Consulte referências/memory-files.md para formatos de arquivo.

Requisitos

Pacotes Python

  • aiohttp>=3.9.0
  • pyyaml>=6.0
  • requests>=2.31.0
  • python-dotenv>=1.0.1
  • hyperliquid-python-sdk>=0.21.0
  • lighter-sdk (opcional, instalado a partir de requirements-lighter.txt quando a exchange Lighter está habilitada)

Dependências do Sistema

  • Python 3.10+
  • Variáveis de ambiente Lighter: LIGHTER_BASE_URL, LIGHTER_ACCOUNT_INDEX, LIGHTER_API_KEY_PRIVATE_KEY, LIGHTER_API_KEY_INDEX
  • Variáveis de ambiente Hyperliquid: HYPERLIQUID_ADDRESS (endereço principal da carteira), HYPERLIQUID_AGENT_PRIVATE_KEY (chave privada do signatário delegado; não a chave privada da carteira principal)
  • Hyperliquid opcional: HYPERLIQUID_PRIVATE_NODE, EVCLAW_INCLUDE_WALLET_HIP3_FILLS
  • Controles de exchange: EVCLAW_ENABLED_VENUES
  • Variável de ambiente Massive (sinais predadores HIP3): MASSIVE_API_KEY
  • APIs do tracker (hospedadas externamente via tracker evplus):
    • EVCLAW_TRACKER_BASE_URL
    • EVCLAW_TRACKER_HIP3_PREDATOR_URL
    • EVCLAW_TRACKER_HIP3_SYMBOLS_URL
    • EVCLAW_TRACKER_SYMBOL_URL_TEMPLATE
  • EVClaw OSS é apenas em rede: todos os dados do tracker são obtidos de tracker.evplus.ai
  • Tracker SSE executando em tracker.evplus.ai:8443

Sub-Habilidades

EVClaw inclui sub-habilidades em openclaw_skills/:

  • trade: Planejador de negociação manual (/trade <SYMBOL>)
  • execute: Executar planos de negociação armazenados (/execute <PLAN_ID>)
  • hedge: Operações de hedge de portfólio
  • stats: Estatísticas e relatórios de negociação
  • best3: Exibição das 3 melhores oportunidades

Habilidades Relacionadas