OpenClaw Maintenance (Memory + Sessions)

提供两个 Python 脚本：memory_organize.py 按关键词把 OpenClaw 记忆目录根部的散落 .md 文件归入主题子文件夹并补写 frontmatter 与 INDEX.md；session_cleanup.py 清理各代理的墓碑、超期 cron 会话与孤儿文件，并在改动前备份 sessions.json。可设 cron 每日运行。

duolahypercho

热度 46.61

最近更新 2026-05-18 12:32:20

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

安装技能

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

执行命令安装此 skill： npx secure-skills-cli add hypercho-openclaw-maintenance

Metadata

name: openclaw-maintenance
description: Nightly maintenance for OpenClaw — memory organization (sort loose memory files into topic folders with frontmatter and INDEX.md) and session cleanup (purge tombstones, old cron sessions, orphans across all agents). Use when memory files are disorganized, session folders are bloated, disk space is low, or to set up automated daily maintenance. Triggers on "clean sessions", "organize memory", "maintenance", "session bloat", "memory cleanup", "free disk space", "nightly cleanup".

OpenClaw Maintenance

Two scripts that keep your OpenClaw instance lean: memory organization and session cleanup.

1. Memory Organizer

Sorts loose .md files from ~/.openclaw/workspace/memory/ root into topic subfolders.

What it does

Scans memory/*.md for files sitting in the root (not already in a subfolder)
Routes each file to a topic folder based on keyword matching:
- cabinet/ — agent, cron, delegation, cabinet agent names
- content/ — post, blog, marketing, seo, clips
- products/ — copanion, hypercho, feature, ui, roadmap
- technical/ — bug, error, config, docs, gateway
- x/ — twitter, viral, engagement, followers
- user/ — ziwen, founder, personal
- daily/ — fallback for everything else
Adds YAML frontmatter (topic, date, tags) if missing
Updates INDEX.md in each topic folder with the new file
Idempotent — safe to run repeatedly
No LLM dependency — pure keyword matching

Run

python3 <skill_dir>/scripts/memory_organize.py

2. Session Cleanup

Cleans session storage across ALL registered agents.

What it cleans

Target	Retention	Action
Tombstones (`.reset.`, `.deleted.`, `.bak-*`)	0 days	Always delete
Cron session `.jsonl` files	7 days	Delete after 7 days
Orphan `.jsonl` (on disk, not in sessions.json)	0 days	Delete
Stale sessions.json entries (cron, file missing)	0 days	Remove entry
Non-cron sessions	30 days	Keep
Main sessions	Forever	Never touched
Active sessions (`.lock`)	Forever	Never touched

Safety

Auto-discovers agents by scanning ~/.openclaw/agents/*/sessions/
Backs up sessions.json before modifying
Never touches locked/active sessions

Run

# All agents
python3 <skill_dir>/scripts/session_cleanup.py

# Preview only
python3 <skill_dir>/scripts/session_cleanup.py --dry-run

# Single agent
python3 <skill_dir>/scripts/session_cleanup.py --agent main

Cron Setup

Set up a single midnight cron that runs both scripts:

Schedule: 0 0 * * * (midnight local time)
Model: any cheap/fast model
Thinking: low
Timeout: 600s
Delivery: none

Cron task message:

Single task only: run memory organizer and session cleanup.

Command 1 (memory):
bash -lc 'python3 <skill_dir>/scripts/memory_organize.py'

Command 2 (sessions):
bash -lc 'python3 <skill_dir>/scripts/session_cleanup.py'

Return ONLY the combined stdout (no extra commentary).