跳转至

会话搜索

sessions_search 会搜索可见历史会话中的用户和助手文本。每个结果 包含一个 sessionKey、时间戳、角色以及一段简短的匹配摘录。将返回的 sessionKey、messageId 和 sessionId 一起传递给 sessions_history,即可重新打开匹配的 上下文,包括会话重置前保留的历史。如果没有 messageId,历史 会返回相对于重置的最新尾部。一个仍位于该当前视图中的显式 messageId(包括重置后保留的重置前行)会保持当前视图行为, 并且可以包含后续的重置后轮次。对于当前视图之外保留的 活动路径行,显式 messageId 会打开其原始已关闭区间,并且不会 混入后续的重置后轮次。

锚定读取使用 limit 来限制周围消息。使用锚点时省略 offset。 对于 SQLite 转录历史,缺失或偏离路径的消息会返回空历史,而不是 最新尾部;不属于所选会话键的 sessionId 会被拒绝。 这些规则也适用于本地嵌入式模式,无需运行 Gateway。

可见性与输出

搜索使用与 sessions_history 相同的已配置会话可见性规则。默认 tools.sessions.visibility: "all" 允许非沙箱调用方在 Gateway 上跨智能体搜索会话,包括 其他用户的对话。跨智能体访问默认开启,并由 tools.agentToAgent 控制;设置 enabled: false 可阻止普通跨智能体访问,或使用 allow 来 限制智能体对(请求方拥有的原生子智能体和 ACP 子会话在 tree 或 all 下仍可达)。当调用方需要更窄的会话可见性时,显式设置 agent、tree 或 self。 按对等方的 DM 路由会隔离会话上下文,但不会限制会话工具可见性。

在应用结果限制之前,会移除超出调用方有效可见性范围的结果。当启用已生成会话可见性时,沙箱智能体仍仅限于其生成的会话。隐身会话仍被排除;将可见性从 all 收窄会阻止普通 跨智能体访问。

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

命令面板和 Threads 页面会将它们的会话筛选条件发送到 Gateway,Gateway 会在该范围内搜索完整的已授权索引历史。浏览器不会下载 会话名册来选择要搜索哪些转录,名册页面大小也不会 排除较早的匹配会话。

标题搜索将标点符号和重复空白视为单词分隔符,因此 per session communi 会找到标题为 Per-session communication controls 的对话。命令面板在将结果分组到 会话或消息下时使用相同的匹配规则。标识符搜索保留其字面匹配。

控制 UI 消息搜索将最后一个词作为前缀匹配,同时要求前面的 词完整匹配。例如,session communi 会找到 session communication。面向智能体的 sessions_search 工具保持精确词匹配。

切换到另一个对话后,命令面板还能通过标题或转录找到分配给自定义 侧边栏分组的智能体创建的对话。 未分组的生成会话和子智能体运行仍被排除在面板之外。 分组不会授予访问私有对话的权限,也不会在活动搜索中包含隐身或 已归档会话。

搜索返回一组有上限的最佳匹配。匹配数超过结果限制属于 正常情况,而不是索引不完整警告;请细化查询以缩小结果。实际的 索引工作以及被搜索排除的冷归档转录具有单独的状态 消息。当冷转录历史所属的会话被打开且历史被恢复后,它可再次被搜索。搜索不会自动恢复已归档历史。

索引生命周期

OpenClaw 在每个智能体的 SQLite 数据库中,将全文索引存储在转录行旁边。 新的用户和助手消息在持久化它们的同一事务中被索引,因此索引 永远不会落后于实时对话;工具结果、推理块和图片被排除。 只有转录的活动分支可被搜索。

早于索引的转录(例如由 openclaw doctor 导入的会话)以及 活动分支被回退的会话,会由从下一次搜索开始的后台协调重新索引。因此,带有 indexing: true 的响应可能不完整;请在索引完成后重试。删除会话会在同一事务中移除其索引条目。

搜索使用 SQLite 的 Unicode 单词分词器,并去除变音符号。

对于来自原始会话转录的精确词语或短语,使用 sessions_search。对于 持久记忆文件和语义回忆,使用 memory_search。 实验性会话记忆语料库 是这种精确 转录搜索的语义补充。

  • 会话工具 — 暴露此搜索的 sessions_* 工具接口

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw