Communitygithub.com

Degenapetrader/EVClaw

Lighter(暗号資産パープ)とHyperliquid(HIP3株式)でライブエージェント取引を実行するトレーディングスキル。ユーザーが取引、ポジション、シグナル、実行、ライブエージェントモード、サイクルファイル、EVClaw操作について尋ねたときに使用します。

EVClaw とは?

EVClawは、Lighter(暗号資産パーペチュアル)およびHyperliquid(HIP3株式)に対応した、ライブエージェント型のトレーディングスキルです。このスキルは、コンテキストの収集からメインエージェントによる検証、そして実行までの一連のワークフローを自動化し、ユーザーに代わって実際の取引を実行します。主な機能として、スナップショット駆動のサイクル処理、動的リスク管理、減衰ベースのエグジット、トークンバケット方式のレート制限、クラッシュリカバリのためのアトミックなポジション永続化、そしてエージェント主導のインシデント対応が含まれます。ユーザーは`/live-agent`コマンドでサイクルを実行し、`/trade`や`/execute`で手動取引を指示し、`/signals`や`/positions`で現在のシグナルやポジションを確認できます。また、学習エンジンが取引履歴に基づいてシグナル重みやポジションサイズを動的に調整します。設定は`skill.yaml`で管理し、各取引所のシンボルルーティングやリスクパラメータを柔軟に変更可能です。

対応~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による動的なサイジング + エクスポージャー制限
  • 減衰ベースのエグジットを主要なエグジットロジックとして使用
  • オプションのSL/TP緊急バックストップ (設定フラグ)
  • トークンバケット方式のレート制限 (40 req/60s)
  • クラッシュリカバリのためのアトミックなポジション永続化
  • エージェント主導のインシデント対応 (トリアージ + 是正ワークフロー)

コマンド

/live-agent run/execute

メインエージェントワークフロー (コンテキスト → 検証 → 提案記録; OpenClawエージェントがAGIオンリーモードで実行)。

# 最新の保留中サイクルから提案を記録
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]

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: SL/TP、チェイス設定、SR制限設定

完全な設定リファレンスは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)

リスクとエグジット

  • 確信度とエクスポージャーに基づく動的リスクサイジング
  • 減衰ベースのエグジットが主要 (トリガーシグナルのフリップ)
  • オプションの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配置失敗警告をログに記録、ポジションはオープンまま
ポジション取得失敗キャッシュされた状態を使用

ログ

ログは標準出力に以下の形式で書き込まれます:

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

ログレベル:

  • 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を参照してください。

要件

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
  • Venue制御: EVCLAW_ENABLED_VENUES
  • 大規模環境変数 (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の機会を表示

関連スキル