Galleon DeFi 策略回测

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install galleon-defi-strategy-backtest
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 galleon-defi-strategy-backtest。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Galleon DeFi 策略回测使用本地 JSON 数据，将受支持的每日现货规则转化为可审计的实验。它可模拟买入并持有、有资金支持的定期定额投资（DCA）以及简单移动平均线（SMA）敞口规则，并计入投入资金、费用、不利滑点、现金、回撤和基准表现。
此 Openclaw Skills 条目旨在帮助研究人员针对经过验证的历史观测数据测试已冻结的策略，并区分样本内结果与留出数据证据。它不会获取市场数据、执行交易，也不证明某项策略适用或有利可图。

应用场景

将每日买入并持有、有资金支持的 DCA 及受支持的 SMA 规则，与现金流相同的基准进行比较。
检查在基准和较高成本假设下，费用与滑点如何影响策略结果。
在按时间顺序留出的期间验证冻结规则，但不将彼此独立的期间视为一个连续账户。
核对现金、投入资金、模拟成本、期末按市值计价的权益、净利润及未平仓敞口。
使用捆绑的合成示例测试本地运行器，然后再使用兼容的历史数据。
找出不受支持的要求（例如杠杆、资金费率、日内止损或投资组合轮换），并明确所需的数据或引擎功能。

工作原理

定义实验：确定资产身份、数据期间、价格类型、入场和退出规则、现金预算、投入资金、费用及滑点。明确说明各项假设。
准备并验证每日数据：提供本地 JSON，包含资产身份、USD 单位、每日时间戳、来源、获取时间及价格含义。拒绝无效价格、重复或倒序日期、数据缺口以及晚于获取时间的观测值；不得静默填补缺失的蜡烛数据。
提供符合模型契约的可执行策略规范。未知策略字段会导致验证失败，仅有文字描述并不是可执行规则。
运行回测。决策使用某条观测来确定敞口或买入，并在下一条观测时执行；检查交易时机、价格方向、成本、现金流及保留现金。
使用现金流和成本匹配的基准比较结果。除回报指数和回撤外，也要查看资金核对情况，以免将存款误认为利润。
进行验证时，冻结规则并按时间顺序拆分历史数据。验证器会独立重启每个期间，并使用声明的初始现金、零资产单位、全新的指标预热以及该期间的投入资金。
分别检查基准成本和较高成本下的参考期与留出期结果。在报告中保留输入哈希、日期、假设、基准差异及限制。

配置指南

捆绑的离线运行器需要 Node.js 20 或更高版本以及本地 JSON 文件。未捆绑任何数据提供商账户、API 密钥、钱包、签名器、交易引擎或调度程序。请在技能目录中使用合成示例验证安装；该示例用于检查运行器和会计核算，并非实际代币的证据。
node scripts/backtest.mjs --data examples/synthetic-daily.json --spec examples/sma.json
node scripts/validate-strategy.mjs --data examples/synthetic-daily.json --spec examples/sma.json --split 30
使用自己的文件运行：
node scripts/backtest.mjs --data --spec
node scripts/validate-strategy.mjs --data --spec --split
使用 references/model.md 中的模型契约准备策略 JSON，并参考 references/research.md 选择来源及开展研究。运行器只读取提供的本地文件并输出 JSON；它不会下载数据或创建任务。npm CLI 也提供参数相同的 backtest 和 validate-strategy 命令。
Galleon DeFi 策略回测 数据架构与分类体系
此技能使用本地每日数据 JSON 和单独的策略规范 JSON。确切的可执行模型契约请参阅 references/model.md；不受支持或未知的策略字段会被拒绝。
数据要求 预期内容
资产身份 被测试资产的确切身份
单位 以 USD 计价的价格
时间序列 按时间顺序排列的每日时间戳和正价格，不得有重复日期或缺口
来源信息 提供商或来源、获取时间，以及价格代表聚合快照还是交易场所收盘价
策略假设 明确的规则、初始现金、费用、滑点及任何投入资金；DCA 还需提供购买金额和频率
验证拆分 从零开始计数的 --split 索引；默认值为观测数量的一半，向下取整
脚本会输出 JSON 报告，不会保存账户状态或下载数据。请将输入哈希与报告一并保存。报告输出应包含规则、资产和数据身份、日期、起始及投入资本、期末按市值计价的权益、净利润、时间加权回报、最大回撤、模拟费用与滑点、基准差异，以及相关交易或权益曲线。验证报告会将 periods.reference 和 periods.heldOut 分开，并分别提供基准成本、较高成本及成本敏感性结果。

高级特性

留出数据验证会在参考期和留出期运行相同的冻结规则及基准，并在每个期间独立重置现金和指标。
成本压力测试默认将费用和滑点提高至
max(2 × baseline, baseline + 10 bps)
，每项上限为 1000 bps； --stress-fee-bps --stress-slippage-bps 可指定其他数值。至少有一项成本必须增加，且两项均不得降低。
可通过
scripts/engine.mjs
STRATEGY_TEMPLATES
使用固定起始模板：
buy-and-hold
、
weekly-dca
、
sma-10
sma-30
。
createStrategySpec
要求明确指定初始现金、费用和滑点；每周 DCA 还要求提供
amountUsd
。
纯 ESM 引擎也可在浏览器中运行，其导出内容可通过
galleon-defi-strategy-skills/engine
使用。
对于受支持的每日规则，引擎会模拟在下一条观测时执行，并提供现金流、费用、滑点、基准比较、回撤和权益的会计检查。
运行器不会优化参数。模板只是固定的起始点，并非建议；请报告手动尝试的变体，包括亏损结果，且不要将基于完整历史数据的调参描述为样本外验证。
此技能明确限制可作出的结论：每日聚合样本无法支持日内止损成交模型；
ok: true
仅表示运行已完成，并不代表适合交易或未来表现。

name: galleon-defi-strategy-backtest description: Test daily long-only buy-and-hold, funded DCA or moving-average rules with costs, cash flows, drawdown and a benchmark. Use when validating a frozen crypto strategy on a held-out period, comparing cost sensitivity or checking a backtest for timing and accounting errors. license: MIT
compatibility: Portable agent instructions. Bundled offline backtest requires Node.js 20+ and local JSON files. The pure ESM engine also runs in browsers. No provider account, wallet, signer, trading engine or scheduler is bundled.