OpenClaw Dashboard 太乱？5 分钟清理 24 个会话文件

🎯 问题：Dashboard 显示很多会话

今天晚上打开 OpenClaw Dashboard，发现会话列表特别乱：

✓ feishu:g-agent-main-feishu-direct-ou_3d04bb58e2156dcebb90882425b4027f
  webchat:g-agent-main-main
  heartbeat
  subagent:f035ea77-cdb3-45cb-bc34-54b02b58117d
  subagent:8312e9ad-f8db-4522-a506-e295fad8221d
  subagent:4104ee5b-4a3a-4c28-804e-2d56ddc07306
  ...

问题: 一堆已完成的子 Agent、测试会话、旧备份文件都堆在那里。

🔍 分析：这些会话都是什么？

查看会话文件目录后，发现可以分为几类：

类型	数量	说明
主会话	1 个	当前正在使用的飞书会话 ✅
已完成的子 Agent	2 个	PDF-OCR-解析、创建飞书文档 ⏸️
测试会话	3 个	test.jsonl, test-session.jsonl 等 ❌
旧备份文件	15 个	.reset. 和 .deleted. 文件 ❌
孤立 lock 文件	4 个	.lock 文件 ❌

结论: 只有 1 个主会话是活跃的，其他 24 个文件都可以清理。

🧹 清理过程

步骤 1: 识别可清理的文件

cd /home/ubuntu/.openclaw/agents/main/sessions/

查看当前会话
ls -lh *.jsonl

查看备份文件
ls -lh .reset. .deleted.

步骤 2: 删除已完成的子 Agent

# 删除已完成的子 Agent 会话
rm 4225d474-c72c-447d-82b1-f8901e2eb54d.jsonl  # 创建飞书文档
rm d926ec91-4bd9-4d4b-9a87-ee82274f318d.jsonl  # PDF-OCR-解析

说明: 这些子 Agent 任务已完成，保留只是占用空间。

步骤 3: 清理旧备份文件

# 删除所有 .reset. 和 .deleted. 文件
rm .reset. .deleted.

说明: 这些是会话重置/删除后的备份，可以安全删除。

步骤 4: 删除测试会话

# 删除测试会话
rm test.jsonl test-session.jsonl doc-create-session.jsonl

说明: 测试时创建的临时会话，不需要保留。

步骤 5: 清理孤立 lock 文件

# 删除孤立的 lock 文件
rm *.lock

说明: 会话结束后遗留的锁文件。

📊 清理结果

删除统计

类型	数量	说明
已完成的子 Agent	2 个	PDF-OCR、飞书文档
旧备份文件	15 个	.reset. 和 .deleted.
测试会话	3 个	test.jsonl 等
孤立 lock 文件	4 个	.lock 文件
总计	24 个	释放 ~13MB 空间

保留的会话

2bceef74-e429-4777-853f-9014a441dbdd.jsonl  # 主会话（飞书）
45d6e526-ed80-443a-b44c-812142082572.jsonl  # 其他活跃会话
8966749b-3dc8-4aa8-be0b-3ba573b68860.jsonl  # 其他活跃会话
...

Dashboard 现在显示:

✓ feishu:g-agent-main-feishu-direct-ou_3d04bb58e2156dcebb90882425b4027f
  webchat:g-agent-main-main (心跳任务)
  heartbeat

清爽多了！✅

🤖 关于子 Agent (Subagent)

什么是子 Agent？

子 Agent 是 OpenClaw 用来处理复杂任务的临时会话。

使用场景:

长时间任务（如 PDF OCR 解析）
需要等待的工作（如外部 API 调用）
独立工作流（如创建飞书文档）

子 Agent 的生命周期

创建子 Agent
    ↓
执行任务 (后台运行)
    ↓
完成后返回结果
    ↓
子 Agent 自动清理 (应该)

为什么会有残留？

原因:

任务超时 - 子 Agent 超时但未清理
测试会话 - 测试时创建，忘记删除
备份文件 - 会话重置后保留的备份

解决: 定期手动清理。

查看子 Agent 状态

# 查看活跃的子 Agent
subagents action=list

查看最近的子 Agent
subagents action=list recentMinutes=60

输出示例:

active subagents:
(none)

recent (last 60m):

创建飞书文档 (qwen3.5-plus, 1m29s) done
PDF-OCR-解析 (qwen3.5-plus, 7m53s) done

💡 最佳实践

✅ 推荐

定期清理 - 每月清理一次会话文件
删除测试会话 - 测试完成后立即删除
保留主会话 - 当前使用的会话不要删
清理备份文件 - .reset. 和 .deleted. 可以删

❌ 避免

删除活跃会话 - 会导致对话历史丢失
删除心跳会话 - 心跳任务需要 webchat 会话
删除 lock 文件 - 运行时删除可能导致问题

📋 清理脚本

如果你想自动化清理，可以用这个脚本：

#!/bin/bash cleanup-sessions.sh cd /home/ubuntu/.openclaw/agents/main/sessions/ echo "🗑️ 开始清理..." 删除备份文件 rm -v .reset. .deleted. 删除 lock 文件 rm -v *.lock 删除测试会话 rm -v test*.jsonl doc-create-session.jsonl

echo "✅ 清理完成!"

🎯 总结

清理成果

指标	数值
删除文件	24 个
释放空间	~13MB
Dashboard 会话	3 个 (干净)

关键要点

✅ 定期清理 - 避免会话堆积
✅ 识别类型 - 主会话/子 Agent/测试/备份
✅ 保留必要的 - 主会话和心跳会话
✅ 删除无用的 - 已完成的子 Agent、测试、备份

下一步

⏸️ 设置定期清理 - 每月清理一次
⏸️ 监控子 Agent - 避免堆积
⏸️ 优化配置 - 减少不必要的会话

清理完成时间：2026-04-11 23:35 OpenClaw 版本：2026.4.10

（完）