返回顶部
r

restart-task-recovery任务恢复重启

Preserve and resume in-progress multi-agent work across OpenClaw config patch/apply restarts. Use when a restart is required during active tasks, when users ask to minimize interruption, or when agent runs/tool calls were interrupted by gateway restart/timeouts.

作者: admin | 来源: ClawHub
源自
ClawHub
版本
V 1.0.0
安全检测
已通过
266
下载量
免费
免费
0
收藏
概述
安装方式
版本历史

restart-task-recovery

重启任务恢复

使用此工作流最大化OpenClaw重启后的成功恢复。

1) 重启前检查点(必需)

在任何 gateway.config.patch、gateway.config.apply、gateway.update.run 或 gateway.restart 之前:

  1. 1. 列出可能受影响的活跃会话(sessionslist)。
  2. 对每个活跃工作会话,捕获最新上下文(sessionshistory,限制20-50条)。
  3. 在以下路径写入紧凑的检查点文件:
- memory/restart-checkpoints//.md
  1. 4. 每个会话包含:
- sessionKey / label / agent - 目标 - 最后完成的步骤 - 下一步确切步骤 - 阻塞依赖(如有) - 一条可立即发送的恢复消息(1-2行)

保持检查点简洁且可执行。

2) 带明确恢复意图的重启

调用网关重启/配置变更时,设置 note 包含恢复意图,例如:

  • - “配置已更新并重启;将按检查点恢复中断任务。”

3) 重启后恢复扫描

重启后:

  1. 1. 重新列出会话(sessionslist)并与检查点对比。
  2. 对每个中断/空闲的目标会话,通过 sessionssend 发送恢复消息:
- “从你中断的地方继续。最后完成:。下一步:。如果之前的工具调用失败,从重试。”
  1. 3. 不要在紧密循环中轮询。仅按需检查。
  2. 向用户总结恢复状态:
- 已恢复的会话 - 仍阻塞的会话 - 需要手动跟进

4) 幂等任务设计规则

恢复任务时,强制执行:

  1. 1. 可安全重跑的步骤(幂等键 / upsert / 防重复写入)。
  2. 带有明确“完成标记”的小步骤边界。
  3. 外部写入批量处理,非逐个循环。
  4. 不确定时,先验证状态再继续。

5) V2自动化辅助

使用脚本:scripts/build_checkpoint.py 从结构化JSON生成检查点Markdown。

示例:

bash
cat session-snapshot.json | python3 scripts/build_checkpoint.py memory/restart-checkpoints/$(date +%F)/$(date +%H%M%S).md

预期的stdin JSON格式:

json
{
sessions: [
{
sessionKey: agent:engineer:main,
agentId: engineer,
goal: 完成回归验证,
lastDone: 401/幂等/时区/保留用例通过,
nextStep: 发布最终验收摘要,
blockers: 无
}
]
}

6) V3恢复计划自动化

使用脚本:scripts/generateresumeplan.py 解析最新检查点并生成结构化恢复计划。

示例:

bash
python3 scripts/generateresumeplan.py memory/restart-checkpoints/2026-03-09/162200.md /tmp/resume-plan.json

然后通过 sessions_send 将每个 items[].resumeMessage 发送到 items[].sessionKey。

规则:

  • - 每个会话仅发送一次(无循环轮询)。
  • 如果会话已活跃且正在推进,跳过重新发送。
  • 发送后,向用户发布一条简洁的恢复摘要。

7) V4一键恢复负载生成器

使用脚本:scripts/recoverfromlatest_checkpoint.py。

它自动选择最新的检查点文件,并发出一个可用于 sessions_send 调用的JSON负载列表。

示例:

bash

自动使用最新检查点


python3 scripts/recoverfromlatest_checkpoint.py > /tmp/recover-actions.json

使用特定检查点

python3 scripts/recoverfromlatest_checkpoint.py memory/restart-checkpoints/2026-03-09/162200.md > /tmp/recover-actions.json

执行指导:

  • - 读取 /tmp/recover-actions.json
  • 使用 sessions_send 执行每个 actions[] 项
  • 向用户发布一条简洁摘要

8) V5恢复前验证器 + 手动确认门控

使用脚本:scripts/preresumeverify.py 在发送前对恢复操作进行评分。

示例:

bash
python3 scripts/preresumeverify.py /tmp/recover-actions.json /tmp/recover-verified.json

行为:

  • - 将每个操作标记为 risk=normal|high
  • high 风险操作设置为 decision=hold 和 requiresManualConfirm=true
  • 仅自动发送 decision=send
  • 在执行保留操作前请求用户确认

推荐执行流程:

  1. 1. 使用V4生成操作
  2. 使用V5验证
  3. 发送所有 decision=send
  4. 向用户展示 decision=hold 列表以获取明确确认

9) V6执行计划生成器(自动发送安全项)

使用脚本:scripts/executeverifiedrecovery.py 配合V5输出。

示例:

bash
python3 scripts/executeverifiedrecovery.py /tmp/recover-verified.json > /tmp/recover-exec.json

行为:

  • - 发出 sendActions[] 用于自动安全的恢复(decision=send)
  • 发出 holdForManualConfirm[] 用于有风险的恢复(decision=hold)

执行:

  1. 1. 使用 sessions_send 执行所有 sendActions[]
  2. 请求用户确认 holdForManualConfirm[]
  3. 执行已确认的保留项
  4. 发布简洁摘要

10) 消息模板

读取并使用:references/templates.md

标签

skill ai

通过对话安装

该技能支持在以下平台通过对话安装:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 restart-task-recovery-1776185822 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 restart-task-recovery-1776185822 技能

通过命令行安装

skillhub install restart-task-recovery-1776185822

下载

⬇ 下载 restart-task-recovery v1.0.0(免费)

文件大小: 8.91 KB | 发布时间: 2026-4-15 12:26

v1.0.0 最新 2026-4-15 12:26
Initial public release: V1-V6 restart recovery workflow with checkpointing, resume planning, risk gating, execution plan generation, and smoke test script.

Archiver·手机版·闲社网·闲社论坛·羊毛社区· 多链控股集团有限公司 · 苏ICP备2025199260号-1

Powered by Discuz! X5.0   © 2024-2025 闲社网·线报更新论坛·羊毛分享社区·http://xianshe.com

p2p_official_large
返回顶部