Communitygithub.com

Degenapetrader/EVClaw

用于在 Lighter(加密货币永续合约)和 Hyperliquid(HIP3 股票)上执行实时代理交易的交易技能。当用户询问交易、持仓、信号、执行交易、实时代理模式、周期文件或管理 EVClaw 操作时使用。

EVClaw 是什么?

EVClaw 是一款实时代理交易技能,支持在 Lighter(加密货币永续合约)和 Hyperliquid(HIP3 股票)两个交易平台上执行自动化和手动交易。其核心架构基于“周期触发 → 周期文件 + 上下文 → 系统事件 → 主代理(GPT-5.2)→ 执行器”的循环流程,通过快照驱动的周期处理、动态风险管理和衰减退出逻辑来实现稳健的交易决策。该技能提供多种命令,包括运行实时代理周期(`/live-agent run/execute`)、执行手动交易(`/trade`、`/execute`)、查看信号(`/signals`)和管理持仓(`/positions`),并支持分析模式(不执行交易)和基于 SSE 的流式数据处理。EVClaw 还内置了上下文学习引擎,通过跟踪不同市场条件下的胜率来动态调整仓位大小,并配备了全面的错误处理和日志记录机制。它需要 Python 3.10+ 环境以及 Lighter、Hyperliquid、Massive API 等外部服务的环境变量配置,适用于希望将 AI 代理集成到加密货币和股票交易策略中的开发者和交易者。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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_URL
    • EVCLAW_TRACKER_HIP3_PREDATOR_URL
    • EVCLAW_TRACKER_HIP3_SYMBOLS_URL
    • EVCLAW_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:显示前三大机会

相关技能