Communitygithub.com

Degenapetrader/EVClaw

Handelsfertigkeit für die Ausführung von Live-Agenten-Trades auf Lighter (Krypto-Perpetuals) und Hyperliquid (HIP3-Aktien). Verwende dies, wenn der Benutzer über Trading, Positionen, Signale, Trade-Ausführung, Live-Agent-Modus, Zyklusdateien oder die Verwaltung von EVClaw-Operationen spricht.

Was ist EVClaw?

EVClaw ist eine KI-Agenten-Fertigkeit für den automatisierten Handel auf den dezentralen Börsen Lighter (Krypto-Perpetuals) und Hyperliquid (HIP3-Aktien). Sie ermöglicht den Betrieb eines Live-Agenten, der Zyklusdateien verarbeitet, Signale auswertet und Handelsentscheidungen auf Basis von Überzeugungswerten trifft. Die Fertigkeit unterstützt mehrere Plattformen und bietet Funktionen wie dynamisches Risikomanagement, signalbasierte Handelssignale, verschiedene Ausführungsmodi (z. B. CHASE LIMIT, LIMIT ORDER) und einen lernenden Kontext, der Gewinnraten analysiert, um die Positionsgröße anzupassen. Entwickler können über CLI-Befehle wie `/live-agent`, `/trade`, `/signals` und `/positions` mit der Fertigkeit interagieren, um Trades auszuführen, Signale anzuzeigen und Positionen zu verwalten. Die Fertigkeit ist besonders nützlich für Benutzer, die einen automatisierten, agentengesteuerten Handelsansatz mit erweiterten Risikokontrollen und Wiederherstellungsmechanismen suchen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add Degenapetrader/EVClaw

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

EVClaw Trading Skill

Modus: Live Agent (Kontext → Haupt-Agent → Ausführung) Börsen: Lighter (Krypto-Perpetuals), Hyperliquid (HIP3-Aktien)

Architektur

Zyklus-Trigger → Zyklus-Datei + Kontext → System-Ereignis → Haupt-Agent (gpt-5.2)
   ↓               ↓                         ↓                 ↓
 tracker:8443   <runtime_dir>/evclaw_*  live_agent.py    JSON-Kontextauswahl
                                                     ↓
                                     <runtime_dir>/evclaw_candidates_*.json
                                                      ↓
                                     Haupt-Agent validiert + zeichnet Vorschläge auf
                                                      ↓
                                     OpenClaw-Agent führt Vorschläge aus
                                                      ↓
                                              Executor → HL und/oder Lighter

Siehe references/architecture.md für die detaillierte Systemarchitektur.

Hauptfunktionen

  • Live-Agent-Handel (Kontext → Haupt-Agent → Ausführung)
  • Snapshot-basierte Zyklusverarbeitung + Konstruktionswerkzeug für Kontext
  • Ausführung pro Handelsplatz (keine Anforderung, dass ein Symbol an beiden Börsen existiert)
  • Dynamische Größenanpassung + Exposure-Limits via DynamicRiskManager
  • Verfallsbasierte Ausstiege als primäre Ausstiegslogik
  • Optionaler SL/TP-Notfall-Backstop (Konfigurations-Flag)
  • Token-Bucket-Ratenbegrenzung (40 Anfragen/60s)
  • Atomare Positionspersistenz für Crash-Wiederherstellung
  • Agentengesteuerte Incident-Response (Triage + Behebungs-Workflow)

Befehle

/live-agent run/execute

Haupt-Agent-Workflow (Kontext → validieren → Vorschläge aufzeichnen; OpenClaw-Agent führt im AGI-only-Modus aus).

# Vorschläge aus dem letzten ausstehenden Zyklus aufzeichnen
python3 ${EVCLAW_ROOT}/live_agent.py run --from-pending

Ausführen aus Kandidaten (manuelle Überprüfung zuerst):

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 <path> --symbol <symbol> --direction LONG|SHORT --size-usd <float>

Führt eine Entscheidung aus einer Zyklus-Datei aus (Ausführung per Aufruf).

Wichtige Befehlstrennung:

  • /execute <PLAN_ID> chase|limit -> Hilfs-Skill-Plan-Ausführung (openclaw_skills/execute)
  • python3 ${EVCLAW_ROOT}/cli.py execute --cycle-file ... -> Low-Level-Ausführungs-Einstiegspunkt

Parameter:

ParameterTypStandardBeschreibung
--cycle-filestringerforderlichPfad zur Zyklus-JSON von cycle_trigger.py
--symbolstringerforderlichHandelssymbol (z. B. ETH, xyz:NVDA)
--directionstringerforderlichLONG oder SHORT
--size-usdfloaterforderlichPositionsgröße in USD
--dry-runFlagfalseTrockentest (keine echten Orders)
python3 ${EVCLAW_ROOT}/cli.py execute \
  --cycle-file ${EVCLAW_RUNTIME_DIR}/evclaw_cycle_123.json \
  --symbol ETH --direction LONG --size-usd 500

/trade <symbol> <direction> <size_usd>

Führt eine manuelle Handelsentscheidung aus.

python3 ${EVCLAW_ROOT}/cli.py trade <symbol> <direction> <size_usd>

/signals [symbol] [--min-z <float>] [--top <int>]

Zeigt aktuelle handelbare Signale vom Tracker an.

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

/positions [--all] [--close <symbol>] [--export]

Zeigt offene Positionen an und verwaltet sie.

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

Python-Skripte

SkriptZweckAufruf
main.pyAnalyse-/Berichts-Schleife (keine Ausführung)python3 main.py
sse_consumer.pySSE-Client für Tracker-Streampython3 sse_consumer.py
context_builder_v2.pyVollständigen Zyklus-Kontext + Chancen erstellenVon main importiert
trading_brain.pyÜberzeugungsbasierte EntscheidungsfindungVon main importiert
risk_manager.pyDynamische Größenanpassung + VerfallsausstiegeVon main importiert
executor.pyOrderausführungVon cli.py execute verwendet
learning_engine.pySignalgewichtung lernenpython3 learning_engine.py
cli.pyBefehlszeilenschnittstellepython3 cli.py <command>

Analysemodus (keine Ausführung)

# Eine gespeicherte Zyklus-Datei analysieren
python3 ${EVCLAW_ROOT}/main.py --cycle-file ${EVCLAW_RUNTIME_DIR}/evclaw_cycle_123.json

# Mit benutzerdefinierter Konfiguration
python3 ${EVCLAW_ROOT}/main.py --config custom.yaml --cycle-file ${EVCLAW_RUNTIME_DIR}/evclaw_cycle_123.json

# Live-SSE-Analyse (nur Berichte)
python3 ${EVCLAW_ROOT}/main.py

Tests

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

Konfiguration

Die Konfiguration wird aus skill.yaml geladen. Wichtige Einstellungen umfassen:

  • config.mode_controller.mode: Handelsmodus (conservative, balanced, aggressive)
  • config.brain: Überzeugungsschwellen und -gewichte
  • config.risk: Positionsgröße und Expositionslimits
  • config.executor: SL/TP, Chase-Einstellungen, SR-Limit-Konfiguration

Siehe references/configuration.md für die vollständige Konfigurationsreferenz.

Symbol-Routing

MusterBörseBeispiel
xyz:<TICKER>HIP3-Wallet (HIP3-Aktien)xyz:NVDA, xyz:TSLA
<SYMBOL>Lighter (Krypto-Perpetuals)ETH, BTC, kPEPE

Übersteuerungen können in skill.yaml unter exchanges.router.overrides konfiguriert werden.

HIP3 Live Agent: HIP3-Symbole (xyz:) sind HIP3-Wallet-only. Wenn executor.hl_wallet_enabled: true ist, kann der Live-Modus HIP3 ausführen, ohne dass Lighter verfügbar sein muss.

Entscheidungslogik

Überzeugungsbewertung

  • Jedes Signal trägt zu einer Überzeugungsbewertung (0.0 - 1.0) bei
  • Signale werden gewichtet (CVD/FADE/LIQ_PNL/WHALE/DEAD/OFM/HIP3_MAIN)
  • Empfehlungen werden oberhalb der Gehirn-Konfidenzschwelle ausgegeben

Vetobedingungen

BedingungAuswirkung
WHALE entgegengesetzte RichtungVETO-Trade
CVD entgegengesetzt mit starkem z-ScoreVETO-Trade

Risiko & Ausstiege

  • Dynamische Risikogröße basierend auf Überzeugung und Exposition
  • Verfallsbasierte Ausstiege sind primär (Trigger-Signal-Umkehr)
  • Optionaler SL/TP-Notfall-Backstop (executor.enable_sltp_backstop)

Siehe references/signals.md für Signaltypen und Bewertung.

Kontextlernen

Die Lern-Engine verfolgt Gewinnraten nach Kontextbedingungen und passt die Größenanpassung entsprechend an:

  • Wenn genügend Daten vorhanden sind (≥10 Trades pro Bedingung), liefert die Lern-Engine einen Multiplikator
  • Gewinnrate > 45 % → Größe erhöhen (bis zu 1,5x)
  • Gewinnrate < 45 % → Größe reduzieren (bis zu 0,5x)

Verfolgte Kontextmerkmale: trend_alignment, vol_regime, funding_alignment, smart_money, signal_strength.

Siehe references/signals.md für Details zu Kontextmerkmalen.

Auftragsartauswahl

AuftragsartWann verwenden
CHASE LIMITHohe Überzeugung (≥0,6), trendausgerichtet, zeitkritisch
LIMIT ORDERNiedrigere Überzeugung (<0,6), gegen den Trend, geduldiges Ausführen bevorzugt

Fehlerbehandlung

FehlerBehandlung
SSE-VerbindungsabbruchExponentieller Backoff-Wiederholungsversuch (2s-30s)
Ratenbegrenzung (429)Auf Auffüllung des Token-Buckets warten
Order abgelehntProtokollieren und abbrechen (kein erneuter Versuch)
SL/TP-Platzierung fehlgeschlagenWarnung protokollieren, Position bleibt offen
Positionsabruf fehlgeschlagenZwischengespeicherten Zustand verwenden

Protokollierung

Logs werden auf stdout mit folgendem Format geschrieben:

2026-01-25 12:00:00 [executor] INFO: Executing LONG for ETH

Log-Level:

  • INFO: Handelsausführung, Positionsänderungen
  • WARNING: Ratenbegrenzungen, SL/TP-Fehler
  • ERROR: Orderfehler, Börsenfehler

Speicherdateien

Der persistente Zustand wird in memory/ gespeichert:

DateiZweck
signal_weights.yamlKonfidenzmultiplikatoren pro Signal
trade_journal.yamlHandelsverlauf (rollierend 1000)
circuit_breaker.yamlTagesverlust, Verluststrangzustand
positions.yamlAktive Positionen
symbol_blacklist.yamlSchwarze Liste von Symbolen
context_feature_stats.jsonGewinnraten nach Kontextbedingung
mistakes.jsonKlassifizierte Handelsfehler

Siehe references/memory-files.md für Dateiformate.

Anforderungen

Python-Pakete

  • aiohttp>=3.9.0
  • pyyaml>=6.0
  • requests>=2.31.0
  • python-dotenv>=1.0.1
  • hyperliquid-python-sdk>=0.21.0
  • lighter-sdk (optional, installiert aus requirements-lighter.txt, wenn Lighter-Handelsplatz aktiviert ist)

Systemabhängigkeiten

  • Python 3.10+
  • Lighter-Umgebungsvariablen: LIGHTER_BASE_URL, LIGHTER_ACCOUNT_INDEX, LIGHTER_API_KEY_PRIVATE_KEY, LIGHTER_API_KEY_INDEX
  • Hyperliquid-Umgebungsvariablen: HYPERLIQUID_ADDRESS (Hauptwallet-Adresse), HYPERLIQUID_AGENT_PRIVATE_KEY (delegierter Signierschlüssel; nicht Hauptwallet-Private-Key)
  • Optional Hyperliquid: HYPERLIQUID_PRIVATE_NODE, EVCLAW_INCLUDE_WALLET_HIP3_FILLS
  • Handelsplatzsteuerung: EVCLAW_ENABLED_VENUES
  • Massive-Umgebungsvariable (HIP3-Prädatorsignale): MASSIVE_API_KEY
  • Tracker-APIs (extern gehostet über evplus-Tracker):
    • EVCLAW_TRACKER_BASE_URL
    • EVCLAW_TRACKER_HIP3_PREDATOR_URL
    • EVCLAW_TRACKER_HIP3_SYMBOLS_URL
    • EVCLAW_TRACKER_SYMBOL_URL_TEMPLATE
  • EVClaw OSS ist netzwerkbasiert: Alle Tracker-Daten werden von tracker.evplus.ai abgerufen
  • SSE-Tracker läuft auf tracker.evplus.ai:8443

Unterfertigkeiten

EVClaw enthält Unterfertigkeiten in openclaw_skills/:

  • trade: Manueller Handelsplaner (/trade <SYMBOL>)
  • execute: Ausführen gespeicherter Handelspläne (/execute <PLAN_ID>)
  • hedge: Portfolio-Absicherungsoperationen
  • stats: Handelsstatistiken und -berichte
  • best3: Top-3-Chancen-Anzeige

Verwandte Skills