qclaw需启用阶段化编排、中间产物落盘与webhook追踪三机制以稳定执行多步依赖任务：1. 添加stage标记并开启“阶段化任务编排”；2. 配置json模板自动保存带校验的中间结果；3. 部署本地webhook实时监听阶段状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让QClaw稳定执行“抓取招标公告→提取条款→比对合同模板→生成风险提示文档”这类含依赖、跨工具、需状态延续的多步骤任务，必须绕过默认线性执行模式，主动干预其规划路径与中间产物管理方式。
启用阶段化任务编排并锚定关键节点
QClaw默认按语义流顺序推进，但四步链中第3步依赖第2步输出、第4步依赖第3步结论，若不显式声明阶段边界，模型可能在第二步未完成时就启动比对，导致空输入报错或生成无效内容。
1、在微信对话框发送完整指令时，在末尾添加结构化标记：【[STAGE:1]获取原始数据;[STAGE:2]解析文本;[STAGE:3]比对模板;[STAGE:4]生成报告】
2、进入QClaw主界面→右上角齿轮图标→“高级执行设置”→勾选“启用阶段化任务编排”与“强制状态校验”。
这一步必须开启，否则系统不会为每个子任务分配唯一stage_id，后续断点续传和状态监听全部失效。
配置中间产物自动落盘与版本控制
方法一：使用JSON模板绑定路径与校验机制
1、打开“模板管理”→新建JSON格式持久化配置，内容如下：
{"stage_id":"2","output_type":"text","save_path":"%USERPROFILE%\QClawCache\stage2_parsed.txt","auto_version":true}
2、将该模板关联至当前任务。QClaw执行到第二阶段时，会把提取出的条款文本写入指定路径，并自动附加时间戳与SHA256哈希值。
方法二：手动指定通用缓存目录（仅适用于调试）
在指令中直接声明：“所有中间结果保存到C:QClawTempid_task_20260610”，QClaw会跳过模板匹配流程，直写该路径，但不生成校验值，不可用于生产环境断点恢复。
部署本地Webhook实现阶段状态实时追踪
第一步：启动Python简易服务监听端点
在终端运行 python -m http.server 8000，确保根目录下存在 webhook_handler.py 文件，且能接收 POST 到 /qclaw/status 的 JSON 数据。
第二步：在QClaw设置页→“通知与集成”→填写 Webhook URL 为 http://127.0.0.1:8000/qclaw/status →触发事件选择“阶段状态变更”。
第三步：每次 stage_id 状态切换时，QClaw推送包含 task_id、stage_id、timestamp、status 和 duration_ms 的结构化数据，本地服务可据此更新SQLite数据库中的进度条。
注意：若本地服务未运行或端口被占用，QClaw会在后台重试3次后静默丢弃该状态包，不会中断任务执行。
规避长任务目标漂移的三道防线
防线一：在每阶段指令开头重复嵌入原始目标关键词
例如第三阶段指令写成：“【目标：生成招标风险提示文档】基于stage2_parsed.txt中的条款，对照《标准采购合同V3.2》逐条比对……”
防线二：关闭全局记忆注入，仅允许当前任务ID的共享记忆区读写
进入设置→记忆管理→取消勾选“启用跨任务上下文继承”，防止历史任务噪声污染当前DAG执行流。
防线三：对高风险操作强制插入人工确认节点
在[STAGE:4]前添加显式指令：“生成报告前，请截图展示比对差异项并等待我回复‘确认生成’”，QClaw将暂停执行并推送待办消息至微信。
