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-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]
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_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の機会を表示