CawTrade BNB — 自主 DeFi 交易智能体 v1.1.0

面向生产环境的自主交易智能体，支持 BNB Chain 测试网与主网。内置 3 种智能策略、实时性能分析、链上事件日志及自优化的强化学习能力。

核心功能

🤖 三种自主策略

1. 复利收益（Compound Yield） — 自动再投资已收割奖励，实现指数级增长
2. 再平衡（Rebalance） — 自动将资金从低 APR 金库转移至高 APR 金库
3. 动态收割（Dynamic Harvest） — 基于 Gas 成本优化的智能收割决策

🌐 网络切换

• 测试网 ↔ 主网即时切换（无需重启）
• 各网络独立配置（Gas、阈值、RPC 端点等）
• 按链映射合约地址
• 网络偏好设置持久化保存

📊 实时分析

• 已实现 APR（基于历史收益的实际年化收益率）
• 各金库性能细分
• 策略有效性评分
• 成功率追踪（目标：>90%）
• 失败模式识别

🧠 强化学习

• 自动从过往失败中学习
• 动态优化策略参数
• 依据成功率自动调整阈值
• 为每种策略生成置信度评分
• 随时间持续自我提升

⛓️ 链上事件日志

• 所有操作均记录交易哈希（TX hash）
• 可审计的区块链执行轨迹
• 集成 BNB 测试网浏览器链接
• 完整执行历史记录

🎮 控制面板 CLI

• 交互式命令行界面
• 网络管理命令
• 性能指标仪表盘
• 学习进度追踪
• 实时优化控制

安装与配置

1. 安装技能

clawhub install clawtrade-bnb
cd ~/.openclaw/workspace/skills/clawtrade-bnb
npm install

2. 配置运行环境

# 复制示例配置文件
cp config.deployed.json config.live.json

# 编辑配置文件，填入您的设置
nano config.live.json
# 设置 RPC 端点、合约地址、钱包信息

3. 设置私钥（安全方式）

# 方式 A：环境变量（推荐）
export PRIVATE_KEY="your_testnet_private_key"

# 方式 B：.env 文件（已加入 .gitignore）
echo "PRIVATE_KEY=your_key" >> .env

# 注意：切勿将私钥提交至代码仓库！

4. 验证配置

# 测试节点连接与合约可访问性
node agent-cli.js network status

# 检查钱包余额
npm run verify

快速启动 — 三步上手

# 终端 1：运行策略引擎（60 秒周期循环）
node strategy-scheduler.js

# 终端 2：启动实时仪表盘
npm run dev:dashboard
# → 打开 http://localhost:5173

# 终端 3：进入控制面板
node agent-cli.js

# 示例命令：
node agent-cli.js network testnet        # 切换至测试网
node agent-cli.js perf summary           # 查看整体性能
node agent-cli.js learn now              # 立即优化策略

系统架构

DeFi 策略引擎
├─ 复利收益策略（Compound Yield Strategy）
│  └─ 当待收割奖励 ≥ $25 时 → 收割并再存入
├─ 再平衡策略（Rebalance Strategy）
│  └─ 将 20% 资金从低 APR 金库移至高 APR 金库
└─ 动态收割策略（Dynamic Harvest Strategy）
   └─ 仅当待收割金额 > 2 倍 Gas 成本时执行收割

         ↓（每 60 秒执行一次）

策略调度器（Strategy Scheduler）
├─ 读取各金库 APR 及待收割奖励
├─ 并行执行全部 3 种策略
└─ 记录操作日志 + TX 哈希

         ↓（写入区块链）

链上日志器（On-Chain Logger）
├─ execution-log.jsonl（仅追加模式）
├─ performance-metrics.json（累计指标）
└─ learning-state.json（优化历史）

         ↓（持续分析）

强化学习系统（Reinforced Learning System）
├─ 追踪各策略成功率
├─ 识别失败模式
├─ 自动调整阈值
└─ 生成优化改进报告

         ↓（实时展示）

仪表盘与控制面板（Dashboard + Control Panel）
├─ React 前端仪表盘（http://localhost:5173）
├─ Agent CLI（支持 network / perf / learn 等命令）
└─ 性能 API（/api/logs, /api/health）

配置文件说明

config.deployed.json — 合约地址与 ABI 定义

{
  "chainId": 97,
  "network": "BNB Testnet",
  "contracts": [
    {
      "vaultId": "vault_eth_staking_001",
      "address": "0x588eD88A145144F1E368D624EeFC336577a4276b",
      "strategy": "Ethereum 2.0 Staking",
      "risk_score": 0.3
    }
  ]
}

config.scheduler.json — 策略执行阈值配置

{
  "scheduler": {
    "execution_interval_seconds": 60,
    "enabled": true
  },
  "agent": {
    "harvest_threshold_usd": 25,
    "rebalance_apr_delta": 2.0,
    "max_allocation_percent": 0.35,
    "min_confidence": 0.6
  }
}

策略决策逻辑

每个 60 秒周期内执行：

1. 复利收益（COMPOUND YIELD）

   • 检查各金库待收割奖励
   • 若待收割金额 ≥ $25 → 执行收割并再存入
   • 记录操作及对应 TX 哈希

2. 再平衡（REBALANCE）

   • 比较所有金库 APR
   • 若最高 APR 与最低 APR 差值 ≥ 2% → 触发再平衡
   • 将最差金库中 20% 的资金转移至最优金库
   • 记录操作及对应 TX 哈希

3. 动态收割（DYNAMIC HARVEST）

   • 预估每次收割所需 Gas 成本
   • 仅在待收割金额 > 2 倍 Gas 成本时执行收割
   • 最大化单次操作盈利效率
   • 记录操作及对应 TX 哈希

输出示例：

Cycle #42 @ 2026-02-18T18:00:00Z
✓ vault_eth_staking_001: COMPOUND ($45.50 harvested)
✓ vault_high_risk_001: REBALANCE (2.1% APR delta)
✓ vault_link_oracle_001: HARVEST ($12.30 pending)
✅ Total Rewards: $57.80 | Compounded: $45.50

CLI 命令

网络管理

node agent-cli.js network status      # 查看当前网络配置
node agent-cli.js network testnet     # 切换至测试网
node agent-cli.js network mainnet     # 切换至主网（⚠️ 生产环境）

性能监控

node agent-cli.js perf summary        # 快速概览
node agent-cli.js perf report         # 详细分析报告
node agent-cli.js perf vaults         # 各金库性能分解
node agent-cli.js perf strategies     # 策略有效性评估

强化学习

node agent-cli.js learn now           # 分析并优化策略
node agent-cli.js learn report        # 查看优化成果
node agent-cli.js learn reset         # 重置学习状态

支持的网络

网络切换

无需重启即可即时切换：

# 查看当前配置
node agent-cli.js network status
# → BNB Testnet

# 切换至生产环境
node agent-cli.js network mainnet
# → 自动更新 RPC、合约地址与策略阈值

# 所有配置项自动同步生效

安全与保障

链上审计

• ✅ 每次操作均附带交易哈希（TX hash）
• ✅ 支持通过 BNB 测试网/主网浏览器验证链上行为
• ✅ 日志文件为仅追加模式（execution-log.jsonl）
• ✅ 提供完整可追溯的合规审计路径

风险管理

• ✅ 决策逻辑确定且可复现（可审计）
• ✅ 实时监控成功率（目标 >90%）
• ✅ 各策略设有独立置信度阈值
• ✅ 具备优雅错误处理与恢复机制
• ✅ 通过强化学习自动优化参数

私钥安全

• ✅ 不允许硬编码私钥 — 仅支持环境变量方式
• ✅ .env 文件已加入 .gitignore
• ✅ 开发阶段使用测试网，上线前迁移至主网
• ✅ 生产环境未来将支持硬件钱包集成

文件结构

clawtrade-bnb/
├── defi-strategy-engine.js          # 3 种策略实现（复利、再平衡、收割）
├── on-chain-logger.js                # 链上事件日志（含 TX 哈希）
├── strategy-scheduler.js              # 主循环（60 秒周期）
├── network-switcher.js                # 测试网 ↔ 主网切换逻辑
├── performance-analytics.js           # 实际 APR 与性能指标计算
├── reinforced-learning.js             # 参数自优化逻辑
├── agent-cli.js                       # 控制面板 CLI 入口
├── dashboard/                         # React 前端（实时更新）
├── contracts/                         # 金库智能合约源码
├── config.deployed.json               # 合约地址与 ABI 配置
├── config.scheduler.json              # 策略执行阈值配置
├── execution-log.jsonl                # 操作历史（运行时生成）
├── performance-metrics.json           # 性能指标（运行时生成）
├── learning-state.json                # 学习状态（运行时生成）
├── README.md                          # 用户指南
├── README_STRATEGY.md                 # 策略详解与示例
├── README_ADVANCED.md                 # 网络切换与强化学习进阶说明
├── SKILL.md                           # 本安装与架构说明文档
└── package.json                       # 依赖清单

与其他技能的集成能力

本技能为完全独立、开箱即用的完整模块，同时也支持以下扩展集成：

• Telegram 通知 — 向 OpenClaw 用户推送实时警报
• 邮件报告 — 每日性能摘要自动发送
• 数据库日志 — 将指标持久化存储至外部数据库
• Webhook 集成 — 触发第三方服务或自动化流程

文档说明

您将获得

✅ 面向生产的代码（已充分测试、完整文档、健壮错误处理）
✅ 三种盈利策略（自动调优、自我学习）
✅ 实时仪表盘（React 构建，支持毫秒级刷新）
✅ CLI 控制面板（终端一站式管理）
✅ 链上日志记录（可审计、全透明）
✅ 网络无缝切换（测试网 → 主网仅需数秒）
✅ 自我进化能力（自动从失败中学习并改进）
✅ 完整配套文档（操作指南、策略详解、FAQ）

技能复现指南

他人复现该技能的操作步骤如下：

1. 安装

   clawhub install clawtrade-bnb
   npm install
   

2. 配置

   # 编辑配置文件，填入您的合约地址与 RPC 信息
   nano config.deployed.json
   

3. 部署合约（如使用自定义新金库）

   cd contracts && npm run deploy:testnet
   

4. 运行

   node strategy-scheduler.js      # 主引擎进程
   npm run dev:dashboard           # 仪表盘服务
   node agent-cli.js               # 控制面板
   

5. 监控

   • 仪表盘地址：http://localhost:5173
   • 操作日志：execution-log.jsonl
   • 性能分析：node agent-cli.js perf report

总搭建耗时：约 15 分钟

支持与社区

• GitHub Issues：https://github.com/open-web-academy/clawtrade-bnb-bnb
• ClawHub 技能市场：https://clawhub.com（搜索 clawtrade-bnb）
• Discord 社区：https://discord.com/invite/clawd

版本历史

• v1.1.0（2026-02-18）— 新增网络切换器、性能分析模块、强化学习系统及 CLI 控制台
• v1.0.0（2026-02-17）— 初始发布版，含 3 种策略与链上日志功能

许可证

MIT 许可证 — 免费使用、修改与分发