> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 会话搜索

# 会话搜索

`sessions_search` 会搜索你自己的历史会话中的用户和助手文本。每条结果都包含 `sessionKey`、时间戳、角色和简短的匹配摘录。需要查看上下文对话时，请将返回的 `sessionKey` 传给 `sessions_history`。

## 可见性和输出

搜索采用与 `sessions_history` 相同的会话可见性规则。在应用结果数量限制之前，会移除调用方可见会话树之外的结果。启用已创建会话可见性后，沙箱隔离的智能体仍只能访问由其创建的会话。

摘录会在返回模型前进行脱敏。结果还受数量、摘录长度和响应总大小的限制。

## 索引生命周期

OpenClaw 在每个智能体的 SQLite 数据库中，将全文索引存储在对话记录行旁。新的用户和助手消息会在持久化消息的同一事务中建立索引，因此索引绝不会落后于实时对话；工具结果、推理块和图像不会纳入索引。只有对话记录的活跃分支可供搜索。

早于索引创建时间的对话记录（例如由 `openclaw doctor` 导入的会话）以及活跃分支已回退的会话，会通过从下一次搜索开始的后台协调过程重新建立索引。因此，包含 `indexing: true` 的响应可能不完整；请在索引建立完成后重试。删除会话时，会在同一事务中移除其索引条目。

搜索目前使用 SQLite 的 Unicode 单词分词器，并移除变音符号。使用三元组分词改进 CJK 子字符串匹配是未来的优化方向。

## 会话搜索与记忆搜索

如需在原始会话对话记录中搜索确切的单词或短语，请使用 `sessions_search`。如需搜索持久记忆文件和进行语义回忆，请使用 [`memory_search`](/zh-CN/concepts/memory-search)。实验性的会话记忆语料库是这种精确对话记录搜索的语义补充。