跳转至

主会话

OpenClaw 首先是一个个人智能体。开箱即用,你发送给它的每一条私信——来自 Telegram、WhatsApp、iMessage、Slack 私信、网页应用或任何地方——都会进入同一个滚动对话:主会话。你可以在手机上提问,然后在笔记本电脑上跟进,智能体在两处拥有相同的上下文。只有一个大脑,而这里就是它思考的地方。

在底层,主会话是一个普通会话,其规范键为 agent:<agentId>:main(例如 agent:main:main)。后缀是固定的;自定义的 session.mainKey 值会被忽略。它的特殊之处在于,默认私信作用域会将所有私信合并到其中,并且系统的其余部分将其视为智能体的根:心跳会唤醒它,后台工作会向它汇报,其他地方的活动也会向上汇聚到它。

主页

在网页应用中,主会话是主页——侧边栏中的第一个条目。顶部的身份行是你的智能体(点击它可打开智能体菜单);主页是你与它对话的地方。从主对话分叉出来的会话显示在线程下,群聊显示在群组下,编码/CLI 会话显示在编码下。

边工作边与主页对话

在侧边栏底部选择与你的主页智能体对话(或按 Cmd/Ctrl+Shift+H),可在当前页面旁边打开主页。助手侧边栏可以停靠到右侧或底部。 它会跟随侧边栏智能体切换器中选择的智能体,因此只有一个地方可以切换智能体。询问 OpenClaw 仍然是同一侧边栏中一个独立系统维护对话。

停靠窗格使用你真实的主页对话,包括其历史记录、工具、审批和消息队列。打开主页完整页面会在主区域打开该对话,并暂时隐藏其停靠窗格,以避免出现重复的输入框。

展开正在处理以查看伴随你下一条消息的小型参考快照:当前页面,以及(如果可用)工作会话、工作区和可见文件路径。在工作区域中选择文本,并使用附加所选文本来包含一个有界摘录。使用移除工作上下文可在不附带快照的情况下发送。它会成为已发送消息的一部分,并在排队和重试过程中保持不变;斜杠命令不会包含它。这些引用不会授予主页智能体对另一个智能体会话或文件的额外访问权限。

哪些内容会流入主会话

主会话不仅仅是一个聊天日志;它是你的智能体世界汇聚的地方:

  • 新会话。 默认情况下,创建会话会在其智能体的主页对话中排队一条系统通知,其中包含会话键以及可用的标题、创建者和创建来源。主页会在其下一轮或计划心跳时看到它;创建不会触发额外的唤醒。设置 session.notifyOnCreate: false 可退出该行为。主页本身、草稿、隐身会话、隐藏的内部会话以及计划 cron 运行均被排除。重置或重新打开现有会话不会发送另一条创建通知。待处理的创建共享一个有界的内存摘要,为提醒和其他事件保留队列容量。该摘要会保留最近的会话元数据,并在满时省略较旧的条目;它不会让主页订阅未来的活动。
  • 群组活动。 在 session.groupScope: "per-group"(默认值)下,群组和房间会话保持隔离,同时主会话会自动监视它们。活动会以紧凑通知的形式排队——按对话合并,绝不会每条消息一次唤醒——智能体在下次运行时看到它们:在你的下一条消息或计划心跳时。在 tools.sessions.visibility: "all"(默认值)下,主会话可以在整个 Gateway 中使用会话工具,跨智能体访问由 tools.agentToAgent 控制,并且默认开启;其系统提示会列出被监视的群组,以便它知道最近的活动发生在哪些地方。
  • 后台工作。 子智能体和派生会话会将其结果通告回启动它们的会话,因此智能体从主页启动的工作会汇报回主页。
  • 心跳。 计划心跳以主会话为目标,这正是即使你没有输入任何内容,也能将排队通知转化为感知的原因。

跨重置和对话的记忆

滚动对话受模型上下文窗口的限制,因此连续性来自其周围的各个层:

  • MEMORY.md 是智能体精心整理的长期记忆,会被加载到每个新会话中。每日笔记(memory/YYYY-MM-DD.md)可按需搜索,最近的笔记会在 /new 或 /reset 后重新注入。在压缩之前,智能体会将持久事实刷新到每日笔记中,以免长对话悄悄丢失它们。
  • 跨对话记忆召回允许智能体召回其其他私有会话中的内容。在个人配置中——全局 session.dmScope 解析为 main 且没有按绑定的私信覆盖——它默认启用;任何已配置的私信隔离都会将其关闭,除非你明确选择启用。参见记忆配置。

具有持久历史的滚动会话

主会话通过重置和压缩向前滚动,而不是让模型一次性承载其全部历史:

  • 默认情况下没有自动重置;压缩会在保持滚动会话的同时将活动上下文限制在边界内。每日重置和空闲重置是可选启用的(参见会话管理)。在 /new 和 /reset 时,结束对话的尾部会被保存到每日记忆笔记中,下一个会话会重新注入最近的笔记。重置会分配一个新的实时会话 id,但会保留之前的 SQLite 转录,并使其可以在同一主会话键下搜索。
  • 当对话接近上下文窗口时,压缩会进行摘要并就地继续——转录历史保留在会话存储中。
  • 会话列表显示当前实时对话,而不是其背后的每个历史会话 id。
  • 当每个智能体存储的物理数据库、WAL 和会话工件超过磁盘预算(session.maintenance.maxDiskBytes,默认 10gb——参见会话维护)时,OpenClaw 会在删除其数据库行之前,将最旧的未引用历史提取到一个经过验证的压缩归档中。实时、已路由和进行中的会话绝不会成为预算牺牲品。

当你需要隔离时

共享主会话是仅与你对话的代理的合适默认设置。如果多个人都可以向你的代理发送消息,请隔离私信:

{
  session: {
    dmScope: "per-channel-peer",
  },
}

使用隔离作用域时,每个发送者都会获得自己的会话,并且跨会话记忆召回默认关闭。群组监视仍由 session.groupScope 独立控制:per-group 保留环境主会话可见性,而 main 会将房间直接放入主会话。openclaw security audit 在检测到多个发送者时会建议隔离私信。完整的作用域矩阵、身份链接以及按路由覆盖在 会话管理 和 频道路由 中介绍。

群组和房间默认使用独立会话。若要使选定的受信任团队房间成为滚动主会话的一部分,请在其路由绑定上设置 bindings[].session.groupScope: "main"。这会更改会话键和共享上下文;提及门控和回复路由仍使用原始房间。参见 会话管理。

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