工作階段管理

OpenClaw 會根據每則傳入訊息的來源，將其路由至一個工作階段：私訊、群組聊天、排程工作等。所有工作階段狀態都由閘道擁有；使用者介面用戶端會向閘道查詢工作階段資料。

訊息如何路由

私訊隔離

預設所有私訊會共用一個工作階段以維持對話連續性，這適合單一使用者的設定。

{  session: {    dmScope: "per-channel-peer", // 依頻道 + 傳送者隔離  },}

session.dmScope 選項：

停靠已連結的頻道

停靠命令會將目前私聊工作階段的回覆路由移至另一個已連結的頻道，而不會啟動新的工作階段。如需範例、設定及疑難排解，請參閱頻道停靠。

使用 openclaw security audit 驗證你的設定。

工作階段生命週期

工作階段會持續重複使用，直到依 session.reset 設定到期：

• 每日重設（預設為 mode: "daily"）- 在閘道主機上，於設定的本機時間 (session.reset.atHour，預設為 4，範圍 0-23) 建立新工作階段。每日有效期是根據目前的 sessionId 何時啟動，而不是後續中繼資料的寫入時間。
• 閒置重設（mode: "idle"）- 閒置達 session.reset.idleMinutes 後建立新工作階段。閒置有效期以最近一次真實的使用者／頻道互動為準，因此心跳偵測、排程及 exec 系統事件不會讓工作階段保持有效。
• 手動重設 - 在聊天中輸入 /new 或 /reset。/new <model> 也會切換模型。

若同時設定每日重設和閒置重設，則以最先到期者為準。心跳偵測、排程、exec 及其他系統事件回合可能會寫入工作階段中繼資料，但這些寫入不會延長每日或閒置重設的有效期。當重設切換工作階段時，舊工作階段佇列中的系統事件通知會被捨棄，避免過時的背景更新被附加到新工作階段第一個提示的開頭。

具有由供應商擁有之作用中命令列介面工作階段的工作階段，不會因隱含的每日預設值而中斷。若這些工作階段應依計時器到期，請使用 /reset 或明確設定 session.reset。

依聊天類型或頻道覆寫預設值：

{  session: {    reset: { mode: "daily", atHour: 4 },    resetByType: {      group: { mode: "idle", idleMinutes: 120 },      thread: { mode: "daily", atHour: 6 },    },    resetByChannel: {      discord: { mode: "idle", idleMinutes: 10080 },    },  },}

resetByType 支援 direct（舊版別名 dm）、group 和 thread。 如果未設定 session.reset/resetByType 區塊，舊版頂層的 session.idleMinutes 仍可作為閒置模式預設值的相容性別名使用。

狀態儲存位置

• 執行階段工作階段資料列： ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite
• 封存的轉錄檔案： ~/.openclaw/agents/<agentId>/sessions/
• 舊版資料列遷移來源： ~/.openclaw/agents/<agentId>/sessions/sessions.json

每個代理程式的 SQLite 資料庫中的工作階段資料列會分別保留以下生命週期 時間戳記：

• sessionStartedAt：目前的 sessionId 開始時間；每日重設會使用此時間。
• lastInteractionAt：最後一次延長閒置存續期的使用者／頻道互動時間。
• updatedAt：儲存區資料列最後一次異動的時間；適合用於列出和修剪，但不是 判斷每日／閒置重設時效性的權威依據。

從較舊的安裝版本遷移時，閘道啟動和 openclaw doctor --fix 會自動將舊版 sessions.json 資料列與仍在使用中的轉錄 JSONL 歷程記錄匯入 SQLite。缺少 sessionStartedAt 的資料列會在可用時，根據舊版轉錄 JSONL 的工作階段 標頭判定。如果較舊的資料列也缺少 lastInteractionAt，閒置時效性會改用該工作階段 的開始時間，而不是之後的簿記寫入時間。若要取得明確的檢查或驗證證據，請使用 openclaw doctor --session-sqlite inspect --session-sqlite-all-agents 和診斷程式遷移 順序。

工作階段維護

OpenClaw 會透過 session.maintenance 限制工作階段儲存空間隨時間增長，其預設值 如下：

{  session: {    maintenance: {      mode: "enforce", // "enforce" 會套用清理；"warn" 只會回報      pruneAfter: "30d",      maxEntries: 500,    },  },}

對於正式環境規模的 maxEntries 限制，閘道執行階段寫入會使用小型高水位緩衝區， 並分批清理回設定的上限。工作階段儲存區讀取不會在閘道啟動期間修剪或限制項目， 因此啟動和獨立的排程工作階段無須負擔完整的儲存區清理成本。 openclaw sessions cleanup --enforce 會立即套用此上限。

閘道模型執行探查工作階段預設為短期存在。符合 agent:*:explicit:model-run-<uuid> 的資料列採用固定的 24h 保留期限，但清理作業 受壓力條件限制：只有在達到工作階段項目維護／容量壓力時，才會移除過期的探查資料列， 而且會在較廣泛的過期項目存留時間截止條件與項目數量上限之前執行。一般的直接、群組、 討論串、排程、鉤子、心跳偵測、ACP 與子代理程式工作階段不會繼承此 24 小時保留期限。

維護作業會保留持久的外部對話指標，包括群組工作階段與限定於討論串範圍的聊天工作階段，同時仍允許合成的排程、鉤子、心跳偵測、ACP 與子代理項目隨時間淘汰。

如果你先前使用過私訊隔離，之後又將 session.dmScope 改回 main，請使用 openclaw sessions cleanup --dry-run --fix-dm-scope 預覽以對等方為鍵且已過時的私訊資料列。套用相同旗標會停用這些舊的直接私訊資料列，並將其逐字記錄保留為已刪除的封存資料。

請使用 openclaw sessions cleanup --dry-run 預覽任何維護作業。

檢查工作階段

延伸閱讀

• 工作階段搜尋 - 跨過往對話記錄進行全文回溯
• 工作階段修剪 - 修剪工具結果
• 壓縮 - 摘要長篇對話
• 工作階段工具 - 用於跨工作階段作業的代理工具
• 工作階段管理深入解析 - 儲存結構描述、對話記錄、傳送政策、來源中繼資料與進階設定
• 多代理 - 跨代理的路由與工作階段隔離
• 背景任務 - 分離執行的工作如何建立含工作階段參照的任務記錄
• 頻道路由 - 傳入訊息如何路由至工作階段

相關內容

• 工作階段修剪
• 工作階段工具
• 命令佇列