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