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-file | string | 필수 | cycle_trigger.py에서 생성된 사이클 JSON 경로 |
| --symbol | string | 필수 | 거래 심볼 (예: ETH, xyz:NVDA) |
| --direction | string | 필수 | LONG 또는 SHORT |
| --size-usd | float | 필수 | USD 기준 포지션 크기 |
| --dry-run | flag | false | 실제 주문 없이 시뮬레이션 |
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_URLEVCLAW_TRACKER_HIP3_PREDATOR_URLEVCLAW_TRACKER_HIP3_SYMBOLS_URLEVCLAW_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개 기회 표시