OpenClaw中Session自动清理需同步删除sessions.json索引和对应transcript文件，否则产生孤儿文件；推荐使用内置CLI或自动化脚本，按24小时阈值定期清理，避免存储耗尽和API额度浪费。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw中Cron Job持续运行会不断生成新Session，而旧Session若未及时清理，会迅速耗尽免费额度对应的存储配额和API调用次数。
确认过期Session的实际存在
先检查sessions.json是否已膨胀：cat /home/water/.openclaw/agents/main/sessions/sessions.json | jq 'length'。若返回值远超日常活跃数（如 > 50），说明存在大量滞留Session。
不要只看文件大小——【sessions.json只是索引，真正占空间的是transcript-*.json文件】。执行find /home/water/.openclaw/agents/main/sessions -name "transcript-*.json" | wc -l对比索引数量，差值越大，孤儿文件越多。
手动清理单个过期Session（验证流程）
方法一：直接删索引+删文件
从sessions.json中找出一个创建时间早于24小时的session key，例如agent:main:feishu-abc123；用jq提取其sessionFile路径：jq -r '.["agent:main:feishu-abc123"].sessionFile' sessions.json。
确认该路径文件存在后，执行rm命令删除它；再用sed或jq从sessions.json中删掉对应key行——【必须两步都做，否则下次启动仍会加载残留索引】。
方法二：用内置CLI（如果OpenClaw版本≥0.8.3）
openclaw session delete --id agent:main:feishu-abc123 --force。该命令自动同步清理索引与transcript文件，无需手动定位路径。
自动化清理脚本部署
第一步：创建清理脚本 /usr/local/bin/clean-openclaw-sessions.sh
第二步：写入以下内容（注意替换SESSIONS_FILE路径为你的实际路径）：
#!/bin/bash
set -e
SESSIONS_FILE="/home/water/.openclaw/agents/main/sessions/sessions.json"
THRESHOLD_MS=$((24 * 60 * 60 * 1000))
node -e "
const fs = require('fs');
const sessions = JSON.parse(fs.readFileSync(process.argv[1]));
const now = Date.now();
const toDelete = Object.entries(sessions).filter(([_, v]) => (now - new Date(v.createdAt).getTime()) > process.argv[2]);
toDelete.forEach(([key, v]) => { fs.unlinkSync(v.sessionFile); delete sessions[key]; });
fs.writeFileSync(process.argv[1], JSON.stringify(sessions, null, 2));
console.log(\`Deleted \${toDelete.length} sessions\`);
" "$SESSIONS_FILE" "$THRESHOLD_MS"
第三步：赋予执行权限：sudo chmod +x /usr/local/bin/clean-openclaw-sessions.sh
第四步：添加到系统级crontab，每天凌晨3:17执行：sudo crontab -e → 添加这一行：17 3 * * * /usr/local/bin/clean-openclaw-sessions.sh >/dev/null 2>&1
在K8s环境用CronJob替代宿主机crontab
第一步：准备Docker镜像，确保包含openclaw CLI和Node.js运行时。
第二步：编写cronjob.yaml，关键字段如下：
spec:
schedule: "0 */6 * * *" # 每6小时一次，避免高频触发
jobTemplate:
spec:
template:
spec:
containers:
- name: cleaner
image: your-registry/openclaw-cleaner:v1.2
command: ["/bin/sh", "-c"]
args:
- "openclaw session cleanup --older-than 24h --dry-run=false"
restartPolicy: OnFailure
第三步：应用配置：kubectl apply -f cronjob.yaml
这一步必须确保Pod能访问OpenClaw的sessions目录——通过hostPath或PersistentVolume挂载，路径需与容器内openclaw配置一致。
