// Orchestrates this Cabinet backtest/live API workflow with robust polling and result parsing. Invoke when user asks OpenClaw to run backtests, track progress, or fetch reports.
| name | openclaw-cabinet-orchestrator |
| description | Orchestrates this Cabinet backtest/live API workflow with robust polling and result parsing. Invoke when user asks OpenClaw to run backtests, track progress, or fetch reports. |
此 Skill 用于让 OpenClaw 稳定调用本项目服务端 API，完成以下任务：
本 Skill 重点解决的问题：
is_running=false 不代表一定有成功报告，需要结合 status/error_msghttp://127.0.0.1:8000Content-Type: application/jsonYYYY-MM-DD/api/status用途：查询当前任务状态与进度。
关键返回字段：
is_running: 当前是否有任务在执行progress.progress: 回测进度（0-100）progress.current_date: 当前处理到的时间点current_report_id: 当前回测任务对应报告 IDcurrent_report_status: running | success | failedcurrent_report_error: 失败原因（若失败）provider_source: 当前数据源示例：
curl -s http://127.0.0.1:8000/api/status
/api/control/start_backtest用途：启动回测任务。
请求体字段：
stock_code (string): 如 301227.SZstrategy_id (string): all 或单策略 ID（如 01）strategy_ids (array[string], optional): 指定多策略（如 ["01","07"]）strategy_mode (string, optional): 如 top5start (string, optional): 开始日期 YYYY-MM-DDend (string, optional): 结束日期 YYYY-MM-DDcapital (number, optional): 初始资金返回字段：
statusmsgreport_id（必须保存并用于后续查询）示例（近一年全策略）：
curl -s -X POST http://127.0.0.1:8000/api/control/start_backtest \
-H "Content-Type: application/json" \
-d '{
"stock_code":"301227.SZ",
"strategy_id":"all",
"start":"2025-03-18",
"end":"2026-03-18"
}'
示例（策略 01+07）：
curl -s -X POST http://127.0.0.1:8000/api/control/start_backtest \
-H "Content-Type: application/json" \
-d '{
"stock_code":"301227.SZ",
"strategy_id":"all",
"strategy_ids":["01","07"],
"start":"2025-03-18",
"end":"2026-03-18",
"capital":1000000
}'
/api/report/latest用途：获取最近一份报告（成功或失败上下文）。
关键字段：
report_idstatuserror_msgsummaryrankingstrategy_reports示例：
curl -s http://127.0.0.1:8000/api/report/latest
/api/report/history用途：查看报告历史与状态。
关键字段：
report_idcreated_atfinished_atstatuserror_msgstock_codeperiodtotal_trades示例：
curl -s http://127.0.0.1:8000/api/report/history
/api/report/{report_id}用途：按启动返回的 report_id 精准获取报告详情。
关键字段：
report_idstatuserror_msgrequestsummaryrankingstrategy_reports示例：
curl -s http://127.0.0.1:8000/api/report/<report_id>
/api/control/stop用途：中止当前任务（重试前清理状态）。
示例：
curl -s -X POST http://127.0.0.1:8000/api/control/stop
/api/control/start_live用途：启动实盘模拟。
curl -s -X POST http://127.0.0.1:8000/api/control/start_live \
-H "Content-Type: application/json" \
-d '{"stock_code":"600036.SH"}'
/api/control/switch_strategy用途：切换策略。
curl -s -X POST http://127.0.0.1:8000/api/control/switch_strategy \
-H "Content-Type: application/json" \
-d '{"strategy_id":"05"}'
当用户说“开始回测并给结果”时，OpenClaw 必须按以下顺序执行：
POST /api/control/start_backtestreport_id（禁止截断、禁止转数字）GET /api/statuscurrent_report_status=failed，直接输出失败原因并结束is_running=true，持续输出进度日志is_running=false，进入报告拉取GET /api/report/{report_id}GET /api/report/history（查是否存在该 id）GET /api/report/latest（仅作为兜底）采用动态超时，不用固定轮询次数：
last_progress_value 与 last_progress_update_timeprogress.progress 增长，刷新 last_progress_update_timecurrent_report_status 变成 failed，立即结束并报告错误建议日志模板：
Backtest running: 42% @ 2025-09-08 14:35:00Backtest failed: <current_report_error>Backtest completed, report_id=<id>report_idstatuserror_msgstockperiodtotal_tradesrankstrategy_idratingannualized_roimax_ddwin_ratecalmarstrategy_idtotal_returnannual_returnmax_drawdowntrade_countwin_rateprofit_ratioPOST /api/control/stopstart_backtestGET /api/report/{report_id} 返回 404 时，不得直接判定服务异常，必须先走 history/latest 兜底流程status=failed，优先输出 error_msg 及 request 参数用于复盘OpenClaw 禁止调用以下路径（本项目无此接口）：
/api//reports/api/report/listOpenClaw 必须遵守：
report_id 代替本次启动返回值report_id 当作数字处理现在开始执行“金策智算”回测流程：
1) POST /api/control/start_backtest 启动任务并获取 report_id
2) 每3秒 GET /api/status，跟踪 progress 和 current_report_status
3) 任务结束后优先 GET /api/report/{report_id}
4) 若404则依次回退 history 与 latest
5) 输出结构化结果（meta + summary + ranking + strategy_reports）
6) 全程打印每一步请求与响应要点
