evclaw

star 38

Trading skill for executing live agent trades on Lighter (crypto perps) and Hyperliquid (HIP3 stocks). Use when user asks about trading, positions, signals, executing trades, live agent mode, cycle files, or managing EVClaw operations. Supports (1) Running live agent cycles via /live-agent, (2) Executing manual trades via /trade and /execute, (3) Viewing signals/positions, (4) Managing trading configuration, (5) Understanding signal types and decision logic, (6) Agent-driven incident response and triage.

Degenapetrader By Degenapetrader schedule Updated 4/28/2026
play_arrow Run Skill in Manus View GitHub

name: EVClaw description: Trading skill for executing live agent trades on Lighter (crypto perps) and Hyperliquid (HIP3 stocks). Use when user asks about trading, positions, signals, executing trades, live agent mode, cycle files, or managing EVClaw operations. Supports (1) Running live agent cycles via /live-agent, (2) Executing manual trades via /trade and /execute, (3) Viewing signals/positions, (4) Managing trading configuration, (5) Understanding signal types and decision logic, (6) Agent-driven incident response and triage.

EVClaw Trading Skill

Mode: Live Agent (context → main agent → execute) Exchanges: Lighter (crypto perps), Hyperliquid (HIP3 stocks)

Architecture

Cycle Trigger → Cycle File + Context → System Event → Main Agent (gpt-5.2)
   ↓               ↓                         ↓                 ↓
 tracker:8443   <runtime_dir>/evclaw_*  live_agent.py    JSON context selection
                                                     ↓
                                     <runtime_dir>/evclaw_candidates_*.json
                                                      ↓
                                     Main Agent validate + record proposals
                                                      ↓
                                     OpenClaw agent executes proposals
                                                      ↓
                                              Executor → HL and/or Lighter

See references/architecture.md for detailed system architecture.

Key Features

  • Live agent trading (context → main agent → execute)
  • Snapshot-driven cycle handling + context builder
  • Per-venue execution (no requirement that a symbol exists on both exchanges)
  • Dynamic sizing + exposure limits via DynamicRiskManager
  • Decay-based exits as primary exit logic
  • Optional SL/TP emergency backstop (config flag)
  • Token bucket rate limiting (40 req/60s)
  • Atomic position persistence for crash recovery
  • Agent-driven incident response (triage + remediation workflow)

Commands

/live-agent run/execute

Main agent workflow (context → validate → record proposals; OpenClaw agent executes in AGI-only mode).

# Record proposals from the most recent pending cycle
python3 ${EVCLAW_ROOT}/live_agent.py run --from-pending

Execute from candidates (manual review first):

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>

Execute a decision from a cycle file (execution-by-call).

Important command split:

  • /execute <PLAN_ID> chase|limit -> helper skill plan execution (openclaw_skills/execute).
  • python3 ${EVCLAW_ROOT}/cli.py execute --cycle-file ... -> low-level executor entrypoint.

Parameters:

Param Type Default Description
--cycle-file string required Path to cycle JSON from cycle_trigger.py
--symbol string required Trading symbol (e.g., ETH, xyz:NVDA)
--direction string required LONG or SHORT
--size-usd float required Position size in USD
--dry-run flag false Dry run (no real 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>

Execute a manual trade decision.

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

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

View current actionable signals from the tracker.

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

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

View and manage open positions.

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

Python Scripts

Script Purpose Invocation
main.py Analysis/report loop (no execution) python3 main.py
sse_consumer.py SSE client for tracker stream python3 sse_consumer.py
context_builder_v2.py Build full cycle context + opportunities Imported by main
trading_brain.py Conviction-based decisioning Imported by main
risk_manager.py Dynamic sizing + decay exits Imported by main
executor.py Order execution Used by cli.py execute
learning_engine.py Signal weight learning python3 learning_engine.py
cli.py Command-line interface python3 cli.py <command>

Analysis Mode (No Execution)

# Analyze a saved cycle file
python3 ${EVCLAW_ROOT}/main.py --cycle-file ${EVCLAW_RUNTIME_DIR}/evclaw_cycle_123.json

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

# Live SSE analysis (reports only)
python3 ${EVCLAW_ROOT}/main.py

Testing

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

Configuration

Configuration is loaded from skill.yaml. Key settings include:

  • config.mode_controller.mode: Trading mode (conservative, balanced, aggressive)
  • config.brain: Conviction thresholds and weights
  • config.risk: Position sizing and exposure limits
  • config.executor: SL/TP, chase settings, SR-limit config

See references/configuration.md for complete config reference.

Symbol Routing

Pattern Exchange Example
xyz:<TICKER> HIP3 wallet (HIP3 stocks) xyz:NVDA, xyz:TSLA
<SYMBOL> Lighter (crypto perps) ETH, BTC, kPEPE

Overrides can be configured in skill.yaml under exchanges.router.overrides.

HIP3 Live Agent: HIP3 symbols (xyz:) are HIP3 wallet-only. If executor.hl_wallet_enabled: true, live mode can execute HIP3 without requiring Lighter availability.

Decision Logic

Conviction Scoring

  • Each signal contributes to a conviction score (0.0 - 1.0)
  • Signals are weighted (CVD/FADE/LIQ_PNL/WHALE/DEAD/OFM/HIP3_MAIN)
  • Recommendations are produced above the brain confidence threshold

Veto Conditions

Condition Effect
WHALE opposite direction VETO trade
CVD opposite with strong z-score VETO trade

Risk & Exits

  • Dynamic risk sizing based on conviction and exposure
  • Decay-based exits are primary (trigger signal flip)
  • SL/TP optional emergency backstop (executor.enable_sltp_backstop)

See references/signals.md for signal types and scoring.

Context Learning

The learning engine tracks win rates by context conditions and adjusts sizing accordingly:

  • When enough data exists (≥10 trades per condition), the learning engine provides a multiplier
  • Win rate > 45% → boost sizing (up to 1.5x)
  • Win rate < 45% → reduce sizing (down to 0.5x)

Context features tracked: trend_alignment, vol_regime, funding_alignment, smart_money, signal_strength.

See references/signals.md for context features details.

Order Type Selection

Order Type When to Use
CHASE LIMIT High conviction (≥0.6), trend-aligned, time-sensitive
LIMIT ORDER Lower conviction (<0.6), counter-trend, patient fill preferred

Error Handling

Error Handling
SSE disconnect Exponential backoff reconnect (2s-30s)
Rate limit (429) Wait for token bucket refill
Order rejected Log and abort (don't retry)
SL/TP placement fail Log warning, position remains open
Position fetch fail Use cached state

Logging

Logs are written to stdout with format:

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

Log levels:

  • INFO: Trade execution, position changes
  • WARNING: Rate limits, SL/TP failures
  • ERROR: Order failures, exchange errors

Memory Files

Persistent state is stored in memory/:

File Purpose
signal_weights.yaml Per-signal confidence multipliers
trade_journal.yaml Trade history (rolling 1000)
circuit_breaker.yaml Daily loss, loss streak state
positions.yaml Active positions
symbol_blacklist.yaml Blacklisted symbols
context_feature_stats.json Win rates by context condition
mistakes.json Classified trading mistakes

See references/memory-files.md for file formats.

Requirements

Python Packages

  • 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, installed from requirements-lighter.txt when Lighter venue is enabled)

System Dependencies

  • Python 3.10+
  • Lighter env vars: LIGHTER_BASE_URL, LIGHTER_ACCOUNT_INDEX, LIGHTER_API_KEY_PRIVATE_KEY, LIGHTER_API_KEY_INDEX
  • Hyperliquid env vars: HYPERLIQUID_ADDRESS (main wallet address), HYPERLIQUID_AGENT_PRIVATE_KEY (delegated signer key; not main wallet private key)
  • Optional Hyperliquid: HYPERLIQUID_PRIVATE_NODE, EVCLAW_INCLUDE_WALLET_HIP3_FILLS
  • Venue controls: EVCLAW_ENABLED_VENUES
  • Massive env var (HIP3 predator signals): MASSIVE_API_KEY
  • Tracker APIs (hosted externally via evplus tracker):
    • EVCLAW_TRACKER_BASE_URL
    • EVCLAW_TRACKER_HIP3_PREDATOR_URL
    • EVCLAW_TRACKER_HIP3_SYMBOLS_URL
    • EVCLAW_TRACKER_SYMBOL_URL_TEMPLATE
  • EVClaw OSS is network-only: all tracker data is fetched from tracker.evplus.ai
  • SSE tracker running on tracker.evplus.ai:8443

Sub-Skills

EVClaw includes sub-skills in openclaw_skills/:

  • trade: Manual trade planner (/trade <SYMBOL>)
  • execute: Execute stored trade plans (/execute <PLAN_ID>)
  • hedge: Portfolio hedging operations
  • stats: Trading statistics and reports
  • best3: Top 3 opportunities display
Install via CLI
npx skills add https://github.com/Degenapetrader/EVClaw --skill evclaw
Repository Details
star Stars 38
call_split Forks 12
navigation Branch main
article Path SKILL.md
Occupations
Financial Risk Specialists
More from Creator
Degenapetrader
Degenapetrader Explore all skills →