問題的起源

某天下午，我發(fā)現(xiàn)我的 AI 助手越來越"遲鈍"——一個簡單的問題，從發(fā)送到回復(fù)，等了將近 86 秒。

翻了翻日志，找到了罪魁禍?zhǔn)祝?strong>上下文長度 122k tokens。

這是因?yàn)?AI Agent 的每一次對話都會被記錄到 session transcript 文件中。隨著時間累積，這個文件越來越大，每次推理都要把整個歷史塞進(jìn)模型的上下文窗口，推理時間自然指數(shù)級增長。

這就是 長上下文問題（Long Context Problem），是 AI Agent 生產(chǎn)運(yùn)營中最容易被忽視的性能瓶頸之一。

先搞清楚：Session 和 Transcript 是什么關(guān)系

在 OpenClaw 這類 AI Agent 框架里，session 管理通常分兩層：

sessions.json (索引層)
├── agent:main:feishu-xxx  →  sessionFile: /path/to/transcript-abc.json
├── agent:main:feishu-yyy  →  sessionFile: /path/to/transcript-def.json
└── agent:main:main        →  sessionFile: /path/to/transcript-main.json

• sessions.json — 輕量的"索引文件"，記錄每個 session 的元數(shù)據(jù)（創(chuàng)建時間、最后更新時間、對應(yīng)的文件路徑等）
• transcript 文件 — 實(shí)際存儲完整對話歷史的 JSON 文件，每條消息、每次 tool call、每個 token 都在這里

關(guān)鍵點(diǎn)：這兩個東西是獨(dú)立存在的。

如果你只刪了 sessions.json 里的 key（索引），而沒有刪對應(yīng)的 transcript 文件（數(shù)據(jù)），會發(fā)生什么？

• 下次啟動時，框架找不到這個 session 的索引，會重新創(chuàng)建
• 但舊的 transcript 文件還靜靜躺在磁盤上，永遠(yuǎn)不會被清理
• 隨著時間推移，磁盤上堆滿了孤兒文件，慢慢侵蝕存儲空間

這就是為什么清理要同時處理 key 和 file，缺一不可。

解決方案：自動化清理腳本

我寫了一個 Bash + Node.js 混合腳本來處理這個問題：

#!/usr/bin/env bash
# 清理 Feishu session + Main session 腳本
set -e
SESSIONS_FILE="/home/water/.openclaw/agents/main/sessions/sessions.json"
THRESHOLD_MS=$((24 * 60 * 60 * 1000))  # 24 小時閾值

核心邏輯（Node.js 內(nèi)嵌）

const data = JSON.parse(fs.readFileSync(SESSIONS_FILE, 'utf8'));
const now = Date.now();
Object.keys(data).forEach(k => {
  if (!k.includes('feishu')) return;  // 只處理 feishu sessions
  if (k.includes('cron')) return;      // 跳過 cron sessions
  const session = data[k];
  const updatedAt = session.updatedAt || session.createdAt || 0;
  const age = now - updatedAt;
  if (age > threshold) {
    // ① 先刪文件
    const sessionFile = session.sessionFile;
    if (sessionFile && fs.existsSync(sessionFile)) {
      fs.unlinkSync(sessionFile);
    }
    // ② 再刪索引
    delete data[k];
    deleted++;
  }
});
// 寫回索引文件
fs.writeFileSync(SESSIONS_FILE, JSON.stringify(data, null, 2));

注意操作順序：先刪文件，再刪索引。 反過來的話，如果刪完索引時進(jìn)程崩潰，文件就變成永久孤兒了。

特殊處理：Main Session 每日強(qiáng)制重置

除了 Feishu session，我還對 main session 做了無條件的每日清理：

const mainKey = 'agent:main:main';
if (data[mainKey]) {
  const sessionFile = data[mainKey].sessionFile;
  if (sessionFile && fs.existsSync(sessionFile)) {
    fs.unlinkSync(sessionFile);
  }
  delete data[mainKey];
}

這里不判斷年齡，直接刪。理由是：

• Main session 是日常對話的主 session，積累最快
• 每天重置一次，保持上下文干凈，推理速度穩(wěn)定
• 重要信息通過 MEMORY.md 持久化，不依賴對話歷史

重啟 Gateway

清理完 sessions.json 后，需要重啟 Gateway 讓變更生效：

pkill -f openclaw-gateway || true
sleep 2
nohup openclaw-gateway >> "$LOG_FILE" 2>&1 &
sleep 3

這里用 || true 避免 pkill 找不到進(jìn)程時退出碼非零觸發(fā) set -e。

自動化：配置 Cron Job

把這個腳本配成每天定時跑，完全不用人工介入：

{
  "name": "Daily Feishu Session Cleanup",
  "schedule": { "kind": "cron", "expr": "0 14 * * *", "tz": "Asia/Shanghai" },
  "sessionTarget": "isolated",
  "payload": {
    "kind": "agentTurn",
    "message": "Run the Feishu session cleanup script and report results",
    "timeoutSeconds": 120
  },
  "delivery": { "mode": "announce", "channel": "feishu" }
}

幾個設(shè)計要點(diǎn)：

• sessionTarget: isolated — 在隔離 session 里跑，不污染主 session
• kind: agentTurn — 讓 Agent 執(zhí)行腳本并匯總結(jié)果，通過 Feishu 推送
• 每天 14:00 — 下午低峰期執(zhí)行，避免影響正常使用

坑點(diǎn)：sessionTarget: main 只支持 payload.kind = systemEvent（直接執(zhí)行，無 LLM）。需要 LLM 匯報 + 推送通知，必須用 isolated + agentTurn，混用會超時或無推送。

效果對比

響應(yīng)時間從最差 86 秒降回 3-8 秒，體感差別非常明顯。

延伸思考：AI Agent 的"記憶管理"

這個問題本質(zhì)上是 AI Agent 的**工作記憶（Working Memory）vs 長期記憶（Long-term Memory）**的分離問題。

• 對話 session / transcript = 工作記憶，應(yīng)該短暫且聚焦
• MEMORY.md / 知識庫 = 長期記憶，存真正重要的決策和知識

很多人在部署 AI Agent 時，會默認(rèn)讓它"記住一切"，結(jié)果把工作記憶當(dāng)成了永久存儲，導(dǎo)致上下文爆炸。

正確的做法是：

• 定期蒸餾——把對話中有價值的信息提煉寫入長期記憶
• 定期清理——工作記憶不需要無限堆積
• 分層存儲——工作 session、日志、知識庫各司其職

這和人類的記憶機(jī)制其實(shí)很像——你不會把每天說過的每句話都記著，但重要的決定、學(xué)到的知識會留下來。

總結(jié)

一個簡單的 cron 清理腳本，解決了 AI Agent 最常見的性能退化問題。關(guān)鍵點(diǎn)：

• 同時刪 key 和 file，避免磁盤泄漏
• 先刪文件再刪索引，保證原子性
• Main session 每日強(qiáng)制重置，保持上下文干凈
• 自動化 + 通知，完全無人值守

如果你也在跑 AI Agent，不妨檢查一下你的 session 文件有多大——也許已經(jīng)悄悄堆了幾十 MB 的歷史對話了 

到此這篇關(guān)于OpenClaw中Session自動清理實(shí)踐指南的文章就介紹到這了,更多相關(guān)OpenClaw自動清理Session內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論