Communitygithub.com

Degenapetrader/EVClaw

交易技能,用於在 Lighter(加密貨幣永續合約)和 Hyperliquid(HIP3 股票)上執行即時代幣交易。

EVClaw 是什麼?

這是一個用於 Claude Code、Cursor 或 Codex 等 AI 代理的交易技能,專門在加密貨幣永續合約(Lighter)和 HIP3 股票(Hyperliquid)進行交易。其核心機制是大腦(主要代理,基於 GPT-5.2)與執行器(OpenClaw 代理)的分離:大腦分析市況、評估信號並記錄候選交易方案,而執行器在收到指令後實際下單。技能支援三種模式:即時代幣的完整運作循環(由週期觸發器驅動)、指令碼驅動的單筆交易,以及分析模式(僅產出報告不下單)。決策採用信心評分機制,結合方向性累積成交量(CVD)、清算、鯨魚警報等各類信號的權重,並有否決條件、動態風險管理與衰減出場邏輯來控制風險。交易參數高度可配置,長期透過上下文學習引擎調整部位大小。該技能具備完善的錯誤處理、令牌桶速率限制、原子化部位持久化,並內建事故調查與修復工作流程。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add Degenapetrader/EVClaw

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

EVClaw 交易技能

模式:即時代幣(context → main agent → execute) 交易所: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。

主要特點

  • 即時代幣交易(context → 主要代理 → 執行)
  • 快照驅動的週期處理 + 上下文建構器
  • 按場所執行(不要求某個標的同時存在於兩個交易所)
  • 透過 DynamicRiskManager 實現動態大小調整 + 曝險限制
  • 衰減出場作為主要出場邏輯
  • 可選的止損/止盈緊急備援(設定旗標)
  • 令牌桶速率限制(60 秒內 40 次請求)
  • 原子化部位持久化以利崩潰復原
  • 代理驅動的事故應對(分類 + 修復工作流程)

指令

/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字串必要來自 cycle_trigger.py 的週期 JSON 路徑
--symbol字串必要交易標的(例如 ETH, xyz:NVDA)
--direction字串必要LONG 或 SHORT
--size-usd浮點數必要以 USD 計的部位大小
--dry-run旗標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]

Python 腳本

腳本用途呼叫方式
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動態大小調整 + 衰減出場由 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:止損/止盈、追單設定、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 方向相反否決交易
CVD 方向相反且 z 分數強否決交易

風險與出場

  • 基於信念和曝險的動態風險調整
  • 衰減出場是主要出場方式(觸發信號翻轉)
  • 止損/止盈為可選緊急備援(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。

訂單類型選擇

訂單類型使用時機
追價限價單高信心(≥0.6)、順勢、時效敏感
限價單較低信心(<0.6)、逆勢、偏好被動成交

錯誤處理

錯誤處理方式
SSE 斷線指數退避重連(2 秒 - 30 秒)
速率限制(429)等待令牌桶補充
訂單被拒記錄並中止(不重試)
止損/止盈設置失敗記錄警告,部位保持開倉
部位獲取失敗使用快取狀態

日誌

日誌輸出至標準輸出,格式為:

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

日誌級別:

  • INFO:交易執行、部位變更
  • WARNING:速率限制、止損/止盈失敗
  • 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。

需求

Python 套件

  • 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:顯示前三大機會

相關技能