Communitygithub.com

EVClaw 트레이딩 스킬

Lighter(암호화폐 무기한 선물) 및 Hyperliquid(HIP3 주식)에서 실시간 에이전트 거래를 실행하는 트레이딩 스킬입니다. 사용자가 트레이딩, 포지션, 시그널, 실시간 거래 실행, 라이브 에이전트 모드, 사이클 파일, EVClaw 운영 관리 등을 요청할 때 사용합니다.

EVClaw 트레이딩 스킬란 무엇인가요?

EVClaw는 암호화폐 무기한 선물 거래소 Lighter와 HIP3 주식 거래소 Hyperliquid에서 작동하는 AI 에이전트 기반 트레이딩 스킬입니다. 이 스킬은 실시간 데이터 스트림(SSE)을 기반으로 컨텍스트를 구성하고, 메인 에이전트(gpt-5.2)가 신호를 평가하여 제안을 생성한 후, OpenClaw 에이전트가 실제 주문을 실행하는 '라이브 에이전트' 워크플로를 지원합니다. 주요 기능으로는 스냅샷 기반 사이클 처리, 거래소별 독립 실행(심볼이 두 거래소에 모두 존재할 필요 없음), 동적 포지션 크기 및 노출 한도 관리(DynamicRiskManager), 신호 반전 시 자동 청산(Decay-based exits), 선택적 손절/이익실현(TP/SL) 백스톱, 속도 제한(40회/60초), 원자적 포지션 저장(크래시 복구 지원), 그리고 에이전트 주도 장애 대응(트라이지 및 수정 워크플로) 등을 포함합니다. 사용자는 CLI 명령어(`/trade`, `/execute`, `/signals`, `/positions`, `/live-agent`)와 환경 변수를 통해 거래 전략, 위험 설정, 심볼 라우팅 등을 제어할 수 있으며, 컨텍스트 학습 엔진이 거래 조건별 승률을 추적하여 포지션 크기를 자동 조정합니다. EVClaw는 또한 학습 엔진, 위험 관리자, 실행기, 신호 가중치 학습 등의 모듈형 파이썬 스크립트로 구성되어 있으며, 메모리 파일(시그널 가중치, 거래 일지, 서킷 브레이커 등)을 통해 지속적 상태를 유지합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add Degenapetrader/EVClaw

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

EVClaw 트레이딩 스킬은(는) 무엇을 하나요?

모드: 라이브 에이전트 (컨텍스트 → 메인 에이전트 → 실행) 거래소: Lighter (암호화폐 무기한 선물), Hyperliquid (HIP3 주식)

아키텍처

사이클 트리거 → 사이클 파일 + 컨텍스트 → 시스템 이벤트 → 메인 에이전트 (gpt-5.2)
   ↓               ↓                         ↓                 ↓
 tracker:8443   <runtime_dir>/evclaw_*  live_agent.py    JSON 컨텍스트 선택
                                                     ↓
                                     <runtime_dir>/evclaw_candidates_*.json
                                                      ↓
                                     메인 에이전트 검증 + 제안 기록
                                                      ↓
                                     OpenClaw 에이전트가 제안 실행
                                                      ↓
                                              실행기 → HL 및/또는 Lighter

자세한 시스템 아키텍처는 references/architecture.md를 참조하세요.

주요 기능

  • 라이브 에이전트 트레이딩 (컨텍스트 → 메인 에이전트 → 실행)
  • 스냅샷 기반 사이클 처리 + 컨텍스트 빌더
  • 거래소별 개별 실행 (심볼이 두 거래소에 모두 존재할 필요 없음)
  • DynamicRiskManager를 통한 동적 포지션 크기 조정 + 노출 한도
  • Decay 기반 청산 (기본 청산 로직)
  • 선택적 SL/TP 비상 백스톱 (설정 플래그)
  • 토큰 버킷 속도 제한 (40회/60초)
  • 크래시 복구를 위한 원자적 포지션 저장
  • 에이전트 주도 장애 대응 (트라이지 + 수정 워크플로)

명령어

/live-agent run/execute

메인 에이전트 워크플로 (컨텍스트 → 검증 → 제안 기록; OpenClaw 에이전트가 AGI-only 모드로 실행).

# 가장 최근의 대기 중인 사이클에서 제안 기록
python3 ${EVCLAW_ROOT}/live_agent.py run --from-pending

후보에서 실행 (수동 검토 후):

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 <PLAN_ID> chase|limit -> 헬퍼 스킬 계획 실행 (openclaw_skills/execute).
  • python3 ${EVCLAW_ROOT}/cli.py execute --cycle-file ... -> 저수준 실행기 진입점.

매개변수:

매개변수타입기본값설명
--cycle-filestring필수cycle_trigger.py에서 생성된 사이클 JSON 경로
--symbolstring필수거래 심볼 (예: ETH, xyz:NVDA)
--directionstring필수LONG 또는 SHORT
--size-usdfloat필수USD 기준 포지션 크기
--dry-runflagfalse실제 주문 없이 시뮬레이션
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>

수동 거래 결정 실행.

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

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

트래커로부터 현재 실행 가능한 시그널 조회.

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

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

현재 보유 포지션 조회 및 관리.

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

파이썬 스크립트

스크립트목적호출
main.py분석/리포트 루프 (실행 없음)python3 main.py
sse_consumer.py트래커 스트림을 위한 SSE 클라이언트python3 sse_consumer.py
context_builder_v2.py전체 사이클 컨텍스트 + 기회 구성main에서 임포트
trading_brain.py확신 기반 의사 결정main에서 임포트
risk_manager.py동적 크기 조정 + decay 청산main에서 임포트
executor.py주문 실행cli.py execute에서 사용
learning_engine.py시그널 가중치 학습python3 learning_engine.py
cli.py명령줄 인터페이스python3 cli.py <command>

분석 모드 (실행 없음)

# 저장된 사이클 파일 분석
python3 ${EVCLAW_ROOT}/main.py --cycle-file ${EVCLAW_RUNTIME_DIR}/evclaw_cycle_123.json

# 사용자 정의 설정 사용
python3 ${EVCLAW_ROOT}/main.py --config custom.yaml --cycle-file ${EVCLAW_RUNTIME_DIR}/evclaw_cycle_123.json

# 라이브 SSE 분석 (리포트만)
python3 ${EVCLAW_ROOT}/main.py

테스트

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

설정

설정은 skill.yaml에서 로드됩니다. 주요 설정은 다음과 같습니다:

  • config.mode_controller.mode: 거래 모드 (conservative, balanced, aggressive)
  • config.brain: 확신 임계값 및 가중치
  • config.risk: 포지션 크기 조정 및 노출 한도
  • config.executor: SL/TP, chase 설정, SR-limit 설정

전체 설정 참조는 references/configuration.md를 확인하세요.

심볼 라우팅

패턴거래소예시
xyz:<TICKER>HIP3 지갑 (HIP3 주식)xyz:NVDA, xyz:TSLA
<SYMBOL>Lighter (암호화폐 무기한 선물)ETH, BTC, kPEPE

오버라이드는 skill.yaml의 exchanges.router.overrides에서 설정할 수 있습니다.

HIP3 라이브 에이전트: HIP3 심볼 (xyz:)은 HIP3 지갑 전용입니다. executor.hl_wallet_enabled: true인 경우 라이브 모드는 Lighter 가용성과 관계없이 HIP3를 실행할 수 있습니다.

결정 로직

확신 점수

  • 각 시그널은 확신 점수(0.0 - 1.0)에 기여합니다.
  • 시그널에는 가중치가 부여됩니다 (CVD/FADE/LIQ_PNL/WHALE/DEAD/OFM/HIP3_MAIN).
  • 뇌 신뢰 임계값 이상에서 추천이 생성됩니다.

거부 조건

조건효과
WHALE 반대 방향거래 거부 (VETO)
CVD 반대 방향 및 강한 z-점수거래 거부 (VETO)

위험 및 청산

  • 확신 및 노출에 기반한 동적 위험 크기 조정
  • Decay 기반 청산이 기본 (트리거 시그널 반전)
  • SL/TP 선택적 비상 백스톱 (executor.enable_sltp_backstop)

시그널 유형 및 점수 산정에 대한 자세한 내용은 references/signals.md를 참조하세요.

컨텍스트 학습

학습 엔진은 컨텍스트 조건별 승률을 추적하고 그에 따라 포지션 크기를 조정합니다:

  • 조건별 충분한 데이터(≥10건 거래)가 있으면 학습 엔진이 승률 기반 배수를 제공합니다.
  • 승률 > 45% → 포지션 크기 증가 (최대 1.5배)
  • 승률 < 45% → 포지션 크기 감소 (최소 0.5배)

추적되는 컨텍스트 특징: trend_alignment, vol_regime, funding_alignment, smart_money, signal_strength.

컨텍스트 특징에 대한 자세한 내용은 references/signals.md를 참조하세요.

주문 유형 선택

주문 유형사용 시기
CHASE LIMIT높은 확신(≥0.6), 추세 정렬, 시간 민감
LIMIT ORDER낮은 확신(<0.6), 추세 반대, 인내하며 체결 선호

오류 처리

오류처리
SSE 연결 끊김지수 백오프 재연결 (2초-30초)
속도 제한 (429)토큰 버킷 리필 대기
주문 거부로그 기록 후 중단 (재시도하지 않음)
SL/TP 배치 실패경고 로그 기록, 포지션 유지
포지션 조회 실패캐시된 상태 사용

로깅

로그는 stdout에 다음 형식으로 기록됩니다:

2026-01-25 12:00:00 [executor] INFO: ETH LONG 실행 중

로그 레벨:

  • INFO: 거래 실행, 포지션 변경
  • WARNING: 속도 제한, SL/TP 실패
  • ERROR: 주문 실패, 거래소 오류

메모리 파일

지속적 상태는 memory/ 디렉토리에 저장됩니다:

파일목적
signal_weights.yaml시그널별 신뢰도 승수
trade_journal.yaml거래 기록 (최근 1000건)
circuit_breaker.yaml일일 손실, 연속 손실 상태
positions.yaml활성 포지션
symbol_blacklist.yaml블랙리스트 심볼
context_feature_stats.json컨텍스트 조건별 승률
mistakes.json분류된 트레이딩 실수

파일 형식에 대한 자세한 내용은 references/memory-files.md를 참조하세요.

요구 사항

파이썬 패키지

  • aiohttp>=3.9.0
  • pyyaml>=6.0
  • requests>=2.31.0
  • python-dotenv>=1.0.1
  • hyperliquid-python-sdk>=0.21.0
  • lighter-sdk (선택 사항, Lighter 거래소 활성화 시 requirements-lighter.txt에서 설치)

시스템 종속성

  • Python 3.10+
  • Lighter 환경 변수: LIGHTER_BASE_URL, LIGHTER_ACCOUNT_INDEX, LIGHTER_API_KEY_PRIVATE_KEY, LIGHTER_API_KEY_INDEX
  • Hyperliquid 환경 변수: HYPERLIQUID_ADDRESS (메인 지갑 주소), HYPERLIQUID_AGENT_PRIVATE_KEY (위임된 서명자 키; 메인 지갑 개인 키 아님)
  • 선택적 Hyperliquid: HYPERLIQUID_PRIVATE_NODE, EVCLAW_INCLUDE_WALLET_HIP3_FILLS
  • 거래소 제어: EVCLAW_ENABLED_VENUES
  • Massive 환경 변수 (HIP3 프레데터 시그널): MASSIVE_API_KEY
  • 트래커 API (evplus 트래커를 통해 외부 호스팅):
    • EVCLAW_TRACKER_BASE_URL
    • EVCLAW_TRACKER_HIP3_PREDATOR_URL
    • EVCLAW_TRACKER_HIP3_SYMBOLS_URL
    • EVCLAW_TRACKER_SYMBOL_URL_TEMPLATE
  • EVClaw OSS는 네트워크 전용: 모든 트래커 데이터는 tracker.evplus.ai에서 가져옴
  • SSE 트래커가 tracker.evplus.ai:8443에서 실행 중

하위 스킬

EVClaw는 openclaw_skills/ 디렉토리에 다음 하위 스킬을 포함합니다:

  • trade: 수동 거래 플래너 (/trade <SYMBOL>)
  • execute: 저장된 거래 계획 실행 (/execute <PLAN_ID>)
  • hedge: 포트폴리오 헤징 작업
  • stats: 거래 통계 및 보고서
  • best3: 상위 3개 기회 표시

관련 스킬