本页内容
本页内容
网络界面
会话和侧边栏
侧边栏将导航分为 Pages、Sessions 和 Users。新会话页面开始新对话。
在手机上,向右滑动聊天即可打开导航。当你的手指仍然向下时,故意滑动即可打开整个抽屉,而不是在对话中握住部分剪切的侧边栏。短距离拖动和垂直滚动会使导航关闭。点击抽屉外部将其关闭。
要直接在配对设备上的文件夹中工作,请选择该特定设备,然后在工作区选取器中选择 设备上的现有文件夹。输入该设备上的绝对路径。该选项仅在连接的会话主机通告支持时出现; Auto 无法选择现有设备文件夹。会话保持与该设备的绑定并显示其文件夹路径。文件保留在设备上,而不是复制到网关或与网关协调。请参阅 会话托管 。
导航导轨
图标栏与所选导航列表保持分离。 Pages 打开可用的内置页面、仪表板和插件目标,Sessions 打开对话,Users 打开人员列表。其标头选择 Online(默认值)或 All users,包括授权用户目录中的离线配置文件。标头是一个过滤器,而不是折叠控件。页面始终隐藏存档会话中的仪表板,并且没有存档切换开关。要在侧边栏中查找已存档的会话,请改用 Sessions 过滤器。将鼠标悬停或聚焦于其名称的图标。活跃代理的头像位于栏杆顶部并打开代理菜单;在团队模式下,它会打开工作区菜单。带重音的 +,标记为 New Conversation,位于头像正下方,通过分隔线与导航分开。即使列表折叠,它也会保留在页面、会话和用户中的同一位置。它为所选代理打开新会话;在团队模式下,首先从菜单中选择一个代理。命令面板搜索位于三个视图按钮下方。再次单击选定的页面或会话视图以折叠其列表,或者在 Mac 上按 ⌘B 或在 Windows/Linux. 上按 Ctrl+B。 当列表隐藏时,三个视图按钮都不会被选择;单击任何视图以打开其列表。在列表打开时选择不同的视图会直接切换到该视图。再次单击“用户”可保持其列表打开;使用折叠按钮或键盘快捷键将其隐藏。主页、收件箱和您的帐户控件位于栏杆底部。打开您的帐户菜单并选择 Updates 直接转到 设置 → Updates。这将打开更新设置页面而不开始更新。对于 stable 和 beta 更新通道,当新版本准备就绪时,Available 徽章会出现在 Updates 旁边。收件箱还显示更新通知;关闭它不会隐藏帐户菜单徽章。 dev 频道从不显示新的更新通知。主页可切换主页面板并显示活动客服人员的主页活动和注意力状态。在加载主页会话之前,主页导航和代理切换仍然可用。无论其存储的会话祖先如何,主页都会保留导航根。在桌面上,打开主页或固定的会话、页面、插件或人员会折叠列表,同时保留栏可用。移动抽屉保持其正常的导航行为。
铁路开始时没有个人捷径,包括从旧侧边栏升级之后。旧的侧边栏顺序和图钉不会保留。将页面、仪表板、会话或人员拖到其空白区域中以添加;拖动时会出现一个放置目标。直接拖动快捷方式即可对其重新排序。右键单击或触摸并按住快捷方式,或者将其聚焦并按上下文菜单键或 Shift+F10,无需拖动即可移动或取消固定它。取消固定会删除快捷方式,而不是会话、仪表板或人员。固定会话不会更改其所有者、共享、存档状态或其他人的侧边栏。
人员快捷方式可打开该人员的可访问工作。离线不会删除已保存的快捷方式。 PIN 码不会授予访问权限:目标仍会应用其正常权限,并且暂时不可用的资源会保留其保存的位置,而不是从您的首选项中删除。卸载的会话快捷方式在后台解析并显示其会话名称和图标。待处理、丢失或不可用的快捷方式将保持隐藏状态,而其保存的参考仍然保留。在会话加载到列表中或连接发生更改之前,解析的名称和图标可能会稍微过时。当未设置图标时,会话快捷方式会显示自己的表情符号或图像,或标题缩写。只有运行环和未读点装饰这些快捷方式。
会话所有者过滤器
每个视图都有一个标题行。在会话中,标题是所有者过滤芯片:我的会话、涉及我、所有所有者,或所选人员的姓名。打开芯片来选择显示谁的会话。 涉及我还包括参与和提及。仅当外部目录条目采用的 OpenClaw 对话位于网关过滤列表中时,才会出现在 Involving me 中。仅共享或导入的目录访问并不构成参与;使用 All Owner 浏览这些来源。单独的过滤器按钮控制剩余的会话过滤器。新的对话停留在轨道上,而不是进入此标题。手机聊天中,打开导航即可到达轨道上的新对话;对话标题为 Session 操作 和 Panels 保留两个右侧控件。当抽屉关闭时,其他移动页面在页面顶栏中保留等效的 +。打开抽屉会将动作移回导轨,无需第二个标题按钮。在团队模式下,创建将打开与轨道相同的代理选择器。本机应用程序保留其本机创建控件。
所有者过滤器是此选择的唯一控件。它保存的值属于当前网关和您在此浏览器中的个人资料。没有保存选择的登录配置文件以 My 会话 开头。在识别配置文件之前,或者当连接没有持久配置文件时,列表显示 所有所有者。识别配置文件将恢复其保存的选择或 我的会话 默认值。在重新连接期间,已知配置文件的标题和过滤器将保持不变,直到身份解析或连接发生变化。筛选的会话列表在自定义组元数据之前加载,因此缓慢的组目录不会占用会话行。当该目录到达时,组名称和排序会更新。在没有所有权过滤器的单用户安装中,标头是普通的 Sessions 标题,并且列表包含没有所有者元数据的会话。
个人导航存储
对于具有写入访问权限的经过身份验证的配置文件,引脚引用及其顺序使用现有的网关用户首选项存储并遵循跨设备的配置文件。导航不是共享服务器设置。没有保存快捷方式的配置文件开始时为空。读取其首选项不会导入共享导航或固定会话,并且在编辑轨道之前不会写入任何内容。快捷方式使用新的 ui.railShortcuts 首选项;旧的 ui.sidebarEntries 值仍被存储,但被忽略。在新首选项下保存的快捷方式(包括空列表)保持不变。并发保存使用冲突检查并保留不相关的引脚编辑。
浏览器保留设备特定的几何形状和瞬态呈现,例如侧边栏宽度和滚动位置。只读连接或没有持久配置文件的连接上的导航更改保留在浏览器本地,而不是写入其他人的布局或共享网关配置。
当网关接受第一个提示时,新会话会立即预览它。临时选定的行会立即出现在侧栏中,清除先前聊天的突出显示,而不更改保存的会话,直到接受创建。临时行没有会话操作;失败的创建会恢复草稿。一旦接受创建,提交的提示和附件就会从新会话编辑器中清除,而无需等待其聊天预览加载。在提交确认的对话 URL 之前,提交的浏览器草稿已停用,因此关闭选项卡不会恢复已发送的提示。失败的创建或较新的未发送草稿仍然可用。保存的工作树名称首选项可以在导航的同时完成清除。
移动现有会话
右键单击侧边栏或会话页面中的一个会话,或打开其聊天标题操作。 移动到云… 打开本地会话的目标选择器; Move 会话... 对活动云或设备会话执行相同的操作。选择已配置的云配置文件或符合条件的配对设备。活动远程会话也可以移回 Gateway。对话保留其会话标识。
移动需要会话拥有的工作树或存储库工作区。具有活动回合的本地会话必须首先完成该回合;繁忙的拒绝不会中断它或开始配置。移动活动远程会话会在中断其轮次之前发出警告,并且不会重播它。从离线设备继续需要明确确认,因为未同步的文件和正在进行的工作可能会丢失。
如果接受的移动因耗尽源而失败,则 Retry move 将恢复其保存的目标和原始源。它不会打开另一个目标选择器或重播中断的转弯。 Move 失败的 芯片也可以进行相同的重试。离线设备放弃重试需要再次进行破坏性确认。等待该移动完成后再选择其他目标。
设备移动需要写访问权限;配置的云配置文件需要管理员访问权限。不可用或运行时不兼容的目标仍处于禁用状态。此菜单无法覆盖 部署所需的工作线程配置文件 :只能选择没有操作系统或机器级覆盖的配置文件。如果在选取器打开时放置或连接发生变化,请重新打开操作,而不是应用过时的选择。
新会话名称
在 New session 中,暂停键入一秒钟即可仅使用所选代理的实用程序模型在后台准备会话名称。准备工作在提交之前将未发送的草稿文本发送给该提供者。它在至少 12 个字符之后开始,最多发送前 1,000 个字符;它不发送附件。
准备工作在隐身模式和斜线命令中被禁用。编辑会替换陈旧的准备名称,并且一次仅运行一个请求。丢失或失败的实用模型不会回退到主模型或阻止您启动会话。
明确的个人帐户选择在准备标题之前等待帐户确认。同一提供者上的实用程序模型使用该帐户,除非实用程序模型指定其自己的身份验证配置文件。更改模型或帐户会放弃旧的建议;这两个操作都不会更改您保存的帐户默认值。对于 Automatic,标题准备使用代理的实用模型身份验证,这可能与实际聊天开始时选择的个人默认值不同。
Start session 使用匹配的准备名称(如果已准备好)。否则,提交后将运行正常的初始命名; Start 从不等待推测调用。当姓名待定时,侧边栏和聊天标题会显示一个轻轻挥动的斑点,而不是“新会话”。一个现成的名字会立即取代它;如果命名结束时没有名称,则返回普通的后备标签。减少运动首选项使占位符保持静止。这仅用于创建:后续消息不会重新生成现有会话的名称。显式工作树名称将被保留,并且键入永远不会创建工作树或运行安装程序。
如果提交后自动命名失败,会话将收到一个以甲壳动物为主题的两个单词的名称。新的工作树分支使用保存的会话标题(如果可用),如果命名尚未完成,则使用相同的两个单词后备。他们从不使用第一条消息文本作为分支名称后备。稍后到达的标题会更新侧边栏,而无需重命名现有分支。
新会话偏好和最近项目
更改代理或将草稿交给新会话会关闭草稿的打开菜单。在命令选项板的会话设置中,Escape 首先关闭嵌套代理菜单并将焦点返回到其触发器。
在 Project → Browse 中,键盘焦点移至文件夹路径。 Escape 将焦点返回到 Browse。在不将焦点从路径字段移开的情况下,会宣布加载和文件夹错误。 Enter 打开输入的路径;首先使用向上或向下打开突出显示的文件夹。 Tab 完成文件夹名称。如果起始工作区尚不存在,“浏览”将打开主文件夹。您输入的路径的错误仍然可见。
为了与持久的用户配置文件连接,网关存储每个代理的最新文件夹、工作树、模型、思维和快速模式选择。新会话为受支持的提供程序恢复最后的快速模式选择,包括显式关闭选择。新会话选择器还显示仅从该配置文件创建的会话派生的最近项目和文件夹。这些便利伴随着人们跨浏览器;他们不授予对项目或路径的访问权限。
对于选定的项目,Checkout 使用网关对选定代理的可用性决策。如果当前结帐不可用并且允许托管结帐,则新会话在提交之前会选择 New worktree。 当前结帐 保持可见,但已禁用并带有说明。允许保存的选择保持选中状态;不可用的已保存选项将得到纠正,而无需清除您的提示、模型或工作。创建会话时,网关会再次检查访问权限。
具有会话访问权限的来宾可以将这些选择保存在自己的配置文件中,而无需更广泛的网关写入权限。这不允许更改他人的偏好或私人背景资源。
自定义工作树 Name 适用于提交的会话。一旦其启动被接受,新会话将清除该名称,同时记住存储库、签出模式和基本分支。后台启动也做同样的事情。失败的准入会留下可重试的名字;接受的放置会保留其原始会话和工作树请求以进行恢复,即使工作区准备稍后失败也是如此。如果无法确认清除已保存的名称,则UI会警告您在启动另一个工作树之前检查名称;已接受的会话继续进行。清理保留由另一个草稿或浏览器保存的较新的签出选择,并保留并发模型更改。恢复的开始,其原始碱基选择无法与后来的编辑区分开来,也会使保存的名称保持不变并显示该警告。如果无法确认保存新的草稿选择,则会出现单独的警告,要求您在开始之前检查选择;首选项清理永远不会重试会话创建。
在第一个识别的连接上,仅当网关尚无此类首选项时,Control UI 才会上传现有的浏览器本地新会话首选项。并发的第一个连接会保留另一个浏览器已保存的选择,包括清除的工作树名称。以后的更改首先写入网关,然后更新浏览器镜像。没有持久身份的连接将继续使用浏览器本地首选项和加载的最近会话名册。
当远程项目会话在其存储库完成克隆之前启动时,聊天会显示工作区准备进度。如果准备失败,打开或重新加载聊天将恢复会话的失败摘要。更正报告的问题,然后在同一会话中发送新消息以重试准备。
接受的浏览器消息(包括等待工作区准备和运行期间的后续操作的初始提示)将像正常消息气泡一样保持可见,直到轮到它们自己为止,而无需额外的接收通知。通过 sessions_send 或网关 agent 方法接受的输入使用相同的显示。它们与活动模型转录本分开存储。如果取消或网关重新启动中断了等待,则消息将以其记录的配置保持可读,并且永远不会自动重新发送。停止的消息保留在对话中的原始时间,之后发送消息之前;只有仍在等待运行的输入才会停留在实时边缘。将停止的消息复制到编辑器中以开始新的尝试。 显示较早的消息 翻阅仍在等待或在处理之前已停止的消息; 显示最新消息返回最新页面。传入的活动会刷新您正在阅读的页面,而不更改您的选择。长消息使用普通的完整消息阅读器,不会成为文字回复、分叉或倒带目标。
当新的聊天开始时,作曲家仍然可用。您可以继续输入并排队后续消息;他们在最初的提示后等待并保留订单。在网关确认新会话之前,这些后续操作将保留在当前选项卡中,因此请保持其打开状态。如果创建失败,原始提示、排队的后续和未完成的后续草稿仍可重试。创建成功后,后续人员将使用已确认对话的正常发件箱。失败的初始提示会使其后续提示暂停以供审核,而不是提前发送它们。
浏览器草稿和未发送的消息保留在本地队列中。一旦网关接受普通浏览器消息,它就拥有持久保管的批准输入。收集模式使用已接受的源及其组合的转录条目。接受并不意味着转录本行已经存在;接受的输入将替换其本地待处理副本,并随后成为一封已保存的消息,包括其附件。消息通过提交、接受、重新连接和存储恢复来保持其队列位置。更改交货状态不会重新订购;显式队列重新排序和转向保留其正常行为。
系统工作区
打开 Pages → Systems,或访问 /systems,检查可用于连接的网关、工作人员环境和配对设备。使用页面中系统旁边的固定按钮,或将其拖到导轨中,以保留个人快捷方式。
当系统打开时,在导轨中选择 Sessions 以显示其上下文计算机列表而不是对话。页面和用户保持独立的视图。中间列表独立于导轨滚动;侧边栏标题和导轨的底部控件保持固定。返回对话会恢复其侧边栏滚动位置。导航改变了这种背景;后台计算机或会话活动不会切换您的工作区。
使用搜索字段旁边的 过滤和排序机 按字母顺序对每个组进行排序,在线优先(默认)或离线优先。选择 All、Online 或 Offline 按报告状态进行过滤;搜索进一步缩小了选择范围。启动、停止和错误状态在 All 下仍然可见。过滤不会更改工作区中打开的机器。当您离开 Systems 并通过同一连接返回时,这些选择将保持不变。
计算机列表不包括已完成拆卸的云工作人员,包括存档会话中保留的记录以及未分配计算机的失败启动。等待清理的工人仍然可见。归档会停止通过正常的工作区协调流程运行云工作人员;失败的放置保留其现有的清理重试和恢复历史记录。
选择支持桌面的系统以在主工作区中打开现有的桌面查看器。它使用与桌面面板相同的连接、控制、大小调整和全屏行为。无头和脱机条目仍然可以检查,而不是打开空桌面。配对、桌面启用和操作员权限仍然适用;打开系统并不授予额外的访问权限。
系统详细信息使用报告的事实。连接的设备不一定是运行会话的计算机,并且不可用的测量值不会显示为零。有关工作人员桌面启用和大小调整的信息,请参阅 Cloud Worker Desktop。
侧边栏导航
Filter & sort 弹出窗口将 Filters 和 Display 保留在一个面板中。 Filters 控制状态、自动化和系统会话。 Display 控制分组、排序、消息预览和空组。选择立即生效。仅当 Status 与 Active 不同时,过滤器按钮才会显示点。当任何可见的过滤器或显示设置与其默认值不同时,Reset 就会出现在过滤器标题的右侧。它恢复所有可见的面板设置:活动状态、自动化和系统会话关闭、自定义组、创建的排序、过滤空组时以及消息预览关闭。重置会保留所有者在标题中的选择。显示选项从不添加过滤点。 Tab 在行之间移动;左和右在分段状态控件中选择。标题芯片会打开一个带有所有者头像和搜索字段的选择器;输入按名称过滤所有者,Escape 会在关闭前清除搜索。当状态过滤器没有留下任何会话时,所选所有者将保留其已知的显示名称。 按、排序按和H隐藏空组显示其当前选择并在悬停或单击时打开子菜单。向右打开子菜单,向左关闭子菜单(RTL 中相反);向上和向下在选项之间移动,然后按 Enter 键进行选择。自动化、系统会话和消息预览使用一致的 on/off 切换。 Escape 首先关闭打开的选择器,然后关闭弹出窗口并将焦点返回到过滤器按钮。 会话源 打开其“设置”目标。在 显示所有座席 模式下,显示会忽略分组和空组控件,因为侧边栏始终按座席分组。重置使这些隐藏的首选项保持不变。它还保留已保存的人员分组,而所有者数据暂时使该选择不可用。
在手机宽度布局上,面板作为底部工作表打开,如问题表:点击背景或按 Esc 键将其关闭。该工作表没有悬停或弹出窗口:点击 按、分组按 或 H 隐藏空组 将其选项打开为工作表内的页面,其中Back 并检查当前选择。选择应用它并返回主页。标题芯片会打开一个单独的所有者表,并在滚动所有者列表上方进行搜索。状态和切换按钮保留在过滤器面板的主页上。
聊天标题链接到可访问的父会话,即使它位于当前会话列表之外,包括隐身父会话。
当您将指针移到其上并暂停时,导轨中的座席切换器和工作区按钮会预览其菜单。单击该按钮使菜单保持打开状态。从“设置”返回后,菜单会在固定指针下关闭。
拖动轨道快捷方式,包括插件提供的目标,将它们重新排序在一起。个人订单在重新加载后仍然有效。暂时不可用的插件会在返回时保留其保存的位置。主页、收件箱和帐户控件固定在底部;取消固定目标不会将其从 Pages 中删除。
当您重新加载对话时,保存的图钉标签在加载所选聊天时仍然可见。加载的会话列表之外的引脚随后会在后台刷新。
要在不拖动的情况下对轨道快捷方式重新排序,请右键单击它,触摸并按住它半秒钟,或者将其聚焦并按 Shift+F10 或上下文菜单键。选择 向上移动、向下移动 或 取消固定。存储的会话部分标题保留其 Reorder 夹点菜单。键盘焦点保留在移动的项目上,并且顺序使用与拖动相同的已保存首选项或网关组顺序。来自人员、项目或代理的主页和部分保持其现有的固定顺序。
使用 Pages 中每个目标的固定按钮来添加或删除其铁路快捷方式。导轨的快捷菜单还提供 Unpin。 Pages 是一个资源目录,而不是收藏夹的第二个有序列表。
要检查 Home 的子代理,请打开 Home 并选择 Subagents。侧面板列出了普通的子跑步并打开其仅供查看的成绩单,而无需替换主页。 Swarm 成员保留在并行任务视图中。您还可以使用 /subagents list、/subagents info <id|#> 或 /subagents log <id|#>。参见子代理斜线命令。
即使原始任务完成后,现有子代理会话中的后续轮次也会使父代理的活动环保持运行。打开父级会刷新其隐藏的子代理活动,而不会将子代理行添加到侧边栏。当没有工作处于活动状态时,环就会消失。
当孩子运行失败或发布关注请求时,即使家长没有新的回复,家长聊天也会在作曲家上方显示孩子的姓名和完整诊断信息。 打开会话 打开该孩子的详细信息。打开家长并不表示承认孩子主动关注的请求;它的通知遵循子级的读取状态、显式清除和到期。
将鼠标悬停在会话上即可查看其项目和分支。存储库详细信息和工作目录保留在悬停卡和工具提示中,使侧边栏行清晰可见,以显示会话标题和活动指示器。
将鼠标悬停在已启用自动化的会话上即可检查其附加作业,而无需离开对话。时钟行显示一项作业的自动化名称或多项作业的计数。悬停或聚焦该行以打开只读弹出窗口;单击使其保持打开状态。弹出按钮列出了附加作业,包括暂停的作业,并显示所选作业的计划、下一次运行、当前状态、最后结果和说明。展开 完整说明 以阅读长提示、命令或脚本。加载、空和不可用状态是明确的;读取失败提供 Retry。 开放自动化 在现有编辑器中打开选定的作业,并具有设置、历史记录和更改的常用权限。 Escape 会关闭会话悬停卡之前的弹出窗口。 Cmd/Ctrl-click 保留正常的新标签导航。 显示所有自动化“自动化”页面上的 清除会话过滤器。
里面的会话视图中,默认芯片模式围绕活动代理组织对话。铁轨顶部的身份就是那个特工。页面和用户有自己的导航视图,而不是显示在对话列表上方。会话列表分为多个区域:其他对于代理的未分组聊天会话(主会话由 Home 而不是普通会话行表示,包括当它被固定或具有子代理时;它生成的独立对话在此处显示为顶级线程,命名线程显示时不带类型前缀),团体用于小组和房间对话,以及编码对于绑定到托管工作树或执行节点的会话(行显示repo ⎇ branch线路加上节点主机),ACP-支持的harness会话和外部CLI目录。这其他当标题是唯一的部分时,标题被省略。编码在第一次运行时开始折叠并记住您的选择;它的折叠标题保留了真实计数,并在包含的会话工作时显示运行指示器。自定义组(会话category)位于“其他”之上,而个人引脚位于轨道中,并且将独立会话分配给自定义组会胜过自动区域分类。单个会话工具栏显示所有者过滤器标题,过滤和排序,以及**+这将打开“新会话”页面。里面过滤和排序**, 展示包含排序(当加载的会话名册包含多个所有者时创建、更新或所有者)以及分组依据 — 自定义组(上面的默认区域布局),项目通过存储库或工作区结帐来存储会话(没有会话的会话保留其区域),人当加载的名册有多个时,按所有者存储到存储桶,或者没有任何对于没有区域标题的单个平面列表。过滤器包含持久化的地位筛选“活动”、“延后”、“已存档”或“全部”。所有者排序模式按名称对所有者组进行排序,并保持每个组内的创建顺序。在多用户网关上,标题芯片选择所有业主、一名特定人士或智能体,或涉及我— 您拥有、已提示或已明确提及的会话,不包括您个人隐藏的会话隐藏不让我参与。新的明确提及会带回隐藏的会话。显示《让我参与》恢复它从所有业主。个人的Hide/Show仅当网关具有多个身份时才会出现菜单条目。这些个人选择不会存档会话或更改访问权限,并且网关会在分页之前评估过滤器(请参阅多用户模式)。归档行保持内联,并用归档字形变暗;他们不会贡献未读或关注状态,并且不参与血统提升。打开会话会移动选择突出显示,而不会对行重新排序。具有嵌套持久会话或分叉的父级会在右侧显示可见的披露和子级计数,以便您可以折叠或重新打开组,而无需离开侧边栏。新添加的子项会自动展开其父项;普通更新和重新排序可以保留您的手动崩溃。加载现有子项不会展开之前折叠的组。选择嵌套会话将打开其聊天并显示其祖先路径。如果持久会话在其与其最近的加载的非子代理祖先之间运行子代理,则它嵌套在该祖先之下。如果没有加载这样的祖先,它将保持其正常的顶级位置。嵌套行保留在根固定、多选和分页之外,直到升级为止。将一个孩子拖到移至顶层、会话列表或自定义组,或者选择移至顶层从它的菜单中。促销可以保留对话URL、脚本、工作空间、原始链接和活动执行关系;然后会话支持普通的根组织。如果以后删除该组,则将其移动到组中也可以保持其独立性。折叠区域不消耗可见页面预算。个人固定保持独立:首先提升一个子项,然后将其快捷方式添加到您的栏目中。即使选择或分配了自定义组,子代理运行也不会显示为侧边栏行,并且不会向没有嵌套持久会话的父级添加披露。通过他们的会话记录来检查他们。自上次读取以来具有新活动的会话会显示一个未读点,打开一个则将其标记为已读。接受的工作会立即在该行自己的图标周围显示一个活动环,用于表示主页、会话、子会话和目录行;没有图标的行显示图标槽中的紧凑环。子代理运行仍然会影响其祖先的运行、排队和失败计数、未读关注和失败警告。打开那个祖先,或者选择标记为已读在其上,还确认未读的子代理运行它总结的内容,即使祖先本身已被读取。失败的运行、运行上的手动未读标记以及读取后的运行活动保持未读状态;嵌套的持久会话保留自己的未读状态。当会话的子代理工作时,会话的环保持活动状态。当仅执行委派的工作时,环被标记为子代理工作。选择祖先的子失败警告以检查聊天中失败的运行,而无需添加侧边栏行。折叠的组和折叠的子切换总结了右侧隐藏的运行行。它在启动和执行期间旋转,暂停排队仅在调度程序确认的并发槽等待期间,并在授予槽时恢复。启用减少运动后,环保持静止。包含您键入但从未发送的作曲家文本的会话会显示铅笔徽章,直到草稿发送或清除为止;活动会话将其隐藏,因为其作曲家已在视图中。客服人员还可以发布简短的到期状态行,并可以选择使用精心设计的琥珀色图标来请求关注;当您打开会话、发送下一条消息、显式清除它或其TTL过期。云工作者生命周期状态使用地球徽章;本地和回收会话省略放置标记,因为本地执行是默认的。每个会话行提供一个直接的档案旁边的按钮别针;存档行报价恢复。存档仅影响该对话。当其父级被归档时,未归档的持久子级在顶层仍然可用。档案会话和儿童……会话菜单中收集可访问的嵌套对话,包括折叠的后代,并确认受影响的计数。排除升级或单独分组的对话以及已存档的分支。在确认之前会调用正在运行的工作。并发提升、分组或归档会拒绝该目标,而不是归档新的独立对话;报告部分故障,并且撤消仅恢复操作中成功的目标。右键单击一行,或聚焦其链接并按Shift+F10或菜单键,打开完整会话菜单。触摸布局使“固定”、“存档”和单独的菜单按钮保持可见,因此无需右键单击即可执行每个操作。聊天标题还提供会话菜单。聊天标题通过其特定于窗格的内容组成相同的单会话管理操作看法行动;面板和拆分控件位于标题中布局桌面上的菜单。手机聊天使用最右边面板图标代替,包括细节了解进度和会话信息;相邻的省略号保留会话管理操作。Cmd/Ctrl-click在新的浏览器选项卡中打开会话。Alt/Option-click将根行切换为多选,并按住 Shift 键单击将其扩展至可见顺序;打开选定行上的菜单,然后提供批处理操作(将 N 标记为unread/read、将 N 移动到组、存档 N、删除 N),适用于每个选定的会话,只需一次确认即可批量删除。将根会话拖到导轨中以将其固定,或拖到自定义组上以移动它。自定义组标题可以折叠、展开或拖动以重新排序;组名称、顺序和新会话默认值存在于网关中(sessions.groups.*),因此它们会跨浏览器跟随您,而折叠状态保留在浏览器配置文件中。每个自定义组标头都有一个**+这将打开正常的“新建会话”页面并将创建的会话分配给该组。当其他标头可见,其+**打开未分组的草稿,而不继承当前的命名组。新会话默认值在组菜单中设置其工作目录和本地或工作树首选项;该页面预填充了这些值,但使它们保持可编辑状态。将目录留空将使用所选代理的工作区。没有初始提交的 Git 存储库可以使用 Current checkout;创建工作树需要初始提交。菜单中还有重命名组、新建组、删除组;重命名或删除组会更新服务器端的每个成员会话,包括存档的会话,而删除组会保留其会话并将它们移回“其他”。
当较早的目录刷新完成较晚时,已确认的组重命名将保留新名称及其当前的新会话默认值。重叠的后台刷新无需重新连接即可完成加载最新的组目录。
持久子对话和分叉在轮次结束后保持嵌套状态,包括重新加载或网关重新启动后。归档将它们从 Active 列表中隐藏;恢复它们使它们回到父级之下。
选择代理切换器中的 显示全部 磁贴以进入 团队模式,该模式将每个可选代理显示为可折叠会话组。这将打开 Sessions 视图并展开侧边栏,即使已选择团队模式也是如此。默认情况下它是关闭的,浏览器会记住您的选择和每个代理的折叠状态。团体开始扩大。标题强调代理的头像和姓名。活动、注意力、未读和工作区指示器位于会话行的右侧;崩溃的父母总结了那里隐藏的工作和成果。代理标题在名称和控件下方的换行行中显示其指示符。即使父项和隐藏的子项共享该状态,一行也会显示每个状态一次。在两种侧边栏模式下,会话图标均位于标题左侧;状态指示器和操作位于右侧。嵌套子级每层缩进 16px,而不移动尾随指示器的右边缘。当活动发生变化时,组会保留配置的代理顺序。代理标题的最小高度为 48 像素,头像为 36 像素,并且可以增长以适应其元数据;会话行在桌面上保持在 32 像素的一行上。每个代理标题都是其主页条目:选择名称或头像将打开主对话并突出显示标题。即使固定后,主页也不会再次显示为会话行。标题在展开时显示主页活动、未读状态和关注度,并在折叠时总结该组的隐藏会话。它从不显示谁创建了主会话;代理头像是标头的唯一身份。从主页创建的独立对话在代理下方仍然可见。
当登录用户和会话名册识别出多个人时,会话行所有者头像会自动出现。由于只有一个人,即使代理拥有或参与会话,所有者的化身也会保持隐藏状态。代理参与者和未显示的参与者计数不会启用归因。会话图标、频道头像和活动指示器保持其通常的行为。
观察者评估(例如 stuck 或 waiting on user)会保留在其会话中,而不是在另一个对话上打开全局 toast。这不会更改明确的问题、批准请求、操作反馈(例如 Archive → Undo)或您在后台明确启动的会话的完成通知。
当您点击、悬停或通过键盘聚焦注意图标时,待处理的问题和批准会显示其具体请求。点击图标可使侧边栏保持打开状态;再次点击或按 Esc 键可关闭预览。工具提示包括最旧的问题、紧凑命令或批准标题,以及其他问题或批准的计数。这适用于常规列表、家庭和团队模式,包括折叠的父母和代理组。问题和批准优先于代理注意事项和失败的运行;具有相同优先级的请求首先显示最旧的。答复、批准、取消或过期会清除该请求并显示下一个请求。预览换行和截断,而不向会话行添加另一行。秘密问题仅显示问题文本,从未输入答案。
顶部导轨按钮成为中性工作区标识,在其工具提示和可访问标签中带有配置的网关显示名称或 OpenClaw,并用一个小的静态 OpenClaw 标记代替代理头像。两种模式使用相同的菜单。 显示全部磁贴对配置的客服人员自己的头像进行分组,并且仅在多个客服人员一起出现时才显示。在切换器下方,新代理和查看所有代理位于分隔符和活动代理的命名功能和设置操作之前。 查看所有智能体开通/agents;帮助保留在帐户菜单中。选择一个代理图块以离开团队模式并选择该代理。会话头保留owner-filter标题,Filter & sort,以及一个**+**控件;搜索和查看按钮保留在导轨中。
代理头像在整个仪表板中使用相同的优先级:身份图像(数据或同源 URL),然后是身份表情符号,然后是生成的面孔。特工 ID 的脸部是稳定的,包括在重命名之后,并且在侧边栏、切换器、新对话菜单、特工主页、身份芯片和聊天中使用清晰的矢量图形。经过身份验证加载后,配置的工作区图像也会出现在助理回复旁边。丢失或失败的图像会显示表情符号或生成的面孔。系统代理始终使用 OpenClaw 产品标记,包括在入门引导和托管对话中;他们从不使用生成的面孔。人们保留自己的个人资料图片和姓名缩写。
在两种侧边栏模式下,Home 都停留在栏的底部,而不是在页面中。单击群组标题的头像或名称即可打开该客服人员的主聊天室;其单独的 expand/collapse 控件无需导航即可折叠组。顶部的**+,标记为新对话**,打开一个小代理菜单,其中包含每个代理的头像和姓名,顺序与组相同。选择代理将打开 /new?agent=<id>。每个组的**+直接打开该链接。当标题悬停或包含键盘焦点时,它会出现,并在触摸设备上保持可用。关闭组队模式恢复芯片模式及其直接新对话**按钮;家仍然在铁轨上。
选择 显示全部 默认共享页面范围为 所有代理。选择指定的代理磁贴会离开团队模式并将页面范围分配给该代理。当模式更改时,这会设置默认值:您可以随后选择单个代理,页面导航会保留您的选择。自动化、仪表板、会话和使用情况支持所有代理视图。混合座席列表在需要时使用头像和名称来标识每一行上的座席。每个身份芯片在其工具提示和屏幕阅读器标签中都包含代理 ID,例如 Molty (agent:main),因此具有相同显示名称的代理仍然可以区分。如果没有可用名称,则标签使用 agent:<id>。在“设置”中,侧边栏标题下方的代理选择器在代理、模型、内存和技能中保持相同的目标;全局设置仍然是全局的。技能工坊使用通过聊天选择的代理。从组标题中打开客服人员的主聊天,将其选择用于技能研讨会。聊天操作仍然以对话代理为目标。
个人会话快捷方式在两种侧边栏模式下都保留在图标栏中,与保存的订单中的页面、仪表板和人员快捷方式混合在一起。当代理组崩溃时,它们仍然可用。轨道快捷方式是平面图标:固定父级不会将其子树移动或复制到轨道或页面中。每个代理组仍包含其普通会话,包括具有个人铁路快捷方式的会话、常用会话菜单、未读徽章、嵌套子会话、部分限制和 显示更多 控件。选择任何会话都会切换活动代理进行聊天,而轨道工作区按钮保持其中立身份。 Sessions 过滤器适用于所有智能体组。在栏目中选择单独的 Users 视图以查看谁在线。类别、人员和项目分组控制仍处于芯片模式;团队模式始终按代理进行分组,并使空代理组保持可见。打开的对话保留其选定的行,包括直接在默认 Active 过滤器下打开的存档对话。侧边栏标题中的过滤器按钮保留相同的会话过滤器。每个代理标头都有一个 新对话 操作和一个选项菜单,其中包含 打开主聊天、所有会话 和 折叠其他。 所有会话 打开“会话”页面并将共享代理筛选器设置为该代理。代理标头元数据使用换行第二行,保持名称和操作可读,并且指示器在悬停、键盘焦点和触摸时可见。当代理有其他会话或后代要显示时,会出现展开控件。会话行仅为当前指示器保留空间,因此安静的标题可以使用整个行宽度。
组与 Agents home 跨座席共享最多 300 个会话的窗口。这限制了为组加载的会话行,而不是保存的铁路快捷方式的数量;个人 PIN 码不会在该窗口中保留位置。开放的对话在此窗口之外仍然可见。 涉及我加载经过Gateway过滤的同一个有界窗口;其他过滤器适用于跨组加载的会话。
标题尚未加载的已保存会话快捷方式标记为 Open session。选择它即可按需查找该会话。缺少会话显示 Session not found;查找失败会要求您重试。
活动会话列表将网关生命周期行快照应用于现有成员,而无需重新加载整个列表。成员资格更改、行快照丢失或不完整以及网关拥有的过滤器仍然需要权威列表读取。自动花名册刷新会在随机的四到五秒窗口中收集事件,以后的事件无法推迟,从而在浏览器之间传播读取。自动刷新完成后,下一个刷新将等待其持续时间的三倍,时间范围为 5 到 15 秒。显式刷新、过滤器或代理更改、重新连接和前台替换可以绕过该延迟。
当浏览器选项卡隐藏时,活动刷新会暂停,并在您返回时刷新一次,遵守自动刷新延迟。在名册读取期间到达的更改共享一次后续刷新;切换过滤器永远不会组合来自不同过滤器的页面。
Users 列表打开人员的活动卡及其报告的设备、平台和连接类型:Web、App、Terminal TUI 或 命令行。重命名设备不会更改其连接类型。重复的设备和平台标签被合并。 ARM 等架构标签仅在显式报告时出现;浏览器的 MacIntel 值无法识别 Intel CPU,因为 Apple 芯片 Mac 和桌面模式 iPad 也会报告该值。
在 Mac 上使用 ⌘B 或在 Windows/Linux. 上使用 Ctrl+B 切换侧边栏使用 ⌘K 打开命令面板, ⌘P,或 ⌘Shift+P(Mac 上),或 Ctrl+K、Ctrl+P,或Windows/Linux. 上的 Ctrl+Shift+P 这些快捷键在键入时以及在嵌入式小部件内也可以使用; P 快捷键打开调色板而不是浏览器打印。 Mac Ctrl+B 和 Ctrl+K 仍可用于本机文本编辑。
搜索字段会立即更新,而命令过滤和会话搜索会等到您暂停键入 200 毫秒后更新。之前的结果在暂停期间保留在原处,但在应用新查询之前无法选择。按 Enter 键立即应用待处理的查询并选择可用的匹配结果。清除该字段会立即恢复默认命令。
在文本编写过程中,命令选项板会暂停搜索并将 Enter、Escape 和箭头键留给输入法。
在令牌或设备令牌身份验证之后,仅当浏览器显示验证先前连接的网关令牌或从该连接保留的配对设备令牌时,侧边栏才能在重新加载时显示其缓存的会话名册。缓存的名册没有实时运行状态,连接后将被实时列表替换。其他认证方式等待连接;请参阅 热重载 。
即使其他对话处于活动状态,切换代理也会刷新会话列表。另一个客服人员的会话操作完成后,所选客服人员的已过滤侧边栏和分页将保持活动状态。如果后续列表刷新失败,已确认的权限更改仍然可见。已知会话的读取确认会更新其提交的收据中的未读和关注状态,而无需重新加载名册。较旧的响应无法撤消已确认的读取状态;新的活动或稍后的手动未读标记仍然有效。
加载更多会话在侧边栏列表刷新或加载另一个页面时保持禁用状态。当读取完成并且剩余更多会话时,它再次可用。
较旧的列表响应会保留已加载到另一个打开的会话列表中的较新的会话名称和运行状态。
当扩展或选定的父级在会话列表刷新后获取更新的子数据时,加载的持久子会话行保持可见。子加载保留其他会话列表中已观察到的较新名称和运行状态。选定的子项也会在其详细信息到达后立即采用其刷新的名称和运行状态,包括在其祖先仍在加载时。当会话被替换或其父级更改(包括在过滤列表中)时,其祖先路径会刷新。折叠的、未选择的父级会在刷新时丢弃陈旧的子级快照,并在重新打开时重新加载;所选会话的祖先仍然可用。仅当父级尚未加载子行时才会出现加载占位符。子加载错误将保持可见,直到您选择 Retry 或折叠并重新打开父项。在 Active 中,已存档的子项停止为父项的子项计数做出贡献。已完成的子加载还会在重新加载后删除指向缺失子项的链接;已卸载或失败的子读取将保留其发现控制权。
Archived 会隐藏活动会话,即使对话保持打开状态也是如此。在Active中,直接打开的存档会话可以保留其选定的行。归档可见会话会立即隐藏其行,同时保持其对话打开。当网关确认请求时,重复归档操作保持禁用状态。确认提供 Undo,包括当您在存档完成之前离开“会话”页面或在通知保持可见的情况下导航离开存档的聊天时。撤消目标是原始对话,并在网关重新连接时过期。如果请求失败,该行将返回一条错误,解释阻止归档的原因。如果后续刷新失败,已确认的存档和恢复更改仍会应用于已加载的行。如果归档已经从每个加载的列表中删除了一行,则撤消需要成功刷新才能再次显示它。刷新错误单独显示;它不会撤消成功的存档或恢复。刷新会话列表以恢复丢失的行。
使用实时嵌套会话存档会话会从侧边栏、聊天标题或会话页面打开 存档会话?。选择 存档此会话 仅存档父级并将其嵌套会话移动到顶层,或选择 存档 N 个会话 通过撤消存档整个树。不包括已移至顶层或单独组的会话。当选择包含活动工作时,对话框会发出警告;没有嵌套会话的会话保留其现有的活动工作确认。
Snooze 在 Active 侧栏中隐藏符合条件的会话,直到其唤醒时间、直到您向其发送消息或直到代理在其上运行完成。会话保持活动状态:暂停不会停止运行、阻止消息或代理工具、禁用自动化或更改其工作树。保留会话可见状态的系统事件和运行不会唤醒它。 Snooze 由网关保存,因此连接的客户端共享相同的唤醒时间。
在状态过滤器中选择 Snoozed 以查找暂停的会话,或选择 All 以将它们与唤醒和存档的会话一起查看。延后的根行显示 Wakes 和本地唤醒时间。行菜单的 Wake session 项还显示预定时间;选择它可以提前恢复会话。暂停确认提供 Undo。暂停会话可以保留其个人捷径。添加或删除该快捷方式不会唤醒会话或更改其暂停时间。存档会清除其暂停状态。
对于紧凑的单行行,会话预览默认隐藏。启用 在Sessions过滤器菜单中显示消息预览 以恢复常规状态文本和消息预览。浏览器会记住您的选择。关闭预览后,错误和注意请求仍然可见。团队模式将所有会话行保留在一行上。右侧的三个紧凑槽显示孩子数、未读状态(一个点表示一个,一个计数表示更多)以及活动或注意力。输入和错误请求优先于状态槽中的活动;展开家长或小组来检查每个对话。折叠的代理组使用相同的插槽。嵌套扩展控件是右侧现有指示器旁边的持久插入符。
H在同一菜单中隐藏空组会显示您当前的选择并打开三个选项:
- 过滤时(默认):当选择特定所有者或涉及我时,隐藏没有匹配会话的本机会话部分。
- Always:还隐藏未过滤视图中的空本机部分。
- Never:过滤时保持空组可用。会话仍然遵循活动过滤器。
这是个人显示首选项,针对每个登录用户和网关单独存储在此浏览器中。它不会更改其他人的视图、组成员身份、顺序或会话访问权限,并且不会跨设备同步。没有识别用户的连接保留单独的仅浏览器选择。现有的 on/off 浏览器选择被第一个解析的查看器采用一次:on 变为 Always,而 off 变为 当过滤时。后来的观看者不会继承迁移后的选择。
更改或清除所有者或状态过滤器不会更改已保存的首选项。当空组控件可见时,弹出窗口中的 Reset 恢复 过滤时。即使折叠时,已填充的组仍保持可见,并且隐藏的自定义组在 移动到组 中仍然可用。选择 Never 将其标头恢复为拖动目标。团队模式下的目录部分和空代理组保留其现有行为。在手机宽度布局上,选项将作为过滤表内的页面打开,其中包含 Back。 Escape 将焦点返回到设置而不关闭过滤器面板。
本国的CLI仅当目录包含与当前所有者过滤器匹配的会话时,目录才会出现。即使发现失败或CLI可以开始新的会话。连接时加载目录。当网关通告目录更改事件时,目录会通过有节奏的突发和十分钟的安全刷新来刷新这些事件。否则,可见选项卡每隔刷新一次目录30秒。返回隐藏选项卡也会刷新其目录。如果还有更多页面,发现将跟随其光标,直到出现匹配的会话、目录耗尽或主机报告错误,而不重复首页请求。当浏览器选项卡隐藏时,Discovery 会保留其进度并暂停。稍后刷新会检查第一页是否有新会话,并重新启动已完成的空扫描,以便仍然可以发现可见的旧会话。扩展目录在刷新时保留其加载的页面。当另一台主机发生故障时,填充的目录仍然可见,并在其状态指示器中显示发现详细信息。隐藏目录不保留其他当标题是唯一剩余的部分时可见。本国的CLI开始时间仍然可用新会话。
标记为未读 创建一个提醒,该提醒在当前聊天保持打开状态(包括跑步流式传输或完成时)时保持未读状态。离开并重新打开会话,或选择 标记为 read,以清除它。
以查看者身份打开会话会保留其未读标记,包括共享会话。草稿会话仅确认其所有者或管理员自动读取。如果网关因会话状态无效或缺少访问而拒绝自动读取确认,则 UI 会针对该未读剧集报告一次错误,并等待新剧集或您重新打开会话。暂时失败可以在稍后的会话更新时重试。手动未读提醒仍然保留,直到您重新打开会话或选择 标记为已读。
Delete 立即从加载的会话列表中删除已确认的选择,并保留任何打开的已删除对话。网关在后台完成删除,首先安全地停止并回收附加的云工作线程。如果删除失败,受影响的会话可能会重新出现并出现错误;其他成功的删除以及您在此期间进行的任何导航都会保留。浏览器草稿仅在确认删除后才会停用,而不是在请求挂起时停用。内存中的草稿交接在确认后立即停用。在存储清理期间切换网关会保留其他网关的草稿和排队消息。如果在存储清理开始之前连接或登录所有者发生更改,或者恢复准备时间超过十秒,则存储的草稿保持不变,并且 UI 报告清理失败。
删除嵌套会话使剩余的子列表在请求挂起时可用。通过挂起删除隐藏的会话不会使原本完整的子列表变得不完整。如果网关在有限重试后无法返回完整的子列表,侧边栏仍会显示列表错误并提供 Retry。
在“会话”页面上,复选框选择在加载列表中分页后仍然存在。当列表刷新时,已消失、离开当前过滤器或被替换的会话将被取消选择。替换者永远不会继承旧会话的选择。批量删除仍然与您选择的会话绑定,包括在其确认对话框打开时。如果您在之前的删除尚未完成时选择了替换项,则其较晚的确认会保留您的新选择和替换项的详细信息。它不会将当前对话从替换对话中切换出来。同样,延迟重命名、存档或恢复确认只会清除原始会话的复选框,同时保留您选择的替换项。
侧边栏、聊天标题和会话页面中的 Rename 以您的自定义名称或生成的仪表板标题开头。编辑文本,然后保存或按 Enter 键。保存未更改的生成标题可使自动命名保持不变;清除自定义名称将恢复生成的标题。频道和帐户装饰位于可编辑名称之外。重命名目标是您开始编辑的会话。如果在保存之前删除了该会话并以相同的键重新创建,则编辑将被拒绝,而不是重命名替换。重新打开当前会话的重命名以重试。重置对话会保留相同的会话标识,并且不会使编辑无效。
自动标题遵循第一条消息的语言,包括带引号文字的简短说明。标题的长度上限为 60 个字符,截断后不匹配的引号将被删除。空或仅引用模型输出使用可读的甲壳类主题后备名称。
侧边栏、聊天标题或会话页面中的新组 在对话框打开且保存组时保留原始会话选择。已删除或替换的会话不会被移动;将显示错误,但新组仍然可用。对于侧边栏多项选择,即使另一个目标失败,仍然存在的会话也可以移动。将选定会话调出可见列表不会取消其移动。
您保存的自定义名称始终优先于自动标题,即使它类似于 Android 设备标签(例如 OpenClaw App · Phone · abc123)。保存为自定义名称的旧设备标签将保持该优先级,直到您明确清除或替换它们。新的 Android 设备标签单独存储,因此生成的对话标题可以替换设备标签,而无需更改您的自定义名称。
会话菜单
可以固定根会话和普通的主页链接仪表板会话。生成的会话和嵌套子会话拒绝 pin 请求,包括当它们显示为顶级线程时。子代理运行还会拒绝 pin 请求并保留在侧边栏导航之外。
普通对话的 Actions 菜单还提供 Move to group,即使其标题链接回 Home。该面包屑不会使对话成为嵌套子项。
固定的父级是单轨快捷方式。其缩进子树和 expand/collapse 控件保留在会话列表中,受当前过滤器的影响。
根菜单将日常操作集中在一起:Pin/Unpin、重命名、标记为unread/read、复制链接、分配给…、移动到组和Archive/Restore。仅当符合条件的目录包含不止一个人或智能体(包括您自己)时,才会出现分配;在线状态并不决定资格。侧边栏在存档旁边还提供 Snooze/Wake 会话。与儿童的会话有一个 存档会话 子菜单,仅包含 会话 和 存档会话和儿童…;后者仍然证实了受影响的对话。
高级包含图标和颜色、叉对话、复制详细信息、打开在、发送消息和接收消息首选项中,以及底部删除。仅当从 Involving me 列表中打开菜单时,Involving me中的个人Hide/Show 才会突出;在其他地方,它停留在高级状态,受相同的多用户可用性的影响。在手机上,子菜单会替换当前菜单页面,并且 Back 返回其父菜单。
- 在侧边栏会话菜单中,Snooze提供在1小时内,在3小时内,这个晚上(当地时间18:00,当距离超过一小时时)、明天(当地时间09:00)和下周(当地时间下周一09:00)。在星期日,下周被省略,因为它与明天匹配。每个预设都会显示您所在区域的唤醒时间。可以暂停符合固定条件的活动会话,受保护的主会话和哨兵会话除外;存档和嵌套子会话不能。移至顶层的孩子可以小睡一下。暂停的会话提供 唤醒会话。
- 图标和颜色 打开一个带有色样、图标网格的选取器,并将 重置为默认值。当您更改两者时,它会保持打开状态;侧边栏反映了您的更改。
- 移至组包括新组和从组中删除。当有多个合格所有者可用时,分配给 保留在根菜单上( 会话所有权)。
- Fork对话创建一个单独的对话;当运行处于活动状态时,它会从最后完成的消息中分叉。本地文件夹和项目会话的分支保留该工作区,因此现有文件引用将继续打开。 从这里分叉也保留相同的本地工作空间。
- 复制链接 一步复制会话链接。 高级 → 复制详细信息 提供预览链接、对话文本 Markdown 和会话 ID,无需复制公共会话链接。该链路需要正常的网关认证和会话访问;复制它并不授予访问权限。 Markdown 加载可用的对话历史记录,而不仅仅是当前可见的消息。复制的 Markdown 和
/export下载都保留了对话的发件人标签,因此来自不同参与者的消息仍然可以区分。没有可导出文本的记录(例如没有文本输出的工具调用)将被忽略。 - 中的Control UI、
/export和/export-session通过浏览器下载Markdown,不带文件路径。争论使草稿保持完整并显示如何重试。通过其他客户端可用的服务器端 HTML 导出保持其单独的工作空间路径行为。 - 聊天标头的 会话共享 控件管理经过身份验证的队友可见性和成员身份。对于已保存的非隐身会话,其创建者或网关管理员还可以启用全球可读的只读公共访问。
- 在中打开提供新的浏览器选项卡或窗口。桌面聊天还提供拆分右和拆分如下。当同一对话在多个拆分中打开时,每个窗格都会在页面重新加载后恢复其记录,并在另一个窗格进一步领先时独立地赶上。升级后,在恢复增量更新之前,会从网关刷新旧的缓存记录。合格的本地工作区公开本机编辑器目标,并且聊天标头包括此子菜单中的 Continue interminal。
如果“会话”页面上的所有者分配失败,该页面将保留会话并显示网关的错误。解决报告的问题,然后重新将 分配给 重试。先前连接的延迟失败不会替换当前页面的状态。 Assign to 菜单标记会话的当前所有者并禁用该选择,包括在团队目录正在加载或不可用时。
公开分享会话
- 打开保存的会话并在聊天标题中选择会话共享。在紧凑标题菜单中,选择 Sessionsharing 。
- 在公共访问下,选择启用公共访问…,查看警告,然后选择公开。
- 选择复制公共链接复制普通线程URL。聊天标题中的 Public 徽章在发布记录时保持可见,并在另一个窗口更改公共访问时更新。
- 在注销的浏览器中打开相同的 URL 以验证只读对话和 登录 按钮。登录将返回到具有您现有权限的线程。新的用户消息和助理最终答案将自动对公众读者可见。
- 返回会话共享并选择禁用公共访问以停止匿名读取。然后,同一 URL 将不可用页面返回给已注销的读者。再次启用访问使 URL 再次公开;禁用访问无法调用已保存的副本。
公共页面不包括工具、推理、文件、图像、小部件、隐藏消息和内部元数据。包含的文本未经过秘密屏蔽,因此在发布之前请检查对话中的凭据和其他敏感内容。公共访问不允许访问者发送消息或授予经过身份验证的 Control UI 权限。有关链接生命周期、分页、备份行为和登录代理配置,请参阅 公共会话记录 。
会话放置
将云会话悬停在侧边栏中可查看其提供商和配置文件。已知后,它们下面的紧凑行会显示 GB 中的操作系统、机器类别、vCPU 数量和内存。放置徽章工具提示包含相同的机器详细信息;不可用的字段被省略。
在工作线程上运行的选定会话会在聊天标题中显示 Cloud芯片上安静的Runs。与 operator.write 的连接可以选择 Move 会话… 在网关或符合条件的配对设备上继续,并且可以通过写入范围的 sessions.reclaim 生命周期使用 Stop 云工作线程…。迁移到已配置的云配置文件需要 operator.admin。云行会根据每个配置文件公布的所有执行模式进行过滤:OpenClaw worker-turn 和 Codex remote-exec 可以选择相同的捆绑 Crabbox 配置文件,而真正的单模式配置文件对于其他运行时保持禁用状态。具有多个机器类别的配置文件显示机器选择器。保持移动会话选择器不变会忽略尺寸覆盖;显式选择一个类(包括显示的默认值)会发送该类。在当前配置文件上选择不同的类会调整会话的大小。确认信息解释了当前回合被中断并且永远不会重播; OpenClaw 在激活目标之前协调工作区。当持久操作正在进行时,芯片显示 Moving to…。如果恢复被阻止,芯片会在重新连接后暴露有限错误,因此操作永远不会默默失败。
您可以在现有工作会话正在配置或准备其工作区时发送消息。接受的消息显示 已接收 · 正在等待工作程序设置 并在该工作程序准备就绪后自动启动。停止、移动和重新启动保留自己的准入控制;取消或中断的输入不会在不同的目标上静默启动。新会话流程中未发送的草稿仍然与已接受的输入分开。
在初始切换期间,聊天放置菜单和停止确认使用选定的目标:Stop 设备工作人员... 用于显式或自动配对设备放置,Stop 云工作人员... 用于云配置文件,或中性 **Stop 工作人员...**目标未知;全部使用sessions.reclaim。启动失败后保留重试的目标不会标记稍后重新启动。
会话图标
从单个会话的上下文菜单中选择 高级 → 图标和颜色,为其侧边栏行提供持久的表情符号、单色图标或自定义 SVG。该选择器包括常见的表情符号和六个命名图标:braces、book、monitor、bot、kanban 和 coins。选择 自定义图标... 输入单个表情符号,粘贴 SVG 标记,或粘贴 SVG 数据 URL(百分比编码或 base64)。 SVG 必须是独立的,并且最多可解码 16 个 KiB;脚本、嵌入文档和外部引用将被拒绝。包括 xmlns="http://www.w3.org/2000/svg" 和 viewBox。自定义 SVG 渲染为图像,保留其自己的颜色。对于表情符号,请按 macOS 上的 Control-Command-Space 或 Windows 上的 Windows-period 打开系统选择器。 sessions 代理工具可以设置相同的 icon 字段。空值会将其删除。此装饰取代了前导字形槽中的所有者头像,但临时注意状态始终优先,因此无法隐藏操作员请求。
通过 Person 分组,打开所有者筛选器标题以显示一位所有者,包括您自己。选择 所有所有者 仅清除所有者过滤器。标题显示当前所有者或涉及我选择; Filter & sort 保留状态过滤器和 Reset 操作,用于恢复所有可见面板设置而不更改所有者。
会话颜色
从会话菜单中选择 高级 → 图标和颜色,然后选择色样以添加柔和的全行色调、窄色带以及聊天标题旁边的匹配点。侧边栏标题和元数据在浅色和深色模式下保持中性和可读性。固定的行使用相同的色调;开放对话保持明显的中性填充和更强的标题,而多选行使用选择填充而不是会话色调。选择八种颜色之一,或选择 Default 仅清除颜色。 重置为默认值 清除图标和颜色。颜色与 Claude Code 的 /color 名称相匹配,因此导入的 Claude Code 会话保持相同的颜色。导入的目录行显示其颜色,但不提供颜色编辑。
Direct 会话快捷方式
- Mac 上的 ⌘⇧O 或 Windows/Linux 上的 Ctrl+Shift+O 打开 New Session 并聚焦其编辑器。它会打开草稿,而不创建空会话或发送消息。 ⌘N / Ctrl+N 仍为 新窗口。
- Mac 上的 ⌘⇧A 或 Windows/Linux 上的 Ctrl+Shift+A 仅针对当前聊天窗格请求 Archive,不适用于所选的其他会话在侧边栏中。它使用与聊天标题菜单相同的权限、受保护会话检查、存档生命周期和 Undo。存档的对话保持打开状态;这不是单独的停止或删除操作。
这两个快捷键都可以在聊天编辑器中使用,忽略按键重复和文本合成,并保持打开的模式对话框处于控制状态。键盘快捷键帮助对话框是新会话的例外:快捷键会在打开并聚焦草稿之前关闭帮助。再次按 ⌘/ 或 Ctrl+/ 可关闭帮助而不导航。当帮助打开时,存档仍处于锁定状态。新会话通过正常导航保留现有对话的草稿。存档不会清除该草稿或导航到另一个对话。
浏览器快捷方式处理可能因浏览器版本和配置而异。如果您的浏览器本身处理和弦,请使用当前聊天标题菜单中相应的“新建会话”控件或 Archive。当菜单打开时,菜单的 A 快捷方式仍然有效。
在 macOS 应用程序中,当仪表板 Web 视图具有键盘焦点时,将应用这些附加快捷键。单独的本机阅读窗格不会将存档转发到仪表板或其他窗口。现有的本机 ⌘N 新网关窗口和 ⌘⇧N 新线程命令保持不变。
这些直接快捷键不会更改命令选项板的 ⌘K / Ctrl+K,然后是 ⌘Enter / Ctrl+Enter 在后台启动任务的工作流程。
命令调色板
命令选项板可以启动独立任务,而无需离开当前对话或设置页面。照常搜索会话、设置和命令,或在同一字段中编写提示。多行文本或 60 个或更多字符的提示会暂停调色板搜索并轻轻隐藏搜索选项卡、结果和提示。输入保持固定到位。当文本为单行且缩短至 50 个字符或更少或已清除时,搜索将返回。在 51 到 59 个字符之间,调色板保持其当前模式以避免编辑时闪烁。计数不包括前导和尾随空格。会话创建错误和恢复操作在任一模式下仍然可见。
粘贴的图像在文本下方显示为可移动的小缩略图。粘贴或删除它们会保留输入、New session 操作和设置控制;调色板向下生长。图像可以单独启动会话或伴随文本。调色板中没有附件选择器。
输入 @ 可按姓名或经过验证的 GitHub 句柄搜索符合条件的人员,就像在聊天编辑器中一样。使用**↑/↓或Home/End**,然后输入或Tab选择人员; Escape 在调色板之前关闭人物选择器。紧凑的将通知行每行显示一次选定的人员,当空间紧张时使用**+N**。您最多可以选择十个提及参考文献。编辑或删除选定的名称会删除该引用; 删除提及 清除所有收件人选择而不删除文本。粘贴的姓名和电子邮件地址仍然是普通文本。选择器在打开时会替换搜索结果,并且选定的提及会将调色板保持在编辑器模式。在新会话的第一条消息中提及旅行;他们从不共享会话、邀请他人或授予访问权限。
- Enter 在人物选择器打开时选择一个人;否则,它将打开或运行选定的搜索结果。如果没有结果,则 Enter 不发送。
- Shift+Enter 添加一行。该字段向下增长到三行,然后滚动而不移动调色板或其右上角的控件。
- 命令+输入 on macOS or Ctrl+Enter on Windows/Linux在后台启动一个新会话。您还可以选择新会话在输入旁边。
选择已安装的插件搜索结果将打开该插件的概述,包括禁用的插件。带有目录条目的已卸载插件会直接打开其目录页面。搜索结果会显示可用的插件图稿。 Plugins 导航命令可打开目录中心。
打开输入旁边的 新会话设置 以选择代理、工作区和计算机,或者是否使用新的工作树。这些控件重用完整新会话页面的权限和 device/cloud 可用性规则。模型、附件和可见性控件保留在该页面上。
调色板以您通常的默认设置开始。打开 记住设置 以重复使用 Cmd/Ctrl+K 的不同选择,而不更改这些默认值。清除该复选框会立即恢复您通常的选择,并使提示保持不变。一次性选择不会在下一次调色板会话中被记住。
接受的创建将关闭调色板并提供 打开会话 而不更改前景视图或其草稿。仅当原始网关和帐户保持选中状态时,创建和完成通知才能打开会话;重新连接到同一帐户可使操作保持可用。失败的提交会保留提示、选定的提及、图像和有错误的选择。这些设置不会影响从搜索打开的会话,并且现有对话编辑器保留其自己的发送和 steer/queue 快捷方式。长提示在会话创建时保持不变,并且永远不会作为搜索查询发送。
新会话页面
新建会话 + 控件是链接:单击以在当前浏览器选项卡中打开草稿,按住 Command 键单击(macOS)或按住 Ctrl 键单击(Windows/Linux)以打开另一个选项卡,或者右键单击浏览器的 在新建中打开链接Tab/Window 菜单。中键单击也有效。组和目录部分上较小的加号控件将其目标保留在新选项卡中;您当前的对话保持开放。
侧边栏的 + 中的 Sessions 工具栏会在 /new 处打开整页草稿:在发送第一条消息之前不会创建任何内容。单独的目标和项目控件选择会话运行的位置以及它使用的项目或文件夹。与operator.write的连接可以选择Local(网关主机)、Auto(最不繁忙的设备)或environments.list返回的任何配对设备;管理员还可以查看配置的云配置文件,并且在没有连接设备时,连接设备。当其公布的执行模式包括所选运行时时,云配置文件是可选的,因此 Cloud 部分中的一个 Crabbox 配置文件行同时支持 OpenClaw 和 Codex。对于消耗工作线程槽的运行时,自动选择首先优先选择相对于工作线程容量而言承认工作较少的合格主机,然后在考虑待处理调度后比较空闲槽位,并按设备 ID 中断剩余关系。不消耗工作插槽的运行时使用设备 ID 顺序。设备资格对环境目录和所选运行时仍然具有权威性: OpenClaw worker-turn 需要一台可用的当前会话主机,该主机具有有效的工作线程容量和至少一个空闲插槽; Codex remote-exec 需要其当前可调用的、显式授权的 exec-server 命令,并且不占用工作槽。当该命令不可用时,选择器会区分未声明它的节点、等待配对批准的声明以及被网关命令策略阻止的声明。离线的已知主机、已连接的非主机、不兼容或饱和的主机、缺少所需功能的主机、过时的主机和不可用的主机仍然可见,并附有原因和下一步。
目标选择器打开,并以 搜索环境 为重点。其紧凑的单行结果分组在 Local、Your devices 和 Cloud 下。仅环境列表滚动。本地使用网关的名称(如果可用),并带有房屋图标;它意味着网关主机,不一定是运行浏览器的计算机。名为 MacBook、Mac mini 或 Mac Studio 的联网 Mac 使用匹配的硬件轮廓;未知设备使用监视器。 macOS 应用程序外壳为这三种形状提供本机 SF 符号;其他客户保留网络轮廓。这是显示名称提示,而不是硬件检测,并且永远不会更改放置资格。搜索匹配目标名称、类型、ID 和设备事实,包括功能和不可用原因。可用设备出现在不可用设备之前。悬停或键盘焦点可显示设备详细信息和可用容量;被阻止的设备会解释其原因和下一步,而离线设备则在没有详细信息卡的情况下保持静音。
Auto 是 Your devices 下的第一个可选行,当已知多个设备时显示。其信息图标解释了如何选择设备。选择本地、设备或云配置文件会关闭“自动”。当没有已知设备时,管理员会在该部分看到 连接设备。关闭并重新打开选择器会清除其搜索。
将鼠标悬停在可配置的云配置文件上或将焦点放在其行上以打开其操作系统和计算机选项。不可用的操作系统被省略。在选择配置文件之前,虚线轮廓标识默认值;选择任何选项都会选择该配置文件并激活其他设置的默认值。选定的配置文件将其操作系统和计算机显示为菜单中其名称旁边的静音文本。关闭的选择器仅保留配置文件名称。选项使用等宽图块,最多四列,长目录可滚动。
托管工作区 列出了网关模型目录公布的提供商管理的环境,包括 OpenAI(代理 API)(配置后)。选择其中之一即同时选择其符合条件的模型和运行时间;模型选择器和环境选择器显示相同的选择。托管工作区不会挂载或克隆本地文件夹、项目或工作树。当选择托管执行时,这些控件将被隐藏,并且在切换回来时它们的草稿选择仍然可用。使用文件的聊天附件。不可用的选项解释了它们的设置要求;代理 API 需要 OpenAI API 密钥,而不是 ChatGPT 订阅。请参阅 代理 API 设置 。
该文件夹默认为代理工作区。写范围连接可以浏览、恢复最近的网关文件夹,并在配置的代理工作区中的任何位置启动会话;另一种绝对网关路径需要operator.admin,但可以直接运行,无需Git checkout。本地放置保留可选的 Worktree 控件,并带有由 worktrees.branches(无提取)支持的基本分支选择器和可选的工作树名称(分支变为 openclaw/<name>)。选择带有所选网关文件夹的设备或云配置文件会使用托管工作树。选择 GitHub 存储库后,Remote checkout 会将其 URL 和可选引用直接发送到运行器,而无需创建网关签出。
将 From 留空以在创建工作树时获取 origin 并使用其默认分支。占位符是一个建议,而不是保存的分支选择。显式选择或保存的分支和提交按输入方式使用,无需提取;选择本地 main 使用该本地分支,该分支可能落后于 origin/main。如果获取或解析远程默认值失败,网关将回退到源签出的 HEAD。
开始本机编码 CLI
+ 旁边的 Codex 或 Claude Code 打开本机 CLI 草稿,而不是OpenClaw 聊天。选择计算机和文件夹,可以选择输入第一个提示,然后在终端中按 Start 或 Enter(或您配置的提交快捷方式)。终端以键盘焦点打开。 CLI 使用该机器的本机帐户、模型和配置; OpenClaw 不会转换模型或身份验证设置,也不会自动采用本机会话。本机草稿文本不会发送到 OpenClaw 以进行自动标题准备。普通 New Chat 和显式目录延续保持独立的流程。
本机启动需要 operator.admin、gateway.cliAgents.enabled、启用的目录插件及其安装的 CLI。终端默认开启; gateway.terminal.enabled: false 阻止本机启动。无需匹配 OpenClaw 模型路线。每台机器都有一个启动目标。仅当有选择或先前选择的机器不可用时,才会出现 Where 选择器。它列出了网关的本机 CLI 和连接的节点以及当前可调用的确切的全新启动命令;仅恢复节点不符合条件。网关重新连接以及节点连接或功能更改后可用性会更新。安装CLI后,重新连接网关;批准节点功能更改后,重新连接该节点。
新的网关本地 Codex 会话使用为其目录配置的主要本机 Codex 配置文件,通常是网关用户的 CODEX_HOME 或 ~/.codex。选择一个文件夹可以让 Codex 加载该项目的可信配置;它不会选择其他帐户或 Codex 主目录。其他 Codex 家庭仍然可以使用其原始配置文件浏览和恢复现有会话。 OpenClaw 代理的临时应用程序服务器登录与本机 CLI 登录是分开的。
在网关上,folder/worktree 控件仍会在启动前配置选定的托管工作树。在节点上,输入该节点上现有的绝对目录;如果需要的话,首先在那里创建一个工作树。本机启动不使用 OpenClaw 工作器放置、cloud/Auto 选择、附件提交、模型控制或隐身模式。在终端中添加文件并更改本机 CLI 设置。丢失目录、禁用功能或断开主机会产生错误; OpenClaw 从不启动聊天或替换另一个主机或主目录。如果CLI在启动过程中退出,终端将保留其输出和退出状态。如果启动被拒绝,草稿仍可进行更正并重试。
OpenClaw 聊天工作区启动
在 OpenClaw 聊天发送中,当网关创建或采用会话时,提交的文本和附件会立即显示,并带有 Starting 指示符。这是待提交的提交,而不是网关确认。如果创建被拒绝,您的提示和附件仍然可以纠正并重试。创建成功后,UI 将打开会话的聊天。如果导航失败,则提交的消息通过 Open session 操作保持可见,该操作会重试导航,而无需再次创建或发送。后台启动会在下一个草稿上方保留相同的可见确认,并带有指向所创建会话的链接。
如果模型目录仍在加载,会话创建将在共享的 20 秒目录截止时间后停止等待,并报告会话尚未创建。稍后重试;您的草稿仍然可用。关闭请求连接或失去其权限也会结束挂起的目录等待。
启动建议的任务会立即删除其卡片,而无需切换会话或更改草稿。确认后该卡将保持隐藏状态。如果会话创建失败或接受被中断或未经确认,该卡将重新出现,并附有其原始说明和恢复控件。 Retry 检查相同的任务并保留所选的启动模式。确认的重试会清除该任务之前的错误横幅,但不会清除较新的或不相关的聊天错误。技能研讨会修订版在加载历史记录时将其提交的指令带入聊天中。
归因提交会立即显示您的头像,位置与聊天记录相同。打开创建的会话,作曲家安静地集中注意力;注意提示是为预填写草稿的导航保留的。
项目选择器会在登录、重新连接和网关配置更改后刷新。远程存储库选项保留在登录者的网关范围首选项中,并从共享浏览器中排除 fallback/migration. 从先前的 GitHub 主机保存的远程存储库将被丢弃;新会话使用当前配置的存储库或代理工作区。网关重新连接和 Git 验证重试会保留您编辑的基本分支和工作树名称。选择另一个文件夹或项目会清除这些存储库特定的详细信息。
对于本地工作树会话,在命名、签出和设置完成之前发送第一条消息将打开已承认的会话。聊天显示提交的消息和准备阶段。命名完成后,生成的标题将立即保存,与结帐和设置无关。设置失败在该会话中仍然可见;纠正问题后发送重试。重试将重新使用已保存的标题。如果命名本身失败,则另一次尝试将使用原始的第一个提示,包括文本附件。在设置过程中停止会取消准备,而不启动代理。引导活动运行可使其进度可见,并且延迟的历史记录无法替换较新的启动阶段或在活动开始后恢复启动标签。
对于设备和云会话,一旦创建会话,提交的提示也会启动后台命名。当工作人员仍在配置时,侧边栏可以显示其主题;第一个任务轮次等待,直到放置准备就绪。准备好的标题或自定义会话名称保持优先。隐身会话会跳过这个早期命名步骤。
对于远程目标,Control UI 创建具有空初始消息且没有 execNode 的存储库或托管工作树会话,通过精确的 deviceId、autoDevice: true 或 profileId(加上可选的云计算机类)分派它,等待主动放置,然后使用与恢复以防止重复发送。显式自动设备调度需要operator.write;云配置文件调度需要 operator.admin。作曲家页脚选择新会话的模型和推理级别。
Model 和 Effort 是桌面和移动设备上聊天和新会话中单独的相邻作曲家控件。模型选择器从不包含“Effort”或“Fast”模式控件。长模型标签呈椭圆形,为其他控件留出空间;全名保留在打开的选取器和可访问标签中。狭窄的编辑器(包括较宽窗口中的分割窗格)使用紧凑的控件,因此每个选择器都可以独立单击。 Effort 在这些布局中使用仪表,其指针反映当前级别,当快速模式处于活动状态时,带有闪电徽章。在聊天中,快速模式保留在“努力”菜单中,或者在推理不可用时显示为相邻控件。没有可用控制的模型会忽略它。
模型选择器最初打开时,所选模型的提供程序部分展开,其他提供程序部分折叠。关闭并重新打开同一个选择器会保留您的提供商扩展选项并清除搜索。重新加载页面会再次初始化所选模型中的提供程序部分。按模型名称、模型 ID、提供商或 provider/model 参考搜索模型选择器。当模型目录刷新时,您的搜索将保持应用状态。按 Escape 清除非空搜索,同时保持选择器打开;再次按下它可关闭选择器并将焦点返回到其触发器。
当您切换会话时,Composer 会保持会话的已知模型名称可见,同时刷新该会话可用的模型选项。如果模型尚不清楚,控件将显示加载占位符。锁定的聊天还会显示所选模型,或 会话模型(当未知时)。该锁可防止模型选择发生变化;它并不表明本机运行时拥有该模型。
创建会话后,聊天将立即打开。远程启动使用与 GitHub 工作区准备相同的脚本进度指示器和已用计时器,显示配置、工作区准备、启动和第一条消息传递。编辑器保持可编辑状态,当第一条消息未解析时,普通后续消息可以进入本地队列。他们的交付会等到初始消息得到解决。正常启动不会出现错误。启动失败在会话中仍然可见,当恢复可用时,会显示 Retry。
如果页面重新加载后无法加载启动恢复,则会话会在会话切换时保持加载错误和 Retry 可用。切换会话不会重新启动恢复或重置其已用时间。保存的第一条消息继续阻塞排队的后续消息的传递,直到恢复加载并确认其传递状态。虽然此页面具有响应能力并且未保存的启动等待恢复代码,但自动应用内重新加载将被阻止,并且 Retry 会被警告替换。这包括隐身启动和无法保存恢复的暂停启动。应用程序其他地方的重新加载控件解释了相同的限制。选择 放弃未保存的开始并重新加载 以恢复保存的开始并放弃未保存的开始。其他被阻止的重新加载控件显示的警告中也可以执行相同的操作。这种保护仅限于开放的、响应式的页面;关闭它或浏览器管理的导航仍然可以丢弃未保存的输入。隐身输入永远不会保存到浏览器存储中。
如果在发送第一条消息之前远程启动失败,聊天将在同一浏览器选项卡和网关凭据范围中保留提交的文本、附件、选定的目标和有限错误。重新加载会显示暂停的提交,而无需配置其他工作人员。 Retry 保留存储库 URL/ref 或网关工作树选择,并使用已创建的会话和原始配置文件以及机器类别、设备或自动选择;它在发送之前等待活动放置。该会话保留其模型和推理设置,包括您在该会话中所做的任何后续更改。此选项卡本地启动恢复使用选项卡的现有会话存储生命周期,与下面的普通浏览器草稿限制分开。隐身启动恢复仅保留在内存中。普通的重新连接使已提交的提示保持可见,并使用 Reconnecting。 重试和检查交付等待就绪连接。更改网关、凭据或经过身份验证的所有者将清除私人演示。断开连接时,普通后续消息可以进入本地队列。在重新连接后的简短帐户恢复检查期间,提交的输入保留在编辑器中。检查完成后,队列准入将恢复,但传递仍会等待,直到初始消息得到解决。
如果网关明确拒绝第一次发送,则 Retry 在同一会话和目标上创建新的发送尝试。如果传递不确定,Check传递会查找原始用户消息或显示输入被保留或消耗的确切网关收据。它永远不会重新发送提示、提供工作人员或将丢失的历史记录视为交付失败的证据。匹配的收据会清除浏览器启动保留,但并不意味着运行已完成。提示保持可见,直到聊天收到相应的网关拥有的输入或转录消息,然后切换到该权威副本而不重复。保留的输入保持其网关拥有的状态,包括中断或取消的输入。如果没有收据,提示和附件仍然可以访问,并且排队的后续操作仍然保留。您可以继续起草或排队普通消息。检查对话,或者如果您选择开始单独的尝试,则复制保留的提示。此恢复不保证在网关重新启动时进行一次性交付。如果浏览器存储拒绝恢复更新,请保持当前页面打开以保留其内存中输入。
当中断的远程放置草稿需要删除时,清理会通过会话密钥回收放置,使用预期的会话标识对其进行存档,然后使用写入范围的仅存档删除协定。清理错误仍然可见。如果成功清理中断的隐身启动,当前窗格将保留其提示和中断通知的只读副本。它不会重新创建会话或重新发送消息;该副本仅在当前浏览器选项卡和凭证范围内持续。恢复暂停或未确认的恢复本身并不请求删除。
未发送的文本和暂存的附件只能在相同的浏览器配置文件和网关凭证范围内恢复;它们永远不会存储在网关上或跨设备同步。浏览器会将每个网关凭据范围的 20 个最近编辑的草稿范围保留最多 7 天,每个草稿最多包含 25 个 MiB 附件数据,但它可以更快地清除浏览器存储。成功发送或创建新会话、显式附件删除或确认会话删除都会停用相应的浏览器草稿。如果删除后清理失败,请清除 Control UI 源站的站点数据以将其删除。清除站点数据还会删除所有其他浏览器草稿。如果草稿的附件超出上限,当前选项卡将保留它们并显示现有存储警告,但只有文本是可重新启动恢复的。 OpenClaw Incognito 草稿永远不会持久。关闭隐身模式会恢复当前文本和附件的浏览器自动保存,无需再次编辑。切换新会话目标,或将现有的隐身聊天保留为“设置”并按“后退”返回,会将未发送的文本和附件保留在当前选项卡中。重新加载或关闭选项卡会丢弃未发送的输入。当未发送的隐身草稿保留在聊天窗格、新会话或其导航切换中时,自动 UI 更新会暂停。如果更新需要新页面,则发送仍然不可用;选择 Refresh 和 Review private Draft 来复制文本或下载暂存文件、保持选项卡打开或明确放弃该草稿并重试刷新。其他未保存的工作防护仍然适用。此保护需要运行更新的 UI 的文档;服务器更新无法将其改装到已打开的旧页面中。手动浏览器重新加载或关闭选项卡仍然会丢弃仅内存草稿。在仅限选项卡的内联发件箱中提交的隐身消息保留其单独的重新加载行为。在私有浏览器窗口中,IndexedDB 的可用性和生命周期由浏览器控制,并且存储的数据通常在私有会话结束时被清除。新会话页面右上角控制栏中的 Incognito 切换会停用浏览器草稿并创建一个仅 Web 线程,其会话条目、转录和压缩状态在创建后或直到网关重新启动(以先到者为准)在内存中保留 24 小时; OpenClaw 还跳过其自动内存刷新。代理保留其正常工具,因此显式保存请求或工具驱动的文件写入仍然可以保留数据。模型提供者仍然处理消息,并且仍然记录与内容无关的审计元数据。远程放置在将会话分派给其工作人员之前开始保留其模型和推理选择。
Projects. 地点选取器列出了使用 projects.register 记录的已配置代理工作区和存储库。只读连接接收项目名称和 ID;结帐路径和原始 URL 仅包含在 operator.write 中。管理员可以浏览到 Git 签出并选择 注册为项目;只写操作员会看到一条提示,将他们引导至该流程。选择一个项目通过 sessions.create 发送其 ID,因此它可以直接运行或为可选的工作树隔离提供源,而无需提交原始路径。如果代理工作区已移动或删除,请更新该代理的已配置工作区路径。如果记录的结帐已移动或删除,请在开始另一个会话之前重新注册它。
您还可以通过 Gateway CLI 注册现有结账。注册需要operator.admin;列表需要 operator.read。
即使 CLI 在另一台计算机上运行,也请在运行网关的计算机上使用绝对路径。网关服务帐户必须能够访问 Git 签出,并且其 HEAD 必须解析为提交。注册记录现有的结账,而不是克隆它。 name 是可选的,默认为签出目录的名称。
再次注册相同的解析存储库根会返回其现有项目 ID 和显示名称。传递不同的 name 不会重命名现有项目。
projects.list 通过只读工作线程读取已提交的注册表行,而无需检查 Git 或加入不相关的状态写入。注册时需要时初始化注册表;列出空注册表并不会创建它。最近的项目和文件夹不会等待会话显示详细信息刷新。具有 operator.write 的操作员可以请求 {"includeObserved":true} 从可见会话和托管工作树中发现其他签出。列表立即返回最后一个 Git 发现快照,同时一个有界后台通道刷新相同的签出集。冷集最初仅包括记录的工作树事实;发现完成后,将出现仅会话签出。快照一分钟后,外部远程更改以及移动或删除的结账会在第一个列表的后台刷新。更改的签出集会启动新的发现,网关关闭会取消挂起的刷新并清除快照。列表在发现期间保留会话快照,并在回复之前重新检查贡献会话。不相关的会话创建和活动不会使正在进行的列表无效;更改对贡献会话的访问权限仍需要重试。
GitHub.中的 项目搜索相同的选择器或粘贴 GitHub HTTPS 或 [email protected] 存储库 URL。对于远程目标,创建记录该源,并且运行器在调度期间获取它;不需要网关项目克隆。对于网关执行,选择器克隆到网关管理的项目区域。最近的存储库源保留其 URL,而不创建本地路径。公共存储库搜索和克隆以匿名方式进行。私密远程结账使用有效共享tools.github身份;下面的发现凭证仅授予选择器访问权限。对于附属存储库和私有存储库,首选显式 gateway.controlUi.github.token SecretRef,以便此服务访问具有明确的运行时所有者。将gateway.controlUi.github.host设置为所选的Enterprise主机;省略的凭证主机表示 github.com。发货的 GH_TOKEN 和 GITHUB_TOKEN 后备仅适用于 github.com。设置 gateway.projects.nativeGitHubSearch: true 的可信主机会为每次搜索准备当前本机系统 GitHub 身份;这适用于受保护的 gh 包装器或主机登录,并保留本机身份的 60 秒缓存和旋转栅栏。 Ambient GH_ENTERPRISE_TOKEN 或 GITHUB_ENTERPRISE_TOKEN 需要 GH_HOST 来匹配所选的 Enterprise 主机;仍支持特定于主机的本机登录。当 Control UI SecretRef 是显式的时,其确切环境或存储名称将从代理执行中排除,而不清除不相关的本机 GitHub CLI 变量。搜索将 GitHub 响应页面缓存 60 秒,在同一凭证的查询之间共享附属存储库。过期页面返回 stale: true,同时每页运行一次有界后台刷新,在 GitHub 提供 ETag 时使用 ETag。每个响应都会重新检查请求连接和当前的 GitHub 身份;撤销或取消将停止交付。每个出站请求还会重新检查发起请求者的权限。刷新属于网关并在其生命周期内停止。搜索需要 operator.read,克隆需要 operator.write,删除网关管理的克隆结帐需要 operator.admin。当实时会话或托管工作树仍然引用签出时,克隆删除会被拒绝。 SecretRef 所有权不是 OS- 用户安全边界;当同一帐户进程不受信任时,使用沙箱、专用主机或专用 OS 用户。
对于 GitHub 企业部署,配置 gateway.github.host 和 gateway.github.apiBaseUrl。 GitHub 企业服务器使用https://HOSTNAME/api/v3;其 GraphQL 请求使用 /api/graphql。要在新会话上预选存储库,请设置 gateway.projects.defaultRepository.url 和(可选)其 ref。 OpenClaw 从 URL 派生存储库身份,并通过现有 cloudWorkers.projectProfiles 映射选择工作人员配置文件。该配置文件可以使用任何配置的提供程序,包括通过 Crabbox 插件使用 Azure。默认值仅返回给 sessions.create 授权的客户,并且仅在用户没有保存项目选择时适用;选择一个文件夹或另一个项目会覆盖它。
在创建会话之前,使用“工作量”菜单选择“快速模式”。新会话在第一个本地或远程回合开始之前保留该选择。
初始 /think 命令完成后刷新会话会更新聊天的“工作量”设置。
有关代理 GitHub CLI 身份和 Git 作者设置,请参阅 tools.github。
过期的隐身链接会显示过期通知,而不是普通的新对话。 新的隐身会话 打开一个新的私人对话,并在当前选项卡中保留未发送的作曲家文本和附件;它不会自动发送它们。以前提交的未发送的消息保留在过期的会话中以供复制或丢弃,而无需重试操作。
在多用户 Gateway 上,只有管理员作用域的连接才能创建或查看隐身线程,其他会话无法通过代理会话工具或转录搜索访问它们。隐身功能可以防止存储层和其他由 Gateway 中介的用户访问,但无法防止 Gateway 所有者或进程操作员访问;后者始终可以观察实时会话。
浏览文件夹 通过 fs.listDir 打开地点选择器的内联网关目录浏览器。在路径字段中键入内容会在键入时过滤当前文件夹的子文件夹(精确匹配和前缀首先匹配,隐藏文件夹仅在文本以点开头时匹配);输入新的目录前缀会列出该目录。 Up/Down 突出显示一个文件夹,按 Enter 键打开它,按 Tab 补全其名称。写入范围浏览从配置的代理工作区开始,无法在其上方导航; realpath 检查还拒绝逃离工作区的符号链接。管理员连接可以浏览任意网关路径。最近的地方仅恢复当前连接可以提交的网关文件夹;新会话不会浏览或记住节点文件系统路径。本地提交可以使用同一往返中的第一条消息调用sessions.create。远程提交使用上述创建、分派、然后发送顺序。如果网关创建会话但拒绝第一次发送,则聊天会在重新加载时保留提示和错误; Retry 通过已创建的会话发送它,而不是创建另一个会话。
GitHub 阅读新鲜度
GitHub 悬停预览、存储库搜索和帐户显示事实会重用上次成功的结果,而有界后台请求会刷新过期的元数据。他们的 RPC 响应将结果标记为 stale: true。冷读和显式预览刷新仍然等待GitHub。失败的刷新丢弃旧的结果;下一个请求报告失败或重试。
每个请求仍会检查当前访问、身份选择和令牌轮换。发布获得自己经过验证的凭据。详细的 PR 读取在显示内容或作业数据之前保留其实时公共存储库和精确头部检查。