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:
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| --cycle-file | string | erforderlich | Pfad zur Zyklus-JSON von cycle_trigger.py |
| --symbol | string | erforderlich | Handelssymbol (z. B. ETH, xyz:NVDA) |
| --direction | string | erforderlich | LONG oder SHORT |
| --size-usd | float | erforderlich | Positionsgröße in USD |
| --dry-run | Flag | false | Trockentest (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
| Skript | Zweck | Aufruf |
|---|---|---|
main.py | Analyse-/Berichts-Schleife (keine Ausführung) | python3 main.py |
sse_consumer.py | SSE-Client für Tracker-Stream | python3 sse_consumer.py |
context_builder_v2.py | Vollständigen Zyklus-Kontext + Chancen erstellen | Von main importiert |
trading_brain.py | Überzeugungsbasierte Entscheidungsfindung | Von main importiert |
risk_manager.py | Dynamische Größenanpassung + Verfallsausstiege | Von main importiert |
executor.py | Orderausführung | Von cli.py execute verwendet |
learning_engine.py | Signalgewichtung lernen | python3 learning_engine.py |
cli.py | Befehlszeilenschnittstelle | python3 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 -gewichteconfig.risk: Positionsgröße und Expositionslimitsconfig.executor: SL/TP, Chase-Einstellungen, SR-Limit-Konfiguration
Siehe references/configuration.md für die vollständige Konfigurationsreferenz.
Symbol-Routing
| Muster | Börse | Beispiel |
|---|---|---|
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
| Bedingung | Auswirkung |
|---|---|
| WHALE entgegengesetzte Richtung | VETO-Trade |
| CVD entgegengesetzt mit starkem z-Score | VETO-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
| Auftragsart | Wann verwenden |
|---|---|
| CHASE LIMIT | Hohe Überzeugung (≥0,6), trendausgerichtet, zeitkritisch |
| LIMIT ORDER | Niedrigere Überzeugung (<0,6), gegen den Trend, geduldiges Ausführen bevorzugt |
Fehlerbehandlung
| Fehler | Behandlung |
|---|---|
| SSE-Verbindungsabbruch | Exponentieller Backoff-Wiederholungsversuch (2s-30s) |
| Ratenbegrenzung (429) | Auf Auffüllung des Token-Buckets warten |
| Order abgelehnt | Protokollieren und abbrechen (kein erneuter Versuch) |
| SL/TP-Platzierung fehlgeschlagen | Warnung protokollieren, Position bleibt offen |
| Positionsabruf fehlgeschlagen | Zwischengespeicherten 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:
| Datei | Zweck |
|---|---|
signal_weights.yaml | Konfidenzmultiplikatoren pro Signal |
trade_journal.yaml | Handelsverlauf (rollierend 1000) |
circuit_breaker.yaml | Tagesverlust, Verluststrangzustand |
positions.yaml | Aktive Positionen |
symbol_blacklist.yaml | Schwarze Liste von Symbolen |
context_feature_stats.json | Gewinnraten nach Kontextbedingung |
mistakes.json | Klassifizierte 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_URLEVCLAW_TRACKER_HIP3_PREDATOR_URLEVCLAW_TRACKER_HIP3_SYMBOLS_URLEVCLAW_TRACKER_SYMBOL_URL_TEMPLATE
- EVClaw OSS ist netzwerkbasiert: Alle Tracker-Daten werden von
tracker.evplus.aiabgerufen - 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