問題的起源

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

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

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

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

先搞清楚：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 — 輕量的"索引文件"，記錄每個(gè) session 的元數(shù)據(jù)（創(chuàng)建時(shí)間、最后更新時(shí)間、對(duì)應(yīng)的文件路徑等）
• transcript 文件 — 實(shí)際存儲(chǔ)完整對(duì)話歷史的 JSON 文件，每條消息、每次 tool call、每個(gè) token 都在這里

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

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

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

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

解決方案：自動(dòng)化清理腳本

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

#!/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 小時(shí)閾值

核心邏輯（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));

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

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

除了 Feishu session，我還對(duì) 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 是日常對(duì)話的主 session，積累最快
• 每天重置一次，保持上下文干凈，推理速度穩(wěn)定
• 重要信息通過 MEMORY.md 持久化，不依賴對(duì)話歷史

重啟 Gateway

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

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

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

自動(dòng)化：配置 Cron Job

把這個(gè)腳本配成每天定時(shí)跑，完全不用人工介入：

{
  "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" }
}

幾個(gè)設(shè)計(jì)要點(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 匯報(bào) + 推送通知，必須用 isolated + agentTurn，混用會(huì)超時(shí)或無推送。

效果對(duì)比

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

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

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

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

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

正確的做法是：

• 定期蒸餾——把對(duì)話中有價(jià)值的信息提煉寫入長(zhǎng)期記憶
• 定期清理——工作記憶不需要無限堆積
• 分層存儲(chǔ)——工作 session、日志、知識(shí)庫各司其職

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

總結(jié)

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

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

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

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

最新評(píng)論