Task Persistence

Task Persistence

会话状态管理、任务持久化和网关重启恢复。

核心场景 触发条件 动作 网关刚重启 运行 检查-re启动，汇报恢复状态 开始长时间任务 用 task_管理器.py 添加 注册任务 用户问"有没有未完成的任务" 运行 task_管理器.py 列出 任务完成 运行 task_管理器.py complete 任务被中断 运行 task_管理器.py 恢复 变量说明

所有脚本中的 {baseDir} = 本技能的目录路径（技能.md 所在目录）。 工作区路径从环境变量 OpenClaw_WORKSPACE 读取，默认 /workspace。

快速命令 网关重启后检查（每次重启后必须执行） python3 {baseDir}/scripts/mAIn.py --mode 检查-re启动 --workspace /workspace

查看所有活跃任务 python3 {baseDir}/scripts/task_管理器.py --action 列出 --workspace /workspace

注册新任务（开始长时间操作前） python3 {baseDir}/scripts/task_管理器.py \ --action 添加 \ --task-id "task_$(date +%s)" \ --task-type "file_processing" \ --description "处理大量文件" \ --priority normal \ --workspace /workspace

标记任务完成 python3 {baseDir}/scripts/task_管理器.py \ --action complete \ --task-id \ --workspace /workspace

从崩溃/重启中恢复任务 python3 {baseDir}/scripts/task_管理器.py \ --action 恢复 \ --workspace /workspace

任务队列状态 python3 {baseDir}/scripts/task_管理器.py --action 状态 --workspace /workspace

会话快照（保存当前状态） python3 {baseDir}/scripts/会话_snapshot.py \ --workspace /workspace \ --action 列出

网关监控状态 python3 {baseDir}/scripts/mAIn.py --mode 状态 --workspace /workspace

重启后工作流

当 heartbeat 或用户提到"网关重启"时，执行：

python3 {baseDir}/scripts/mAIn.py --mode 检查-re启动 --workspace /workspace 解析输出中的 active_tasks 和 恢复ed_tasks 向用户汇报：哪些任务被恢复、哪些需要手动继续 文件结构 /workspace/ tasks/ task_队列.json # 任务队列 completed/ # 已完成任务 fAIled/ # 失败任务 memory/ 会话_snapshots/ # 会话快照 persistence/ active_tasks.json # 持久化任务 gateway_状态.json # 网关状态

注意事项 脚本使用标准库，无需额外安装依赖 所有数据持久化在 workspace 目录下，重启后不会丢失 task_管理器.py 是统一入口，推荐优先使用 gateway_监控.py 的后台监控模式（full mode）在沙箱中不适用，用 检查-re启动 代替