Session Reset

安全地管理 OpenClaw agent sessions，支持一键重置、自动备份和恢复功能。

Overview

此 skill 提供安全的 session 重置功能，适用于以下场景：

• - 批量清理 agents 的过期会话上下文
• 重置特定 agents 以应用新的 SOUL.md 配置
• 定期维护，释放磁盘空间
• 从备份恢复误删的 sessions

快速开始

首次使用（初始化）

bash

运行初始化，交互式选择默认 agents

openclaw session-reset --init

初始化流程：

1. 1. 自动发现所有 agents
2. 选择导入方式：[1]全部导入 / [2]多选 / [3]取消
3. 保存配置到 ~/.openclaw/session-reset-config.json

日常使用

bash

预览将要重置的内容

openclaw session-reset --scope default --dry-run

确认无误后执行重置

openclaw session-reset --scope default

重置配置的默认 agents

openclaw session-reset --scope agents

工作流程

首次使用:
reset-session --init
→ 发现 agents
→ 选择导入方式
→ 保存配置

日常使用:
1. 选择 scope → 确定重置范围 (default/all/agents/cron/subagent/agent1,agent2)
2. 预览/确认 → 使用 --dry-run 预览，或直接执行
3. 自动备份 → 创建带时间戳的备份到 ~/.openclaw/session-backups/
4. 执行重置 → 删除 session JSONL 文件
5. 自动重建 → 下次消息触发时 OpenClaw 自动创建新 session

命令参考

初始化命令

bash

首次使用 - 初始化配置

openclaw session-reset --init

基本命令

bash

重置所有 Discord 频道 sessions（默认，不含 Cron/Subagent）

openclaw session-reset --scope default

预览模式（不执行实际重置）

openclaw session-reset --scope default --dry-run

重置配置的默认 agents（需先初始化）

openclaw session-reset --scope agents

重置指定 agents

openclaw session-reset --scope main,hubu,libu

重置所有 sessions（含 Cron + Subagent）

openclaw session-reset --scope all

仅重置 Cron 任务

openclaw session-reset --scope cron

仅重置 Subagent

openclaw session-reset --scope subagent

备份管理

bash

查看所有备份

openclaw session-reset --list-backups

从指定备份恢复

openclaw session-reset --restore 20250305_143022

清理旧备份（默认：30天前，最多保留10个）

openclaw session-reset --cleanup

自定义清理策略

openclaw session-reset --cleanup --cleanup-days 7 --cleanup-max 5

高级选项

bash

强制执行，跳过确认提示

openclaw session-reset --scope default --force

Scope 参数详解

Scope 值	说明	适用场景	是否需要初始化
default	所有 Discord 频道 sessions	日常清理，最常用的选项	否
all

全部 sessions | 彻底重置，包含所有类型 | 否 | | agents | 配置的默认 agents | 批量重置常用 agents | ✅ 需要 --init | | cron | 仅 Cron 任务 sessions | 重置定时任务状态 | 否 | | subagent | 仅 Subagent sessions | 清理子代理会话 | 否 | | agent1,agent2 | 指定 agents（逗号分隔） | 精确控制重置范围 | 否 |

注意: --scope agents 需要事先运行 --init 配置默认 agents。

安全机制

1. 1. 强制备份

- 任何重置操作前自动创建备份 - 备份位置：~/.openclaw/session-backups/YYYYMMDD_HHMMSS/ - 包含完整的 session JSONL 文件和清单

1. 2. 二次确认

- 显示统计信息（agents数量、文件数、预估大小） - 需输入 yes 确认后执行

1. 3. 预览模式

- --dry-run 仅显示将要重置的内容 - 不产生任何实际影响

1. 4. 可恢复性

- 支持 --restore 恢复到任意备份 - 备份永久保留，直到手动清理

备份策略

• - 默认保留: 30 天内 + 最多 10 个备份
• 清理命令: openclaw session-reset --cleanup
• 自定义: --cleanup-days N --cleanup-max M

注意事项

• - 重置后 agents 会丢失当前会话上下文
• 下次收到消息时会自动创建新的 session
• 建议在低峰期执行批量重置
• 重要操作前使用 --dry-run 预览
• 无法重置当前正在运行的 session（需从外部终端执行）

使用示例

示例 1：首次使用（初始化）

bash

运行初始化，选择默认 agents

openclaw session-reset --init

输出示例：

✓ 发现 7 个 agents:

1. main (5 sessions)

2. hubu (3 sessions)

...

# 选择导入方式:

1. 导入全部 agents

2. 多选 agents

3. 取消初始化

示例 2：日常维护

bash

预览将要清理的内容

openclaw session-reset --scope default --dry-run

确认无误后执行

openclaw session-reset --scope default

示例 3：批量重置配置的 agents

bash

重置初始化时配置的默认 agents

openclaw session-reset --scope agents --dry-run openclaw session-reset --scope agents

示例 4：恢复备份

bash

查看可用备份

openclaw session-reset --list-backups

恢复到指定时间点

openclaw session-reset --restore 20250305_143022

Resources

scripts/

• - reset-session.py - 核心脚本，实现 session 重置、备份、恢复功能