QClaw任务断点续传需五步：一、启用持久化（config.yaml设enable_persistence为true并指定persistence_path）；二、运行中用qclaw checkpoint命令保存断点；三、中断后用qclaw restore恢复；四、checkpoint损坏时校验并降级恢复；五、集群环境可通过API远程触发恢复。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果QClaw在执行复杂任务过程中意外中途中断，可能导致任务状态丢失、数据不一致或重复计算。以下是实现任务断点续传与恢复的具体操作步骤：
一、启用任务持久化配置
QClaw默认不自动保存任务中间状态，需手动开启持久化机制，使任务运行时定期将关键上下文写入本地存储，为后续恢复提供依据。
1、打开QClaw主目录下的config.yaml文件。
2、定位到task节点，将enable_persistence字段值设为true。
3、在persistence_path字段中指定绝对路径，例如/var/qclaw/persist，确保该路径存在且QClaw进程具有读写权限。
4、重启QClaw服务以使配置生效。
二、使用checkpoint命令手动保存断点
在任务运行至关键阶段（如完成某批次数据处理、抵达逻辑分界点）时，可主动触发断点快照，生成唯一标识的checkpoint文件，供后续精准恢复。
1、保持任务进程运行，新开终端窗口。
2、执行命令：qclaw checkpoint --task-id <strong><font color="green">TASK_7a2f9d</font></strong>，其中TASK_7a2f9d为当前运行任务的实际ID。
3、等待命令返回Checkpoint saved: chkpt_20240522_143822类似信息，表示断点已成功落盘。
4、记录返回的checkpoint文件名，该名称将用于恢复操作。
三、中断后通过restore指令恢复任务
当QClaw因崩溃、kill信号或系统重启中断后，可通过restore指令加载最近一次有效checkpoint，跳过已执行部分，从断点处继续推进。
1、确认QClaw服务已重新启动且处于就绪状态。
2、执行命令：qclaw restore --checkpoint <strong><font color="green">chkpt_20240522_143822</font></strong>。
3、观察日志输出，确认提示Resuming from step: batch_47等具体恢复位置。
4、任务将自动跳过前46个batch，直接加载第47个batch的输入上下文并继续执行。
四、检查并修复损坏的checkpoint
若restore失败并报错“invalid checkpoint format”或“checksum mismatch”，说明对应checkpoint文件可能被截断或篡改，需验证其完整性并尝试降级恢复。
1、进入persistence_path目录，列出所有checkpoint文件：ls -t chkpt_*。
2、对最新文件执行校验：qclaw checkpoint verify --file <strong><font color="green">chkpt_20240522_143822</font></strong>。
3、若校验失败，尝试使用前一个时间戳的checkpoint文件执行restore。
4、若连续多个checkpoint均损坏，执行qclaw task resume --from-last-known-good，系统将自动回溯至最近可用状态点。
五、通过API接口触发远程恢复
在集群或容器化部署场景下，可通过HTTP API向QClaw实例发起恢复请求，适用于无法直连终端的运维环境。
1、构造POST请求，目标URL为http://localhost:8080/api/v1/task/resume。
2、请求体JSON中包含字段：{"task_id": "<strong><font color="green">TASK_7a2f9d</font></strong>", "checkpoint_name": "<strong><font color="green">chkpt_20240522_143822</font></strong>"}。
3、设置Header：Content-Type: application/json及认证Token（如启用鉴权）。
4、收到HTTP 202响应且body含"status":"resuming"即表示恢复指令已接收并开始执行。
