跳转至

多用户模式

多用户模式允许多个受信任的人员操作同一个 OpenClaw 代理。它增加了会话所有权、参与者历史、实时在线状态和所有者过滤功能。这样,团队就能知道谁开始了工作、当前由谁负责,以及谁曾参与其中。

信任边界

任何能够操作代理的人都可以让代理执行该代理能做的任何事情。会话所有权、侧边栏可见性和在线状态指示器都是可用性功能,而非安全边界。

如果必须防止人们访问彼此的会话、工具、凭证或文件,请为他们提供独立的代理或独立的网关/主机信任边界。不要依赖所有者头像或过滤器来实现隔离。

拥有 operator.admin 权限的已认证 Control UI 管理员可以在该 Gateway 上以对话方式管理任何自动化任务,包括从其他渠道或由其他人创建的任务。该权限来自已准入的管理员轮次,无需将渠道身份与 Gateway 配置文件进行匹配。它不会转移任务的创建者归属或计划执行策略。

对已认证人员的可见性与公共会话记录访问是分开的。在共享、只读、建议和草稿之间切换会话,控制的是已登录人员。这些设置都不会创建公共链接。

会话创建者或 Gateway 管理员可以显式启用公共访问。任何拥有普通线程 URL 的人都可以在不登录的情况下阅读现有及未来的对话文本,而工具、推理过程、文件、图片、小部件、隐藏消息和内部元数据仍被排除在外。登录会以该人员现有的权限返回到同一个线程。分配不同的所有者不会转移发布权限。禁用公共访问会停止匿名读取;再次启用会使同一个普通 URL 恢复可读。之前已撤销的令牌链接仍然无效,已下载的副本无法召回。用户流程请参阅公开共享会话,安全与部署契约请参阅公共会话记录。

三层所有权

每个会话最多带有三层归属信息:

  • 创建者(不可变):当创建路径能够证明是谁发起了会话时,新会话会记录一次性写入的 createdActor。人类创建者保留其来源:经认证的 Gateway 配置文件、渠道发送者或未知的历史归属。只有配置文件创建者才能获得隐式创建者访问权限,包括通过经认证的配置文件合并获得。匹配的渠道、代理或系统 ID 不能识别该人员。共享和可见性权限始终锚定在创建者身上,即使所有者变更后也是如此。
  • 所有者(可分配):当前负责该会话的人员或代理,类似于 GitHub issue 的受指派人。它默认为创建者,可以随时重新分配。分配记录会记录重新分配者及时间。侧边栏头像、所有者过滤和人员排序都遵循当前所有者。
  • 参与者(历史记录):已认证人员、渠道发送者以及其被接受的输入针对该会话的请求代理。会话自身的代理和被动查看者永远不会被记录。新增身份准入限制为每个会话 32 条记录。修复可以保留更大的现有历史。参与记录在后台尽力而为地完成,因此绝不会延迟轮次。

返回会话行时,Gateway 配置文件的显示名称和头像会根据当前配置文件解析。代理行动者根据配置的代理身份解析。参与者聚合不存储显示标签,因此重命名配置文件或代理会更新所有权界面,而无需重写参与者历史。

分配所有者

在 Control UI 中,会话上下文菜单(侧边栏行上的 kebab 菜单或右键单击,以及聊天标题上的同一菜单)提供以下选项:

  • 分配给我:亲自承担该会话的责任。
  • 分配给…:选择任何已注册人员或已配置的代理,包括离线人员和从未拥有过会话的人员。打开菜单时选项会刷新,并且不依赖于会话过滤器或归档状态。

代理可以使用 sessions 工具 重新分配所有权,包括在工具策略允许时由非所有者代理执行的轮次。这些轮次会收到分配操作。具有 operator.sessions.write 权限的已准入操作员也可以请求代理通过仅标签补丁重命名他们创建的会话;其他会话设置、重置/删除以及全局组控制仍然受到限制。默认沙箱仅向这些非所有者写入者暴露重命名操作。显式的沙箱允许列表和拒绝规则仍然适用;显式允许 sessions 会保留调用者权限所允许的操作。具有 operator.write 权限的操作员只能归档或恢复他们创建的会话。他们可以停止他们创建的或被分配到的会话,但须通过会话访问检查。使用 action: "assign_owner",并带上 ownerType("human" 或 "agent")和 ownerId。默认情况下,它针对当前会话,也可以通过 sessionKey 针对其他可见会话。

归档和恢复需要创建者或 Gateway 管理员(operator.admin)权限,包括升级后的现有会话。非创建者的被分配所有者不再获得这些权限。如果创建者不可用,或者会话没有可用的配置文件创建者,管理员可以从会话菜单中归档或恢复它。重新分配所有者不会改变归档权限。

两种路径都会调用 Gateway 方法 sessions.assignOwner(operator.write)。分配要求调用者已被识别——已认证的 Gateway 配置文件或受信任的代理身份——并由会话可见性授权。代理所有者 ID 必须指向一个已配置的代理。分配后,头像工具提示会从“由…创建”切换为“由…拥有”。

重新分配所有者会改变责任和显示。被分配的人类也会在后续符合条件的回合中选择该会话的个人说明,包括来自其他参与者的回合。这是提示选择,而非冒充:它不会替换请求者的身份或权限,不会转移共享权限(共享权限仍属于创建者),也不会授予或移除访问权限。个人说明不是保密边界;请勿在其中存储机密。

创建者来源遵循计划任务和继承的创建策略。必需的沙箱是一种限制,而不是个人资料身份的证据。丢失创建者来源的历史自动化保留其归属和内容,但不会获得推测的个人资料授权。管理员可以管理其共享,或创建一个明确归属的新会话。分配所有者不会修复创建者权限。升级前请参阅创建者命名空间迁移。

每人模型账户

每个人都可以为其 Gateway 个人资料登录一个模型账户。他们启动的新会话会优先使用该账户,而不是 Gateway 默认账户。可用的提供商和登录方法来自 Gateway 的提供商插件。选择账户并不保证每个回合都向该账户计费。

存在两种登录:Gateway 识别你,然后提供商授权你的模型账户。CLI 和 Web UI 在所选 Gateway 上使用相同的个人账户存储。共享服务器不会将个人登录变成共享凭据。系统/代理凭据是独立的作用域,通过运行该 OpenClaw 安装所在机器上的 models auth 进行管理。

账户概念

有四个独立的部分:

部分 含义
已保存账户 由你的 Gateway 个人资料拥有的凭据。你可以为某个提供商保留多个账户。
新聊天默认 你的新聊天为该提供商优先使用的已保存账户。更改它不会重新固定现有聊天。
聊天选择 已为某个聊天选择的账户。其他人以及分支会保留该选择。
登录尝试 一种临时、可取消的操作。在登录成功之前不会保存任何账户。

添加账户

打开设置 → 个人资料 → 已连接账户,选择添加账户,然后选择提供商和登录方法。添加账户需要一个具有 operator.write 权限的已识别连接。

  • Anthropic 接受用于个人设置的 API 密钥,而不是 Claude 订阅令牌。
  • OpenAI 提供 API 密钥、ChatGPT/Codex 浏览器登录和设备代码登录。
  • Grok (xAI) 提供 API 密钥和设备登录。

选择器仅显示在该 Gateway 上为个人账户启用的提供商方法。按照其说明操作,并使用受保护的输入框输入凭据或授权代码。浏览器回调可能在输入框打开时完成。保持个人资料连接打开,直到其报告结果。保存凭据与验证成功的模型请求是分开的。

在添加账户之前,检查 Gateway、人员 和 范围:个人 行。账户所有权遵循 Gateway 分配的个人资料,而不是未保存的显示名称编辑。单用户连接可以使用持久的 所有者 个人资料。使用该个人资料的每个设备共享其账户。要在共享服务器上区分人员,请使用 Gateway 的承载身份端点。如果未分配个人资料,该部分会说明缺少什么,并链接到连接设置,而不是显示凭据输入框。浏览器身份不会转移到 CLI。请参阅个人账户 CLI 设置。

页面以友好标签列出已保存账户,并标记新聊天默认账户。选择另一个已保存账户即可更改该默认设置,而无需再次登录。加载更多 继续浏览更大的账户列表。新聊天使用 Gateway 默认设置 清除个人默认设置。已保存账户仍可用。

页面将确切的登录操作报告为待处理、已连接、已取消、已过期或失败。取消 要求 Gateway 终止该操作,包括已在途中的交换。断开连接、失去权限或重启 Gateway 会阻止未完成的登录启动另一个提供商请求或保存凭据。重新连接后开始新的登录。刷新个人资料身份不会中断账户控制。

为聊天选择账户

在新会话或现有聊天中打开模型菜单。展开账户类别,为所选提供商选择你的一个已保存账户。当自动没有符合条件的模型时,账户选择器仍可用。在新会话中,选择账户会在你的第一条消息之前预览符合条件的模型。该选择适用于你创建的会话,也可以在你按下开始之前用于草稿标题准备。它不会更改你的新聊天默认设置或已保存的模型偏好。更改账户会丢弃旧的标题建议。在现有聊天中,它会更改该聊天的选择。

账户控件显示他人个人账户的人员级标签,而不是其私人邮箱、提供商账户标签或账户 ID。该标签描述选择,而不是计费收据:已配置的共享故障转移账户仍可使用。

聊天状态和模型列表将所选个人凭据标识为个人账户,而不暴露其私人标签、邮箱或账户 ID。

CLI 与 Custodian

CLI 通过 openclaw models accounts 使用相同的 Gateway 操作。运行 openclaw models accounts login 以选择提供商和方法,或直接提供 login <provider> --method <id>。使用 list 检查已保存账户。每个命令都会显示所选 Gateway、已验证人员和 个人作用域。它针对该人员,而不是 --agent 或操作系统用户名。

向 OpenClaw(Custodian)提问需要管理员访问权限以及一个已配置且可用的推理路由。请它管理你的个人模型账户,或输入 model accounts。在 Control UI 中,它会打开 设置 → 个人资料 → 已连接账户。在终端中,它会提供 CLI 命令。如果 Custodian 不可用,请打开 已连接账户 或直接使用 CLI。该交接本身不会做出任何更改。请在受保护控件或隐藏终端提示中完成登录,切勿在对话中完成。委托的代理请求无法打开或完成人类登录流程。

凭据存储位置

凭据和所选链接一起保存在共享状态数据库(Gateway 状态目录下的 state/openclaw.sqlite)中私有的、按身份划分的记录里。不存在第二个账户数据库或 JSON 旁挂文件。待处理的登录操作只存在于 Gateway 内存中。凭据不会被添加到共享或代理本地认证存储中,不会被复制到全局运行时快照中,也不会包含在自动账户轮换中。重新连接只会替换由该人拥有的凭据。对于 ChatGPT,仅匹配工作区是不够的:提供方还必须识别出同一用户。由管理员关联的共享账户永远不会被个人重新连接覆盖。

管理员仍可通过 CLI 创建共享配置文件(openclaw models auth login --provider openai --profile-id openai:alice,参见 OAuth),并使用 users.linkAuthProfile 将它们关联起来。附加现有共享凭据属于管理员决定。users.unlinkAuthProfile 仍限于本人或管理员,users.listAuthLinks 返回链接元数据但不包含机密。个人凭据不能关联到他人的配置文件。

固定与默认规则

使用 operator.sessions.write 创建你自己的会话时,如果可用,会应用你保存的新聊天默认设置;否则使用 Gateway 的配置选择。显式选择个人账户以及更改你的新聊天默认设置仍需要 operator.write。两种创建路径都会保留当前的连接、配置文件和角色检查。

当已关联的人创建会话时,OpenClaw 会捕获其默认设置作为该会话的认证选择。该选择具有与 /model ...@profile 固定相同的强度。这发生在初始消息分发之前,包括创建和第一条消息是单独请求的情况。首次由回合准入创建的会话会在该准入时捕获默认设置。该固定是 会话粘性 的:其他人员进入该会话时会使用其已选择的账户,分叉也会继承它。显式的 /model ...@profile -s 固定优先于链接。新的个人选择必须属于执行该选择的已认证人类。知道另一个人的账户 id 并不构成选择它的权限。由代理和渠道发起的回合不会创建个人链接。对于使用 OpenClaw 认证回退规划器的运行时,如果固定账户失败,同一提供方的有序共享配置文件仍可作为故障转移候选项。这与显式固定的行为一致。Claude CLI 要求其已选择的账户,并且在该账户无法使用时不会替换为共享配置文件或其原生登录。

对新聊天使用 Gateway 默认设置、CLI clear-default 和 API users.unlinkAuthProfile 仅影响未来会话。更改默认设置不会重新固定现有聊天,包括使用共享凭据的未固定聊天。采用或分叉现有聊天不会应用当前参与者的默认设置,更改提供方也不会静默选择其个人账户。展开模型菜单中的 账户 类别以进行该显式选择。清除默认设置既不会删除已保存的凭据,也不会撤销提供方 token。如果现有会话必须停止使用它,请在提供方处撤销它。链接和现有会话凭据会遵循已验证的配置文件合并,但在幸存配置文件上的显式取消关联不会被合并逆转。

这是单一信任域内的账户选择便利功能,并非与管理员或作为 Gateway OS 用户运行的代码隔离。在兼容降级时,旧版本不会将个人凭据发现为共享默认设置。在恢复支持版本之前,个人账户选择不可用。

按所有者查找会话

当所有权可见时,侧边栏的会话筛选菜单会增加 所有者 部分:

  • 所有所有者 显示所有内容(默认)。
  • 特定人员或代理显示其当前拥有的会话。
  • 涉及我 显示你拥有的、你已提示过或你被明确提及的会话。发送的提及会立即添加该会话,即使你处于离线状态;收件箱的忽略和过期不会移除它。此筛选由 Gateway 针对完整参与者历史进行评估。它仅匹配你的已认证配置文件身份。渠道原生发送者 id 仅用于显示且从不匹配,因此数字渠道 id 不会与你的配置文件冲突。

在会话菜单中使用 从涉及我中隐藏,仅将该会话从你自己的筛选列表中隐藏。普通活动不会使其恢复,但新的明确提及会。该会话仍可在 所有所有者 下发现,在那里 在涉及我中显示 会恢复它。这些选择会跟随你已登录的配置文件跨浏览器和 Gateway 重启;它们不会归档会话或更改任何人的列表。

涉及我 需要已登录的 Gateway 配置文件。当加载的会话有多个所有者时,按人员分组 会为每个当前所有者创建一个部分。所有者 排序模式会按名称对这些所有者组排序。

阅读头像

Control UI 在视觉上区分所有权和在线状态:

  • 会话行上的实心所有者头像在该会话生命周期内是永久的,并且始终显示当前所有者。当所有者未连接时,它会略微变暗。
  • 当其他人员或代理已提示该会话时,行头像会变成 成对堆叠。所有者保持在前面。要么单个其他参与者从后面露出,要么 +N 计数概括多个。聊天标题显示所有者徽章加上最多四个头像的参与者头像堆叠。所有者不包含在参与者显示中。
  • 带环或半透明的在线状态头像显示当前已连接或正在观看的人员。它们来自实时在线状态,而非所有权,并在这些观看者离开时消失。已由所有者或参与者头像显示的人不会在该表面的实时观看者中重复出现。由 +N 计数概括的参与者仍可以单独作为实时观看者出现。
  • 在 按人员分组 下,部分标题中的所有者头像会在该人员连接时显示一个小绿点。当他们空闲几分钟后会变淡,并在他们离开时消失。你自己的部分从不显示它。

当多人观看同一会话时,转录区也会在输入框上方显示实时输入指示器。有人在 Control UI 中输入时,其草稿文本会以较柔和的已发送消息气泡样式流式显示,具有相同的发送者身份、跟随作者编辑位置的光标,以及 正在输入 · 未发送 标签。有界预览会保留空格和换行,并在作者编辑较长草稿时跟随光标。其他正在输入的人显示一个三点气泡,并带有相同的未发送标签。草稿是临时存在状态。它们永远不会持久化。它们永远不会进入会话转录或模型上下文。在输入者暂停或发送后片刻,它们会淡出。

当已加载的会话列表包含少于两个不同的所有者身份,且没有任何会话记录外部参与者时,OpenClaw 会隐藏所有所有权和所有者筛选界面。因此,单用户 Gateway 看起来没有变化。

人员卡片

点击或点按侧边栏 在线 部分中的人员,可打开其活动页面。将鼠标悬停在行上或聚焦该行,可打开其信息卡片。卡片中的 查看活动 会打开同一页面。未获资格的查看者没有个人资料活动页面,因此点击或点按他们的行只会打开卡片,其中包含连接详情和可见的已观看会话。

活动页面会每个不同的应用/平台描述只显示一次,因此多个匹配的浏览器标签页不会重复相同的设备元数据。在 正在查看 下方展开 连接详情,可查看分组连接数、报告的主机/平台、IP 地址、时区,以及可用的位置或输入最近性详情。这些计数描述的是连接,而不是物理设备。独立的标签页保留各自的已观看会话存在状态;合并显示并不会合并这些连接。

在 按人员分组 下,另一人员部分标题中的头像和姓名会打开同一卡片。箭头仍会折叠该部分。未连接的所有者会得到一张标记为 离线 的卡片,其中仅包含其最近会话和活动链接。

卡片显示该人员已连续连接了多长时间、其报告的应用/设备上下文和时区,以及在该在线期间最后观察到的活动。打开不同会话、输入和发送新消息都算作活动。连接心跳和代理响应不算。尚未观察到 表示没有记录到符合条件的活动,而不是该人员不活跃。这些计时事实是临时的,并在该人员的最终连接关闭或 Gateway 重启后重置。

人员存在状态会与具有读取权限的操作员共享(operator.read,也由 operator.write 或 operator.admin 隐含)。这些读取者可以看到其他人的在线和活动计时以及报告的时区,无论该人员是否正在观看会话。节点和仅配对连接既不会收到存在状态清单,也不会收到其活动驱动事件。这不会改变跨读取者的 IP 可见性,也不会为所有 Gateway 元数据提供隔离。参见 谁能看到存在状态。

正在查看 和 最近会话 使用有界、按访问范围划分的会话列表,独立于侧边栏的所有者、涉及我 和状态筛选器。打开卡片会跨已配置的代理刷新该列表;它仅包含活动会话。最近会话要求查看者和所有者或创建者具有相同的已记录个人资料身份。仅匹配原始 ID 是不够的。它们不是该人员贡献的完整历史记录。会话更新时间描述的是会话,而不是该人员最后操作的时间。连接描述和时区是客户端报告的提示,而不是经过验证的物理位置。

Gateway 还会使用 sessions.list 可见性规则,为每个接收者过滤已观看会话引用,涵盖连接快照、存在状态 RPC 响应和事件。隐藏或缺失的引用会被省略,不带计数或占位符。打开某人的卡片绝不会借用该人员的会话访问权限。

表情回应

在 Control UI 中,你可以对任何已保存的 Prompt 或助手回复进行表情回应,包括你自己的 Prompt 和其他人的 Prompt。进行表情回应需要一个已识别的作者,并且该作者具有向会话发送或在其中建议的权限。会话角色仅允许查看的操作员不能进行表情回应。所有能够读取会话的人都会看到其表情回应标签、计数和回应者姓名,并在会话打开时实时更新。

代理会在其下一轮中,将每个已提交的添加和移除作为单独的 System: 行接收,使用与频道表情回应相同的事件机制。添加、移除并再次添加同一表情回应会按顺序排队三条通知;重复一个不产生变化的操作不会排队通知。表情回应永远不会唤醒代理或创建通知。它们与转录分开存储,因此进行表情回应不会重写消息。永久删除一条消息也会删除其表情回应,并释放其在会话表情回应限制中的空间。重置会话会启动一个新的转录实例,而不包含之前实例的表情回应。

频道来源 Prompt 上的表情回应也会在频道支持时,作为机器人的表情回应镜像到该频道。跳过或失败的频道镜像不会移除 Control UI 表情回应。在机器人每条消息只保留一个表情回应的频道上,例如 Telegram 机器人和 WhatsApp,频道会显示最近镜像的表情。移除一个表情会保留频道上最新的剩余 Control UI 表情;移除最后一个表情会清除频道表情。助手回复上的表情回应不会镜像,因为转录不保留其已投递频道消息 ID。参见 聊天表情回应 了解调色板和切换控件。

提及人员

在转录中,选中的提及会在原始姓名旁边显示一个小内联头像。缺少照片时使用首字母。徽章省略可见的 @,而复制的文本保留它。

在正常的 Control UI 聊天中,输入 @,然后按人员的显示名称(包括空格)或任何已关联的已验证 GitHub 账号进行搜索,再从选择器中选择该人员。编辑器会显示 将通知 以及你选择的收件人。每条消息最多可选择十个提及。输入或粘贴 @name 但未选择人员时,只会发送普通文本,不会通知任何人。移除提及 会清除收件人选择,同时保留消息文本。

使用 Up/Down 在人员之间移动,使用 Home/End 跳转到第一个或最后一个结果, 使用 Enter 或 Tab 插入所选提及。Escape 会关闭选择器。在 @ 后立即输入空格 也会关闭选择器,因此单独的 @ 及其后的文本仍保持为普通文本。将光标移出活动提及 也会关闭选择器。输入名称中的空格仍会按完整名称进行搜索。筛选 会在所选人员仍匹配时保留该人员。选择器会在同一编辑器中复用同一搜索的最近结果, 包括关闭选择器或开始另一个提及之后。五分钟后,它会在后台刷新缓存结果, 而不会隐藏你已可选择的人员。切换会话、资料 或连接会清除该缓存。超过 30 分钟的结果会被丢弃。 选择器会为未缓存的搜索显示占位符,在无人匹配时显示空消息, 并在没有可用缓存结果的搜索失败时显示 重试。 将通知 会复用所选人员的照片,在加载期间 或照片不可用时显示首字母。

所选提及在会话记录中渲染为独立的人员引用。将鼠标悬停、聚焦或点按某个引用,即可打开与侧边栏中使用的相同信息卡片:当前名称和头像、观察到的在线状态和连接详情、可见的已关注会话和最近会话,以及活动链接。原始消息标签和复制的文本保持不变。卡片遵循显式的资料合并;普通未选择的 @name 文本不会变成人员引用。

选择器包括已知且有权读取该会话的 Gateway 资料,包括离线人员。其在线指示器只是连接提示,不是资格限制。使用持久的 Gateway 资料登录才能使用人类提及。提及会增加个人发现参与,而不是作者参与或 Git 贡献者署名。它绝不会添加会话成员身份、更改可见性或授予访问权限。Gateway 在创建和显示提及时会重新检查收件人的当前访问权限。

提及适用于普通消息、排队或引导的输入,以及新会话的第一条消息,包括远程放置的会话。它们在隐身、Goal、目录、仅建议、命令发送或终端启动模式下不可用。如果切换到不支持的模式后仍保留所选提及,编辑器会阻止发送。它会要求你移除这些提及,或返回正常聊天。它不会静默丢弃已选择的收件人。

提及收件箱

打开 收件箱 → 提及,查看跨可访问代理发送到你已登录资料的消息。打开某个提及会打开其会话,而不会将其忽略。选择 忽略 可从你的收件箱中移除该条目。该更改会在同一资料跨已连接浏览器中同步,而不会删除聊天消息。

提及和忽略操作会在 Gateway 重启和升级后保留。条目会保留其原始标识符和过期时间:最多七天,每个资料最多 100 个条目,整个 Gateway 最多 10,000 个条目。较旧的条目可能因容量限制而提前被移除。刷新或重新连接会重新加载保留的收件箱,而不会重新发送旧的浏览器提醒。不会扫描旧会话记录消息来重建缺失的条目。

个人参与和隐藏/显示选择保存在逻辑会话节点上的私有元数据中,独立于收件箱保留策略。重置和会话迁移会保留它们;删除会话会移除它们,且分支不会继承它们。不会扫描现有会话记录消息来回填参与状态。最后提交的提及位置可防止重放旧消息撤销之后的隐藏选择,即使收件箱条目已过期。

收件箱及其重放记账使用共享数据库的现有机器状态记录,无需更改 SQLite 架构。提及注释保留在现有消息 JSON 中,通知偏好设置使用现有偏好设置记录。参见 收件箱存储和保留。

收件箱无需浏览器通知权限即可工作。如需在离开 Control UI 时接收可选提醒,请在 通知 中启用 有人提及我。有关发送和重试契约,参见 WebChat。

代理生成的会话

在由多人引导的一轮中,sessions_spawn 需要 user(请求者的已验证 requester_profile.id), 并且子会话会以该人员保留的权限运行。此选择不会 更改会话的模型账户或以下创建者和所有者规则。

代理使用 sessions_spawn 创建的会话(visible: true)通常保留请求代理作为其不可变的创建者。必需的沙箱则会保留父会话的创建者来源作为隔离策略。如果活动的人类请求者与请求会话的已验证人类所有者匹配,新的可见子会话会将该人员指定为其初始所有者。不同的所有者、未关联的请求者或由系统触发的生成会显式将请求代理指定为所有者,即使沙箱策略保留了人类创建者来源。侧边栏显示当前所有者的资料或已配置的代理身份,而不是内部会话密钥。该分配遵循相同的 所有者和个人上下文规则;共享和可见性权限仍以创建者为基础。

已接受的 spawn 结果兼作回执。它包含子会话密钥、run id、直接的 Control UI sessionUrl,以及一个指明已存储 owner 的 owner 记录。当 Control UI 被禁用时,会省略 sessionUrl。当 agent 在聊天频道中确认 spawn 时,它会将 session URL 放在第一行,并将 Owner: <label> 放在第二行。然后你可以打开该会话,一眼看到负责人是谁。仅当责任需要再次转移时,才使用 分配给我 或 sessions 工具。有关 spawn 生命周期,参见 子代理。

身份作用域的便捷状态

当连接具有持久 Gateway 配置文件时,新会话偏好和选择器最近项会跟随该用户跨浏览器。偏好仍按 agent 划分,而最近项仅从该用户创建的会话派生。没有持久身份的连接会保留浏览器本地偏好,并从已加载的会话列表派生最近项。

单用户 Gateway 会为未识别的操作员提供一个共享的 owner 配置文件,包括 device-token 重连。配置了 gateway.roles 时,这仅适用于 token/密码连接。使用该配置文件的设备会共享其身份和偏好。使用按人员登录来区分人员。参见 Gateway 配置文件。

此状态可提升连续性。它不是授权或隔离边界。操作员作用域仍控制操作,且共享 Gateway 仍是会话、工具、凭据和文件的一个信任域。

草稿

将会话作为草稿开始,可在发布前将进行中的工作隐藏在其他人的侧边栏之外。草稿从不向管理员隐藏,管理员会看到其他人的草稿,并带有淡化的幽灵标记。这是一个协调功能,而不是安全边界。

目录列表和进度更新会为每个接收者重新检查当前会话可见性。缓存的 provider 结果不会保留对已变为草稿或隐身会话的访问。已采用的线程仍绑定到其原始会话实例和插件所有权。删除并重新创建会话密钥不会将旧线程转移给新创建者。目录读取和变更也会在 provider 枚举后重新检查已存储的会话。

轮次归属

轮次发送者归属是尽力而为的。Steering 可以将输入合并到活动轮次中,因此转录不一定总能将每个人的贡献表示为单独的轮次。参与者历史记录记录某个 actor 提示了会话,而不是哪些词属于该 actor。

参与者身份独立于显示名称和授权。已认证的 Gateway 配置文件、OpenClaw agent 和远程发送者即使 ID 匹配也保持不同。频道插件在能够证明时,会提供远程身份域和标识符类型。否则,OpenClaw 会保留一个未解决的观察。它不会根据发送者 ID、本地账户标签或 UUID 形状猜测配置文件。配置文件合并通过现有配置文件别名解析。已接受的输入会更新已保留的当前配置文件行,或在不存在当前行时更新已保留的别名,即使达到 32 条记录准入上限。历史行保留其原始 ID。这不会重写转录或其他 agent 数据库。

配置文件参与记录已接受的外部创建输入,包括被接受到活动轮次的 steering 和针对会话的交互式输入。合成运行、内部消息以及 bot 或环境工作不会建立个人配置文件活动。参与者记录是聚合值,而不是精确的、可重放安全的生命周期输入计数。重置会保留逻辑会话的参与者。删除会话会移除它们,即使保留了转录归档。

正常准入限制是每个逻辑会话 32 个身份。现有身份在该限制下仍可继续贡献。修复会保留已保留的更大历史,而不是丢弃它们。四头像页眉只是预览:Gateway 会在分页和预览截断之前评估人员过滤器。Activity 会报告关联会话,包括已验证的创建或分配的责任,而不是声称会话最近性就是某人的最后输入。受限历史和截断结果会被标识为不完整。

schema-18 迁移(首次随 v2026.8.1 发布)会保留历史成员资格和已记录的贡献聚合。早期写入器可能合并配置文件和频道时间戳,因此模糊的首次和最后输入时间会变为未知。之后接受的输入会建立新的已记录最后时间,但无法恢复首次输入时间。不会运行基于转录、显示名称或 UUID 的回填。参见 数据库架构。

新的转录消息会将合格的发送者身份与显示名称分开。只有合格的配置文件发送者才能获得配置文件头像、人员 Activity 链接,或被识别为已登录人员,并且只有他们的消息会清除该配置文件的正在输入指示器。匹配的频道发送者 ID 并不足够。写入钩子可以编辑发送者身份,但不能将其替换为另一个受信任身份。建议归属会标识建议的作者,而不是接受它的操作员。

较旧或其他不合格的消息会保留其已保存文本和发送者标签,使用首字母代替推断的配置文件头像,并且没有人员 Activity 链接。当未记录发送者或来源标签时,聊天和回复预览会使用标签“Message”,没有头像,而不是当前查看者的名称或头像。Markdown 导出同样从不假设未归属的输入由查看者编写。这适用于现有历史,且不更改其已存储消息。OpenClaw 不会重写这些消息,也不会从 UUID、配置文件查找或参与者历史中重建其作者。这可能会移除一条确实由配置文件作者编写的旧消息的配置文件展示,因为它没有记录足够证据来确立该事实。转录归属、参与者聚合和基于创建者的访问决策仍是独立的契约。归属和参与从不授予会话访问权限。

通过 Cloudflare Access 或 Tailscale Serve 进行的基于 GitHub 的登录会自动在 设置 → 个人资料 → 身份 下验证此人的 GitHub 账户。公共 Co-authored-by 署名仍是一个独立的 Git 共同作者署名 开关,对已验证账户默认开启。署名使用该偏好设置,加上持久的个人资料参与记录,以及委派工作时捕获的贡献者快照。继承的署名不会确立子级参与、个人活动、所有权或访问权限。显示名称和四人头像堆叠投影不是身份证据。有关隐私、资格、边界、账户更改以及禁用未来署名,请参阅 用户模型。

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