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âmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
| --cycle-file | string | obrigatório | Caminho para o JSON do ciclo gerado por cycle_trigger.py |
| --symbol | string | obrigatório | Símbolo de negociação (ex.: ETH, xyz:NVDA) |
| --direction | string | obrigatório | LONG ou SHORT |
| --size-usd | float | obrigatório | Tamanho da posição em USD |
| --dry-run | flag | false | Simulaçã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
| Script | Propósito | Invocação |
|---|---|---|
main.py | Loop de análise/relatório (sem execução) | python3 main.py |
sse_consumer.py | Cliente SSE para stream do tracker | python3 sse_consumer.py |
context_builder_v2.py | Construir contexto completo do ciclo + oportunidades | Importado por main |
trading_brain.py | Tomada de decisão baseada em convicção | Importado por main |
risk_manager.py | Sizing dinâmico + saídas por decaimento | Importado por main |
executor.py | Execução de ordens | Usado por cli.py execute |
learning_engine.py | Aprendizado de pesos de sinais | python3 learning_engine.py |
cli.py | Interface de linha de comando | python3 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 pesosconfig.risk: Sizing de posição e limites de exposiçãoconfig.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ão | Exchange | Exemplo |
|---|---|---|
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ção | Efeito |
|---|---|
| WHALE direção oposta | VETAR negociação |
| CVD oposto com z-score forte | VETAR 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 Ordem | Quando Usar |
|---|---|
| CHASE LIMIT | Alta convicção (≥0.6), alinhado com tendência, sensível ao tempo |
| LIMIT ORDER | Menor convicção (<0.6), contra-tendência, preferência por preenchimento paciente |
Tratamento de Erros
| Erro | Tratamento |
|---|---|
| Desconexão SSE | Reconexão com backoff exponencial (2s-30s) |
| Limite de taxa (429) | Aguardar reabastecimento do token bucket |
| Ordem rejeitada | Registrar e abortar (não tentar novamente) |
| Falha na colocação de SL/TP | Registrar aviso, posição permanece aberta |
| Falha na obtenção de posição | Usar 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/:
| Arquivo | Propósito |
|---|---|
signal_weights.yaml | Multiplicadores de confiança por sinal |
trade_journal.yaml | Histórico de negociações (rolante 1000) |
circuit_breaker.yaml | Perda diária, estado de sequência de perdas |
positions.yaml | Posições ativas |
symbol_blacklist.yaml | Símbolos na lista negra |
context_feature_stats.json | Taxas de acerto por condição de contexto |
mistakes.json | Erros 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.txtquando 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_URLEVCLAW_TRACKER_HIP3_PREDATOR_URLEVCLAW_TRACKER_HIP3_SYMBOLS_URLEVCLAW_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