跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw 會將對話組織成工作階段。每則訊息都會根據來源路由到某個 工作階段，例如私訊、群組聊天、Cron 工作等。

​
訊息如何路由

來源行為
直接訊息預設共用工作階段
群組聊天依群組隔離
聊天室/頻道依聊天室隔離
Cron 工作每次執行使用新的工作階段
Webhook依 hook 隔離

​
DM 隔離

預設情況下，所有 DM 會共用一個工作階段以保持連續性。這對於 單一使用者設定是可以的。
如果有多人可以傳訊息給你的代理，請啟用 DM 隔離。否則，所有 使用者都會共用相同的對話上下文，Alice 的私人訊息會被 Bob 看見。
修正方式： 
{
  session: {
    dmScope: "per-channel-peer", // isolate by channel + sender
  },
}
其他選項：
  • main（預設）— 所有 DM 共用一個工作階段。
  • per-peer — 依寄件者隔離（跨頻道）。
  • per-channel-peer — 依頻道 + 寄件者隔離（建議）。
  • per-account-channel-peer — 依帳號 + 頻道 + 寄件者隔離。
如果同一個人透過多個頻道聯絡你，請使用 session.identityLinks 連結他們的身分，讓他們共用一個工作階段。

​
停靠已連結的頻道

停靠指令可讓使用者將目前直接聊天工作階段的回覆路由移動到 另一個已連結的頻道，而不會啟動新的工作階段。請參閱 頻道停靠 以取得範例、設定與 疑難排解。 使用 openclaw security audit 驗證你的設定。

​
工作階段生命週期

工作階段會重複使用直到過期：
  • 每日重設（預設）— Gateway 主機本地時間上午 4:00 建立新工作階段。每日新鮮度是根據目前 sessionId 開始的時間，而不是 後續中繼資料寫入的時間。
  • 閒置重設（選用）— 在一段時間沒有活動後建立新工作階段。設定 session.reset.idleMinutes。閒置新鮮度是根據最後一次真實的 使用者/頻道互動，因此 Heartbeat、Cron 與 exec 系統事件不會 讓工作階段保持存活。
  • 手動重設 — 在聊天中輸入 /new 或 /reset。/new <model> 也會 切換模型。
同時設定每日與閒置重設時，先過期者生效。 Heartbeat、Cron、exec 與其他系統事件回合可能會寫入工作階段中繼資料， 但這些寫入不會延長每日或閒置重設的新鮮度。當重設 推進到新的工作階段時，舊工作階段佇列中的系統事件通知會被 丟棄，避免過期的背景更新被前置到新工作階段的第一個提示中。 具有作用中 provider 所擁有 CLI 工作階段的工作階段，不會被隱含的 每日預設切斷。若這些工作階段應該依計時器過期，請使用 /reset 或明確設定 session.reset。

​
狀態儲存位置

所有工作階段狀態都由 Gateway 擁有。UI 用戶端會向 Gateway 查詢 工作階段資料。
  • 儲存區： ~/.openclaw/agents/<agentId>/sessions/sessions.json
  • 轉錄檔： ~/.openclaw/agents/<agentId>/sessions/<sessionId>.jsonl
sessions.json 會保留分開的生命週期時間戳記：
  • sessionStartedAt：目前 sessionId 開始的時間；每日重設會使用此值。
  • lastInteractionAt：最後一次會延長閒置生命週期的使用者/頻道互動。
  • updatedAt：最後一次儲存列變更；對列出與修剪很有用，但不是 每日/閒置重設新鮮度的權威依據。
沒有 sessionStartedAt 的舊資料列會在可用時從轉錄 JSONL 工作階段標頭解析。如果舊資料列也缺少 lastInteractionAt， 閒置新鮮度會退回到該工作階段開始時間，而不是後續的簿記 寫入。

​
工作階段維護

OpenClaw 會隨時間自動限制工作階段儲存。預設會以 warn 模式執行（回報將會清理的內容）。將 session.maintenance.mode 設為 "enforce" 即可自動清理： 
{
  session: {
    maintenance: {
      mode: "enforce",
      pruneAfter: "30d",
      maxEntries: 500,
    },
  },
}
對於生產規模的 maxEntries 限制，Gateway 執行階段寫入會使用小型高水位緩衝區，並以批次清理回設定的上限。這可避免在每個隔離的 Cron 工作階段上執行完整儲存區清理。openclaw sessions cleanup --enforce 會立即套用上限。 使用 openclaw sessions cleanup --dry-run 預覽。

​
檢查工作階段

  • openclaw status — 工作階段儲存區路徑與近期活動。
  • openclaw sessions --json — 所有工作階段（使用 --active <minutes> 篩選）。
  • 聊天中的 /status — 上下文用量、模型與切換項。
  • /context list — 系統提示中的內容。

​
延伸閱讀

​
相關