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 实现动态仓位规模和风险敞口限制
- 基于衰减的退出作为主要退出逻辑
- 可选的止损/止盈紧急备用(配置标志)
- 令牌桶速率限制(40 请求/60 秒)
- 原子化持仓持久化,支持崩溃恢复
- 代理驱动的异常响应(故障排查和修复工作流)
命令
/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 | 字符串 | 必需 | cycle_trigger.py 生成的周期 JSON 文件路径 |
| --symbol | 字符串 | 必需 | 交易对(例如 ETH、xyz:NVDA) |
| --direction | 字符串 | 必需 | LONG 或 SHORT |
| --size-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>]
查看来自 tracker 的当前可操作信号。
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 | 用于 tracker 流的 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:止损/止盈、追单设置、滑点限制配置
详见 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 包
- aiohttpaiohttp>=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 - Tracker API(通过 evplus tracker 外部托管):
EVCLAW_TRACKER_BASE_URLEVCLAW_TRACKER_HIP3_PREDATOR_URLEVCLAW_TRACKER_HIP3_SYMBOLS_URLEVCLAW_TRACKER_SYMBOL_URL_TEMPLATE
- EVClaw OSS 仅联网运行:所有 tracker 数据从
tracker.evplus.ai获取 - SSE tracker 运行在 tracker.evplus.ai:8443
子技能
EVClaw 包含 openclaw_skills/ 目录下的子技能:
- trade:手动交易计划器(
/trade <SYMBOL>) - execute:执行已存储的交易计划(
/execute <PLAN_ID>) - hedge:投资组合对冲操作
- stats:交易统计和报告
- best3:显示前三大机会