Sessions and memory

工作階段搜尋

sessions_search 會搜尋你自己過往工作階段中的使用者與助理文字。每筆結果都包含 sessionKey、時間戳記、角色，以及簡短的相符摘錄。需要查看前後對話內容時，請將傳回的 sessionKey 傳給 sessions_history。

可見性與輸出

搜尋使用與 sessions_history 相同的工作階段可見性規則。在套用結果數量限制之前，會先移除呼叫者可見工作階段樹之外的結果。啟用所建立工作階段的可見性時，沙箱化代理程式仍只能存取由其建立的工作階段。

摘錄會先經過遮蔽處理，再傳回給模型。結果也會受到數量、摘錄長度及回應總大小的限制。

索引生命週期

OpenClaw 會在每個代理程式的 SQLite 資料庫中，將全文索引儲存在對話記錄資料列旁。新的使用者與助理訊息會在持久化訊息的同一筆交易中建立索引，因此索引絕不會落後於即時對話；工具結果、推理區塊與圖片則不會納入索引。只有對話記錄的作用中分支可供搜尋。

索引建立前的對話記錄（例如由 openclaw doctor 匯入的工作階段），以及作用中分支曾回溯的工作階段，會由下一次搜尋時啟動的背景協調程序重新建立索引。因此，包含 indexing: true 的回應可能不完整；請在索引建立完成後重試。刪除工作階段時，會在同一筆交易中移除其索引項目。

搜尋目前使用 SQLite 的 Unicode 單字斷詞器，並移除附加符號。未來將改進為使用三元組斷詞，以支援 CJK 子字串比對。