OpenClaw Session Cleanup

Clean up accumulated subagent and cron:run child sessions in OpenClaw to fix slow subagent startup. Use when: subagents are slow to start, sessions.json is t...

Security Scan

The instructions match the described goal (clean sessions.json) but the skill expects you to run a cleanup.ps1 script that is not provided or installed by the skill and includes an explicit destructive option (-CleanJsonl), so there is an unexplained gap and some risk if you run commands blindly.

Purpose & Capability

The name/description (clean OpenClaw sessions.json to speed subagents) is consistent with the actions described (stop gateway, run cleanup script, restart). However the SKILL.md assumes a cleanup.ps1 script exists; the skill bundle contains no code or install step that supplies that script, which is an inconsistency worth noting.

Instruction Scope

The instructions tell the user to stop the gateway, run a PowerShell cleanup script (with a dangerous -CleanJsonl flag that deletes conversation history), and restart the gateway. That behavior is in-scope for session cleanup, but the doc presumes a local .\cleanup.ps1 is present and gives a destructive option. The skill does not provide the script, nor does it include cross-platform variants (only PowerShell examples), so following these instructions without verifying the script could delete user data.

Install Mechanism

No install spec or downloaded code is present, so nothing is written to disk by the skill itself. This minimizes supply-chain risk, but also means the missing cleanup script must come from elsewhere.

Credentials

The skill requests no environment variables, credentials, or config paths. There is no sign of unrelated credential access.

Persistence & Privilege

always:false and normal invocation settings. The skill does not request persistent presence or modification of other skills or system-wide settings.

What to consider before installing

This SKILL.md describes a reasonable maintenance task but does not ship the cleanup.ps1 script it tells you to run. Before using it: (1) locate or obtain the cleanup.ps1 it expects and inspect its contents thoroughly — do not run unknown PowerShell. (2) Back up sessions.json and any .jsonl files; prefer the documented -DryRun first to preview changes. (3) Avoid the -CleanJsonl flag unless you intentionally want to permanently delete conversation history. (4) Confirm your environment (PowerShell available, OpenClaw CLI installed) and, if you're not on Windows, ask for or create an equivalent script for your OS. If the skill author can provide the cleanup script or the SKILL.md is updated to include the script contents or a trusted install step, re-evaluate — that would likely make the skill coherent and lower-risk.

keywords:

• session cleanup
• subagent slow
• sessions.json too large
• child session accumulation
• session compact
• clean sessions
• subagent startup slow
• gateway slow
• session too many
• 清理 session
• subagent 启动慢
• sessions.json 太大

---

Background / 背景

Every subagent call and cron job execution leaves an entry in sessions.json. After a few days of use, hundreds of entries accumulate, causing the gateway to slow down when starting new subagents.

Symptom: Subagent startup goes from a few seconds to 10+ seconds. Root cause: Completed child session entries piling up in sessions.json. Fix: Remove subagent and cron:run child session records, keep main and channel sessions.

每次 subagent 调用和 cron job 执行都会在 sessions.json 中留下记录。积累几百条后，gateway 启动 subagent 时明显变慢。

症状： subagent 启动时间从几秒变成十几秒甚至更长。 根因： sessions.json 中积累了大量已完成的 child session 索引。 解法： 删除 subagent 和 cron:run 类型的 child session 记录，保留主 session 和 channel session。

---

Steps / 操作步骤

Step 1: Stop Gateway

openclaw gateway stop

Step 2: Run cleanup script

.\cleanup.ps1             # 清理 sessions.json 索引（默认保留 .jsonl 文件）
.\cleanup.ps1 -DryRun     # 预览模式，不实际修改
.\cleanup.ps1 -KeepJsonl  # 保留 .jsonl history 文件（明确指定，不删）
.\cleanup.ps1 -CleanJsonl # 危险！同时删除 .jsonl 文件（对话历史会丢失）

Step 3: Restart Gateway

openclaw gateway

---

What is kept / 保留规则

Session type	Example key	Action
Main session	agent:main:main	✅ Keep
WhatsApp	agent:main:whatsapp:direct:+1xxx	✅ Keep
Telegram	agent:main:telegram:direct:xxx	✅ Keep
Signal	agent:main:signal:direct:+1xxx	✅ Keep
Google Chat	agent:main:google chat:direct:xxx	✅ Keep
Line	agent:main:line:direct:xxx	✅ Keep
WeChat	agent:main:wechat:direct:xxx	✅ Keep
iMessage / SMS	agent:main:imessage:direct:xxx	✅ Keep
BlueBubbles (iOS)	agent:main:bluebubbles:direct:xxx	✅ Keep
其他 channel session	agent:main:<channel>:...	✅ Keep
Cron definition	agent:main:cron:uuid	✅ Keep
Cron run record	agent:main:cron:uuid:run:uuid	❌ Delete
Subagent session	agent:main:subagent:uuid	❌ Delete
其他 child session	agent:main:<type>:...	❌ Delete

⚠️ 关于 .jsonl 文件（对话历史）

默认不删除 .jsonl 文件。 .jsonl 包含完整的对话历史，删除后无法恢复。 如需清理 .jsonl，必须加 -CleanJsonl 参数：

.\cleanup.ps1 -CleanJsonl    # 清理 sessions.json 索引 + 删除 .jsonl 文件