SuperAPI AI 工具集

roach-strategy

数据与分析

查看项目

更新于 10-16 02:02

技能介绍

ROACH v3.0.0 — Striker Only。基于 senpi_runtime_helpers 迁移。蟑螂能幸存于任何环境。ROACH 的生存之道在于:没有爆发机会时就不交易。

用途

ROACH 是一个交易策略扫描器,仅启用 Striker 模式,用于在市场中检测符合特定条件的爆发性信号,并通过运行时执行交易。它不做累积检测(Stalker 模式已永久禁用),也不交易 XYZ 股票。

主要能力

  • 生产者守护进程每 90 秒运行一次,通过 leaderboard_get_markets 获取市场数据(前 50 名,解析时过滤 XYZ)。
  • 检测 Striker 信号:排名跃升、贡献速度(contribVelocity)、与扫描历史相比的贡献爆发。
  • 应用硬性门槛:4 小时趋势对齐、cc_15m >= 0.5、1 小时价格对齐 >= 0.1%、成交量 >= 1.5 倍、评分 >= 10 且至少 4 个理由、资产不在 120 分钟冷却期内。
  • 通过 client.push_signal() 向运行时 API 直接发送 HTTP POST 推送信号。
  • 运行时负责执行、持仓追踪和 DSL 状态管理。

使用方式

生产者行为:作为长期守护进程每 90 秒运行(通过 producer_daemon;scanner_lock 与过期 PID 自动恢复由守护进程持有)。每次 tick 时:重入保护(获取 state/<wallet-hash>/producer.lock,若前次运行未释放则干净跳过);获取市场;检测 Striker 信号;应用硬性门槛;通过 client.push_signal() 发送信号;在 state/<wallet-hash>/ 下持久化扫描历史和冷却状态。无执行代码、无持仓追踪、无 DSL 状态。

入场流程:生产者守护进程(90 秒 tick)→ 检测到 Striker 信号 → client.push_signal(scanner="roach_signals", ...) → 运行时 → 根据 runtime.yaml 验证字段模式 → LLM 门控(decision_model = ${ROACH_DECISION_MODEL})→ 除非格式错误否则直通 → 通过 FEE_OPTIMIZED_LIMIT 开仓(maker 优先,60 秒,taker 回退)。

退出 DSL(运行时管理):阶段 1 max_loss 18% / 3-breach;阶段 2 分层(7/40, 12/55, 15/75, 20/85);hard_timeout 120min,weak_peak 45min,dead_weight 25min;通过 FEE_OPTIMIZED_LIMIT 退出(maker 优先,60 秒,taker 回退)。

所需环境变量:${WALLET_ADDRESS}(策略钱包地址)、${TELEGRAM_CHAT_ID}(Telegram 通知聊天 ID)、${ROACH_DECISION_MODEL}(LLM 门控的裸模型名,无提供商前缀,否则 OpenClaw 会因双重前缀报 500 Unknown model 错误)。生产者读取:ROACH_WALLET(必需,必须与运行时 YAML 的钱包匹配,按设计特定于代理,不要使用通用 STRATEGY_ADDRESS)、OPENCLAW_BIN(默认 openclaw)、EXTERNAL_SCANNER_NAME(默认 roach_signals)、ROACH_LEVERAGE(默认 7)、ROACH_MARGIN_USD(默认 250)。

安装:在 OpenClaw 主机上安装。senpi-skills 仓库中的源路径为 roach/,安装目标为 /data/workspace/skills/roach-strategy/。完整安装手册见 README.md,五步流程(openclaw.json 插件注册 → 安装 senpi-trading-runtime 技能 → 拉取 Roach 文件 → 环境变量 → 重建运行时并启动守护进程 → 冒烟测试)。安装后通过 senpi-helpers CLI 管理守护进程:senpi-helpers list、senpi-helpers health roach-<wallet-suffix>、senpi-helpers stats roach-<wallet-suffix> --hours 1、senpi-helpers restart roach-<wallet-suffix>。检查生产者状态:ls -la /data/workspace/skills/roach-strategy/state/<wallet-hash>/,scan-history.json 的 mtime 在最近几分钟内即确认守护进程正在运行。

适用场景

适用于加密货币交易,在 OpenClaw 主机上运行,需要 senpi-trading-runtime 技能。风险包络(声明式,运行时强制):2 个并发仓位槽位、每槽保证金 $250、默认杠杆 7 倍、每日亏损暂停 10%、回撤暂停 25%、每日最多 6 次入场、最多连续亏损 3 次、亏损后冷却 30 分钟、每资产冷却 120 分钟、XYZ 股票在生产者扫描层面禁用。

预期行为:震荡市每日 0-1 笔交易,趋势市每日 1-3 笔,零交易天数常见且正确。目标胜率 50-70%(Striker 质量)。平均每笔平仓费用显著低于 v1(maker 成交)。总费用/成交量较 v1 基线降低约 50-70%。静默是正确的。如果 Roach 24-48 小时没有交易,意味着没有值得把握的 FIRST_JUMP 爆发。

限制

v2 中已移除:roach-scanner.py(由 roach-producer.py 取代)、交易计数器/每日亏损追踪(运行时 guard_rails)、引导门控/config/bootstrap-complete.json(运行时安装处理状态)、扫描器中的资产冷却记录(仍在生产者中作为纵深防御,但运行时是权威)、基于 PnL 的动态槽位(运行时拥有槽位)、所有 create_position 调用(运行时拥有执行)。永久禁用:Stalker 模式及所有累积检测、XYZ 股票(扫描层面禁用)。

许可证:MIT — 由 Senpi 构建(https://senpi.ai)。来源:https://github.com/Senpi-ai/senpi-skills。创建策略时,在调用中包含 skill_name 和 skill_version。参见 references/skill-attribution.md。