| name | task-persistence |
| description | 自动监控和恢复会话状态、任务持久化和网关重启反馈。支持任务延续、状态快照和主动通知。 |
| metadata | {"openclaw":{"emoji":"🔄"}} |
Task Persistence - 会话与任务持久化
功能概述
Task Persistence 技能提供完整的会话状态管理和任务恢复能力:
🔄 任务持久化 (Task Persistence)
- 自动保存:长时间运行的任务自动保存状态到磁盘
- 智能恢复:网关重启后自动检测并恢复未完成任务
- 任务队列:支持多任务排队、暂停、恢复和取消
- 进度跟踪:实时显示任务进度和预计完成时间
💾 会话快照 (Session Snapshot)
- 定期快照:自动保存会话上下文和对话历史
- 状态恢复:重启后从最近快照恢复对话状态
- 上下文压缩:智能压缩历史记录,保持关键信息
- 记忆集成:与 memory-core 插件协同工作
🔔 网关监控 (Gateway Monitor)
- 状态检测:实时监控网关运行状态
- 主动通知:重启完成后自动发送状态报告
- 健康检查:定期执行系统健康检查
- 异常告警:检测到问题时及时通知用户
使用场景
- 长时间任务:文件处理、数据导入、批量操作等
- 系统维护:网关更新、配置更改后的状态恢复
- 意外中断:系统崩溃、网络断开后的任务恢复
- 日常监控:持续监控系统状态和性能
命令和工具
任务管理
uv run {baseDir}/scripts/task_manager.py --action list
uv run {baseDir}/scripts/task_manager.py --action resume --task-id <id>
uv run {baseDir}/scripts/task_manager.py --action pause --task-id <id>
uv run {baseDir}/scripts/task_manager.py --action cancel --task-id <id>
会话快照
uv run {baseDir}/scripts/session_snapshot.py --action save --label "before-update"
uv run {baseDir}/scripts/session_snapshot.py --action restore --label "latest"
uv run {baseDir}/scripts/session_snapshot.py --action list
网关监控
uv run {baseDir}/scripts/gateway_monitor.py --action status
uv run {baseDir}/scripts/gateway_monitor.py --action health-check
uv run {baseDir}/scripts/gateway_monitor.py --action notify-restart
综合操作
uv run {baseDir}/scripts/main.py --mode full
uv run {baseDir}/scripts/main.py --mode tasks-only
uv run {baseDir}/scripts/main.py --mode snapshot-only
配置
配置文件位置:{workspace}/config/task-persistence.json
默认配置:
{
"task_persistence": {
"enabled": true,
"auto_save_interval": 30,
"max_concurrent_tasks": 5,
"task_dir": "{workspace}/tasks"
},
"session_snapshot": {
"enabled": true,
"snapshot_interval": 60,
"max_snapshots": 10,
"snapshot_dir": "{workspace}/snapshots"
},
"gateway_monitor": {
"enabled": true,
"check_interval": 10,
"notify_on_restart":
依赖
- Python 3.8+
- uv (推荐) 或 pip
- psutil (系统监控)
- OpenClaw memory-core 插件
最佳实践
- 定期清理:自动清理过期的任务和快照文件
- 资源监控:监控系统资源使用,避免过度消耗
- 错误处理:完善的错误处理和重试机制
- 用户控制:提供简单的命令来控制各项功能的开关
集成
此技能与以下技能协同工作:
- session-monitor:提供详细的 token 和状态信息
- memory-core:利用向量搜索进行智能状态恢复
- healthcheck:执行系统安全和性能检查
- cron:支持定时任务和定期快照