启用局部重试机制需在config/agent.yaml中同时配置retry_strategy: local和skip_completed_steps: true,并为各step设置唯一id;失败后在Web控制台选择“重试失败节点”,系统将跳过已成功步骤,仅重试失败节点及其直接依赖。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

当 AionClaw 流程中某个 Subagent 或工具调用失败时,整套 ReAct 循环从头重跑,不仅浪费 token 和时间,还会导致已成功执行的步骤(如文件上传、消息通知)被重复触发,引发业务侧异常。你需要的是精准定位失败点、跳过已成功环节、仅重试出错那一步。
启用局部重试机制
打开 AionClaw 项目根目录下的 config/agent.yaml 文件。
找到 execution: 区块,在其下新增两行配置:
retry_strategy: localskip_completed_steps: true
这两项必须同时存在才生效。【local 模式仅重试失败节点及其直接依赖,不会重启主 Agent 的思考链】。若只设 retry_strategy: local 而未开启 skip_completed_steps,系统仍会重新加载全部上下文,造成冗余计算。
标记可跳过步骤
在流程定义文件(如 workflows/data_cleaning.yml)中,对每个 step 添加 id 字段,并确保该 id 全局唯一:
- id: fetch_raw_data tool: http.get input: { url: "https://api.example.com/v1/batch" }
- id: parse_json tool: json.parse input: "{{ fetch_raw_data.output }}"
没有显式 id 的步骤无法被跳过,系统会将其视为匿名操作,强制重跑整条链。这是新手最常漏掉的关键前提。
触发局部重试
第一步:在 AionClaw Web 控制台中,进入「运行历史」→ 找到失败任务 → 点击右侧「…」→ 选择「重试失败节点」。
第二步:系统自动高亮显示失败 step(如 parse_json),并灰显已成功步骤(fetch_raw_data 前面出现 ✔ 图标)。
第三步:点击「确认重试」,AionClaw 会跳过 fetch_raw_data,直接将原始响应体注入 parse_json 的 input 上下文,启动单步重试。
注意:该操作不可逆。如果原始响应体已被后续流程修改(例如被另一个并发任务覆盖),重试结果可能与首次不一致。建议在生产环境开启 step_output_cache: true 配置以固化中间态。

















