Session Cleanup

面向 OpenClaw 的轻量会话清理技能：cleanup.sh 按保留天数清理会话备份、检查点、轨迹与锁文件，先移入 .trash 以便恢复并记录日志，支持 --dry-run 预演与 --report 磁盘占用报告，附 cron 定时清理示例。

woai36d

热度 49.90

最近更新 2026-07-12 06:03:08

分类：自动化依赖：代码执行 / 读写文件应用场景：自动化脚本 / 工作流 / DevOps

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add woai36d/session-cleanup

Metadata

name: session-cleanup
description: Lightweight session cleanup tool for OpenClaw. Removes old session backups, checkpoints, and trajectory files to prevent disk bloat.
metadata: {"openclaw":{"emoji":"🧹","requires":{"bins":["jq"]},"install":[{"id":"brew-jq","kind":"brew","formula":"jq","bins":["jq"],"label":"Install jq (brew)"}]}}

session-cleanup

Clean up OpenClaw session artifacts to prevent disk bloat.

What It Cleans

Pattern	Description	Default Retention
`.jsonl.reset.*`	Session backups from `/new` or `/reset`	7 days
`.checkpoint.*.jsonl`	Auto-save checkpoints	7 days
`.trajectory.jsonl`	Trajectory/thinking logs	3 days
`.trajectory-path.json`	Trajectory index files	3 days
`.jsonl.lock`	Stale lock files	1 day

Usage

# Dry run - see what would be deleted
~/.openclaw/workspace/skills/session-cleanup/cleanup.sh --dry-run

# Clean with defaults (7d for backups, 3d for trajectories)
~/.openclaw/workspace/skills/session-cleanup/cleanup.sh

# Aggressive clean - keep only last 3 days of everything
~/.openclaw/workspace/skills/session-cleanup/cleanup.sh --backup-days 3 --trajectory-days 1

# Report only - show disk usage by session
~/.openclaw/workspace/skills/session-cleanup/cleanup.sh --report

Cron Setup

Add to your crontab for weekly cleanup:

# Weekly session cleanup, Sunday 3:06 AM
6 3 * * 0 ~/.openclaw/workspace/skills/session-cleanup/cleanup.sh >> ~/.openclaw/logs/session-cleanup.log 2>&1

Or use OpenClaw cron:

openclaw cron add --name "session-cleanup" --schedule "0 3 * * 0" --command "~/.openclaw/workspace/skills/session-cleanup/cleanup.sh"

Safety

Never deletes active sessions (checks .jsonl.lock and recent modification time)
Moves to .trash/ first instead of permanent deletion (recoverable for 30 days)
Logs all actions to ~/.openclaw/logs/session-cleanup.log