核心功能与工作机制
Upbit Trading Engine 是一款专为 OpenClaw Cron 设计的加密货币自动化交易技能，通过 Node.js CLI 直接执行，完全不依赖 OPENCLAW_TOOLS 环境变量。该技能采用经典的双因子策略：
入场策略（买入）
- 日波动率突破模型（k=0.5 系数）
- 60分钟K线趋势确认（看涨信号过滤）
- 激进模式下支持 0.99 近突破比率 + 5分钟动量过滤
出场策略（卖出）
- 默认 ±5% 止盈止损硬约束
- 激进模式启用峰值追踪止盈（Trailing Stop）
架构设计亮点
| 特性 | 实现方式 |
|------|---------|
| 无状态运行 | 每轮 Cron 孤立会话，不累积聊天历史 |
| 并发安全 | `lock_monitor.json` / `lock_worker.json` 重叠保护 |
| 可观测性 | 固定格式 `SUMMARY ...` 单行日志输出 |
| 持久化 | `resources/` 目录下 6 类 JSON 状态文件 |
资源文件体系
events.json：交易信号事件流positions.json：持仓状态topVolumeCache.json：成交量 Top-N 缓存nearCounter.json：近突破连续计数heartbeat.json：监控存活心跳lock_*.json：分布式锁机制
显著优势
1. Cron 原生友好：专为网关调度器设计，支持 --session isolated 模式
2. 策略透明：配置文件驱动（config.json），非黑盒策略
3. 双重执行模式：
4. 风控内置：仓位上限 maxPositions、硬止损、锁机制防重入
monitor_once（5分钟级）：市场扫描与信号生成worker_once（1分钟级）：订单执行与仓位管理
潜在局限与风险
| 风险类别 | 具体表现 | 缓解措施 |
|---------|---------|---------|
| 市场风险 | 加密货币 24/7 波动，策略在极端行情可能失效 | 激进模式可选，默认保守参数 |
| 执行风险 | Cron 调度延迟可能导致信号滑点 | 1分钟 worker 高频轮询 |
| 配置风险 | `config.json` 含 API 密钥，误提交致泄露 | 示例文件分离，明确 `.gitignore` 提示 |
| 流动性风险 | Top-N 缓存依赖成交量，小币种可能失效 | 建议仅交易主流币种 |
| 技术债务 | Node 单进程，无集群故障转移 | 依赖 Cron 级别重试 |
适合人群
- 具备量化交易基础、熟悉韩国 Upbit 交易所规则的用户
- 需要 7×24 自动化执行但不愿托管策略到第三方平台的隐私敏感型交易者
- 已配置 OpenClaw Cron 网关、偏好代码级策略可控性的技术用户
常规风险提示
- ⚠️ 加密货币交易存在本金全部损失可能
- ⚠️ API 密钥需配置 IP 白名单与提现限制
- ⚠️ 建议先在
smoke_test模式验证配置，再启用实盘 - ⚠️ 激进模式（Aggressive Mode）会显著增加交易频次与手续费损耗