会话仪表盘
Control UI 中的每个会话都可以拥有一个仪表盘——由你的智能体为你构建的实时小部件网格。选择侧面板中的仪表盘即可打开当前任务的看板,即使它还没有小部件。这不会改变你的聊天草稿。当第一个小部件被固定时,仪表盘会在对话旁边以可调整大小的侧面板形式打开,除非你已经为该任务选择了布局。使用任务工具栏中的交换按钮交换仪表盘和聊天,或使用其布局菜单将侧面板移动到主区域的左侧、右侧或下方。后续的小部件更新不会改变你当前的面板布局。关闭并重新打开侧面板不会重启已加载的小部件,也不会丢弃它们未保存的输入。重新加载页面会重新创建小部件视图。
无需任何设置,也无需配置单独的应用:仪表盘是一项核心功能,由会话拥有,随智能体存储,并且会在 /new 和 /reset 后继续存在(对话上下文会清空,但仪表盘会保留)。
查找你的仪表盘¶
打开 /dashboards 可以浏览已启用仪表盘的会话卡片画廊。可以按会话或作者搜索、按作者筛选,并按最近活动或标题排序。没有匹配任务 URL 的已存储会话仍会以预览形式可见,但没有打开链接。选择带链接的卡片,将使用你的个人展示覆盖或仪表盘的共享默认值打开其所属任务。普通卡片点击会留在应用内,并保留已维持的小部件交互。在全屏模式下,选择恢复分屏可将侧面板恢复到旁边。打开的 Dashboards 页面会在会话被重命名、归档或删除时更新,包括在 Gateway 重新连接之后。如果刷新失败,页面会保留上次加载的仪表盘,并显示数据过期警告。选择重试重新加载列表。
当你从另一台设备连接到同一 Gateway 时,仪表盘及其共享展示默认值会跟随你。个人展示覆盖、当前仪表盘标签页以及其他任务布局选择则是每台设备的 UI 状态。浏览器会为最多 500 个会话保留布局和标签页偏好,并在达到该限制时保留最近更改的条目。普通任务回访会恢复浏览器为该任务保存的布局;画廊卡片遵循相同的展示偏好。增加限制不会恢复已被旧版本驱逐的偏好。
当你切换任务或访问设置时,浏览器会在每个窗格中保留最近访问的三个任务及其仪表盘小部件。返回到已保留的任务时,小部件交互和阅读位置会保留;已变更的内容会在原地刷新。较旧的任务在重新打开时可能会重新加载。浏览器重新加载、更换 Gateway 或切换已登录用户都会清除这些保留视图。
安排你的任务¶
主区域和侧面板可以显示仪表盘或聊天。浏览器、终端、文件与审查使用相同的布局控件:
- 任务工具栏中的交换会交换主视图和当前侧面板标签页。其工具提示会显示两个视图的名称,例如交换聊天和仪表盘。之前的主视图会变为当前侧面板标签页;其他标签页仍然可用。
- 任务工具栏中的布局会将侧面板移到主区域的左侧、右侧或下方。拖动分隔线可调整大小。在空间允许再次并排布局之前,窄窗格会使用底部面板。
- 点击侧面板的仪表盘标签页,即可一步将仪表盘展开到整个任务区域,即使当前选择的是其他标签页。再次点击即可恢复分屏。使用方向键进行标签页导航时只会选择标签页;按 Enter 或 Space 会展开或恢复仪表盘。其他标签页保持正常的选择行为。
- 侧面板关闭按钮 × 旁边的展开会展开当前标签页。展开后,同一控件变为恢复分屏,并保持在 × 旁边。恢复操作会还原原始主视图、面板位置和大小,而不会交换聊天和仪表盘。关闭已展开的面板则会返回主视图。
- 任务工具栏中的聚焦会让主视图占据整个任务区域。恢复分屏会以之前的放置位置和大小重新显示侧面板。
交换、移动和聚焦都会保留实时视图,包括聊天草稿和小部件交互。关闭整个侧面板会隐藏其标签页,并保持主视图不变。关闭“仪表盘”标签页会将该视图从布局中移除,但不会删除仪表盘。可从面板的 + 菜单重新打开。空仪表盘会保持打开,以便你可以添加第一个小部件,而无需改变已选择的布局。任务工具栏位于主窗格上方,在窗格并排时与侧面板标签页对齐。在堆叠布局中,每个标题栏都位于自己的窗格上方。侧面板标签页仅在存在可供切换的视图时出现。
当一个标签页包含一个全宽小部件时,其标题和控件会位于任务菜单中,而不是小部件上方的胶囊内,分屏和全屏视图均如此。较小的小部件和多小部件标签页会保留各自的控件。
通过提问构建仪表盘¶
如需固定的数据摘要,可请求一个包含文本、指标、表格、图表或链接的原生报告。报告直接渲染在仪表盘上,无需 iframe 或内联预览。当你提出请求时,智能体会更新报告的数据;如果你需要自定义交互,请使用 HTML 小部件。参见原生仪表盘报告。
观看 Patrick Erichsen 如何用一个提示词构建 OpenClaw 2.0 发布仪表盘:
向你的智能体提出你希望看到的内容:
创建一个名为 revenue-graph 的小部件:一个显示每月收入的交互式柱状图。添加可切换视图的“柱状图”和“趋势”按钮。将其固定到我的仪表盘。
对于这个交互式 HTML 小部件,智能体会先渲染一个内联聊天预览。然后:
- 由你固定:将鼠标悬停在内联小部件上,选择固定到仪表盘。
- 或者由智能体直接固定:当你提出请求时,智能体就会直接固定它,并按名称更新——小部件具有稳定名称,因此“用六月的数据更新 revenue-graph”会在原地替换内容,而仪表盘保持不变。
为未安排布局的线程创建的第一个 Dashboard 只会在侧面板中打开一次。 之后的更新不会重新打开面板,也不会抢占您当前工作的焦点。
小组件是自包含的小型应用(HTML/JS/SVG,封装在硬沙箱中)。小组件内的按钮和视图切换会立即生效——切换图表视图永远无需代理参与。
看板¶
- 流式网格。 通过手柄拖动小组件;所有内容会自动重排并紧凑排列。可通过手柄调整大小,或从小组件菜单中选择尺寸预设(小、中、大、特大)。没有人会逐像素摆放——您不会,代理也不会。在窄看板上,小组件按保存的顺序以全宽堆叠;加宽看板后,会恢复它们保存的列宽。
- 自动高度。 HTML 小组件会调整自身高度以适应内容。通过手柄调整大小或选择尺寸预设会固定高度。从小组件菜单中选择 自动高度(Auto height) 可重新适应内容。
- 标签页。 一个看板可以有多个页面——例如,一个概览标签页和一个包含单个大小组件的专注标签页。每个标签页都会记住自己的小组件布局。在 Dashboard 保留期间,访问过的标签页保持加载状态,当您切换回来时,本地过滤器和小组件交互得以保留。未访问的标签页按需加载;已更改的内容仍会刷新,已删除的标签页会释放其小组件。将已加载的小组件移动到另一个标签页,也会保留其未保存的输入和交互。
- Dashboard 视图。 看板可以占据主区域或可调整大小的侧面板。当 Dashboard 在侧面板中处于活动状态时,在任务工具栏中选择 交换(Swap),然后选择 聚焦(Focus) 以获得仅 Dashboard 的视图。恢复拆分(Restore split) 会恢复侧面板。包含一个全宽小组件的标签页会填满已聚焦的 Dashboard,使用所有可用的宽度和高度,且没有卡片边框。标准 HTML 小组件在最大化时保留其内容内边距;显式设置为通栏(full-bleed)或无边框的小组件保持边缘到边缘。嵌入式 MCP 应用在您调整窗口大小或恢复拆分时会跟随可用空间。其小组件控件会移入任务工具栏的 … 菜单中,页面上不再留下悬停胶囊或拖动/调整大小手柄。已授予的权限仍可在该菜单中使用;批准请求和错误信息仍会在小组件中保持可见。恢复拆分或添加另一个小组件会恢复正常间距。
- 共享默认值。 在任务菜单的 布局(Layout) 子菜单中,选择 将当前视图设为默认值(Use current view as default),可使常规的会话打开(包括侧边栏链接)以 Dashboard 当前的全屏或拆分视图显示。当显示 Dashboard 时,这是默认视图(This is the default view) 会确认当前的全屏或拆分视图以及会话的打开视图都与共享默认值匹配,包括对只读查看者也是如此。当视图不同时,如果您可以编辑会话,则 将当前视图设为默认值(Use current view as default) 可用。这两项都会说明个人布局选择仍然适用。仅仅打开、交换或聚焦面板不会更改共享默认值。如果较旧的 Dashboard 保存了其全屏或拆分呈现方式,但仍以 Chat 打开,请选择一次 将当前视图设为默认值(Use current view as default),以同时保存这两种选择。保存不会重新排布任何已在查看 Dashboard 的用户;该默认值适用于后续的打开和重新访问,包括从 Dashboard 库打开时。您在浏览器中明确做出的 聚焦(Focus) / 恢复拆分(Restore split) 选择优先于共享默认值。再次选择共享视图会清除该个人覆盖。应用共享默认值不会创建个人覆盖。停靠位置、尺寸和其他面板保持为本地设置。重新打开或重新加载未更改的 Dashboard 视图会保留所选的侧面板标签页,包括当 Chat 仍是主视图时的 Side chat 或 Files。它还会保留已关闭的侧面板或已聚焦的 Chat 视图。没有呈现来源(presentation provenance)的现有浏览器布局会保留其完整的已保存布局,直到您明确选择一种呈现方式;OpenClaw 不会猜测较旧的展开是否属于自动展开。本地布局保留仍为 500 个会话。显式的
?dashboard=expanded链接仅对该次访问请求全屏。 - 代理对等。 代理的
dashboard工具可创建或更新受信任的插件小组件,移动、调整大小和移除小组件,管理标签页,切换可见标签页,并通过set_presentation以及presentation: "split"或"expanded"请求拆分或展开的 Dashboard。show_widget工具可创建或刷新原生报告、自定义 HTML 和注册来源的小组件。更新时,对 HTML 或注册来源使用pin: true、相同的name和新的widget_code;对原生报告则使用新的report对象。看板快照会标识每个小组件的contentOwner,并在适用时标识registeredContentKind;在替换其内容所有者或注册来源类型之前,请先移除该小组件。请说“显示财务标签页并展开 Dashboard”,然后静观其变。
若要改为发布初始视图,请使用 dashboard,并带上 action: "set_default_presentation" 以及 presentation: "split" 或 "expanded"。此持久操作无需连接浏览器即可工作。action: "read" 会返回有效的 defaultPresentation,未设置时为 "split"。菜单和代理都使用相同的已授权 sessions.patch 变更操作来同时保存 boardFace: "dashboard" 和 boardPresentation。可选的 boardPresentation 元数据随会话一起存储,在该会话重启以及 /new 或 /reset 后仍然存在,并随会话删除而移除。将 boardPresentation 设为 null 会恢复内置的拆分默认值。无需数据库架构迁移或回填。旧版本会忽略此呈现行为;回退不会移除看板或记录。
切换可见标签页或 Dashboard 呈现方式需要已连接的 Control UI。如果没有连接,命令会返回 UNAVAILABLE;请打开 Control UI 并重试。
focus_tab 会在其当前位置显示 Dashboard。聚焦标签页后调用 set_presentation:presentation: "expanded" 会使 Dashboard 成为主视图并聚焦它;"split" 会使用当前排列方式显示它,当 Dashboard 是主视图时,将 Chat 并排显示。
全屏显示网站¶
向你的代理发出指令:
将 https://status.example.com 放到此仪表板上,将其展开以填满任务区域, 并在侧边栏中将此会话固定为 Status。
内置的 Website 小组件会直接在你的浏览器中加载实时网站。它不需要插件、中继服务器或复制的网站代码。单个全宽网站即可填满展开的仪表板;添加其他小组件会恢复正常的网格布局。网站自行控制其刷新和导航。
代理使用现有的 dashboard 工具创建它:
{
"action": "widget_put",
"name": "status",
"title": "Status",
"pluginKind": "session:website",
"props": { "url": "https://status.example.com" },
"size": "full"
}
然后,它调用带有 action: "set_presentation" 和 presentation: "expanded" 的 dashboard。会话命名和固定使用现有的 sessions 工具。复用小组件名称即可更改其 URL。URL 和布局随面板一起持久化;展开的呈现方式遵循现有的每设备任务布局偏好。Website 小组件不会在图库缩略图中加载。
URL 必须使用 HTTPS,不包含用户名或密码,并且不超过 2048 个字符。渲染器会拒绝 Control UI 和已连接的 Gateway 主机名,包括这些主机上使用其他端口的 URL。该框架支持网站的脚本、表单、存储和链接,但不会接收注入的 Gateway 令牌、小组件工具桥,也没有导航父应用的权限。它遵循网站自身的认证机制以及你浏览器的 Cookie 策略。
有些网站拒绝嵌入,有些登录流程需要单独的标签页。如果框架保持空白或无法登录,请使用 Open website。OpenClaw 不会代理该网站,也不会移除其嵌入限制。此小组件与自定义 HTML 小组件是分开的,不会放宽后者的沙箱或网络权限。
与代理共享浏览器仪表板¶
当你想要一个已保存的仪表板,让代理能够读取并与你看到的同一页面交互时,请要求 Browser dashboard:
将此 HTTP 状态应用作为全屏仪表板打开。将此会话固定为 Service Status,并且当我要求你更改其筛选条件时,使用同一个页面。
若要在聊天旁边显示浏览器,请要求打开 Browser side panel。这会打开现有面板,而不会创建仪表板小组件或展开面板。
Browser 插件的 browser:dashboard 小组件在由 OpenClaw 管理的本地浏览器中呈现一个标签页。Control UI 会流式传输该标签页,因此当 Control UI 本身使用 HTTPS 时,HTTP 应用也可以正常工作。浏览器现有的导航策略仍然适用。它不会继承你手机或笔记本电脑上的浏览器 Cookie。管理员使用受管理配置文件的登录会话。其他会话写入者使用具有自身 Cookie 和存储的隔离上下文。
代理通过 dashboard 创建小组件:
{
"action": "widget_put",
"name": "service-status",
"title": "Service Status",
"pluginKind": "browser:dashboard",
"props": { "url": "http://status.example.com" },
"size": "full"
}
然后,它使用带有小组件名称的现有 browser 工具:
act 和 navigate 接受相同的 dashboard 选择器。该选择器解析当前标签页,因此代理无需重新打开 URL 或猜测目标 ID。使用 dashboard 来排列面板、通过 set_presentation 展开它以及移除小组件;会话命名和固定使用 sessions。无需单独的站点特定工具。
对于管理员来说,隐藏仪表板或重置其会话会保留其浏览器标签页。普通的标签页关闭和空闲清理不会关闭仪表板拥有的标签页。使用 Stop browser 释放正在运行的标签页,使用 Resume browser 重新打开它。代理的等效操作是带有 action: "close" 或 "open" 的 browser 以及 dashboard 选择器。Stop 也会在首次打开之前持久化,而无需启动浏览器;重新打开仪表板或重启 Gateway 会使其保持暂停状态,直到 Resume。恢复时会加载已保存的 URL;未保存的文档状态不会在关闭浏览器后保留。如果暂时无法关闭,仪表板会显示 Stop 正在等待中,并提供 Retry stop 直到确认关闭。当 Browser 收到面板变更时,移除或替换小组件会释放其旧标签页;现有的清理周期也会协调错过的变更。图库预览绝不会启动浏览器。
管理员浏览器仪表板需要 Browser 访问权限,并默认使用 openclaw 受管理配置文件。可选的 props.profile 选择另一个本地受管理配置文件;附加的个人浏览器、节点路由和远程浏览器配置文件不受此小组件支持。当你只需要在自己的浏览器中显示可嵌入的 HTTPS 网站时,轻量级的 Website 小组件仍然有用。
会话写入者访问¶
启用 Browser 插件后,非管理员会话写入者无需 operator.admin 即可打开 Browser 仪表板。operator.write 保留会话现有的协作者规则。范围更窄的 operator.sessions.write 仅授予对调用者自身会话的访问权限。有效的浏览器工具策略仍然适用;此功能不会更改角色或工具默认值。
Session browser 模式使用配置的默认本地受管理配置文件,为会话和小组件启动一个空的、隔离的浏览器上下文。不支持自定义、附加、个人、扩展、节点和远程配置文件。Cookie 和存储与管理员浏览器及其他会话分开。代理在为非管理员操作者执行操作时,其 dashboard 选择器使用相同的上下文。管理员视图和选择器继续使用各自独立的受管理配置文件标签页;其页面状态不与 Session browser 共享。
Session browser 支持页面导航、检查、截图和交互。它不提供配置文件管理、任意标签页选择、文件传输或 Cookie/存储管理。通用浏览器工具保持其现有的已配置主机/配置文件访问权限:此隔离仅适用于仪表板路由和选择器,而不适用于整个代理。
上下文在正常轮次结束或查看器断开后仍然存在。撤销某人的访问权限会停止其查看器和操作,但不会破坏其他授权协作者的上下文。重置或删除会话、移除组件、停用浏览器配置文件或重启 Gateway 都会关闭上下文。会话浏览器的“停止”状态保存在内存中;“恢复”会从保存的组件 URL 重新开始。Gateway 最多保留 64 条隔离的仪表盘记录;如果达到该限制,请移除未使用的浏览器组件。
需要沙箱或已锁定模型选择的会话无法使用此模式。隔离的 Gateway 浏览器上下文并非沙箱后端。现有的管理员浏览器路径仍按原有规则可用。
组件可以做什么¶
仅用于渲染的自定义 HTML 和注册源组件无需审批——它们会立即出现,与内联聊天组件完全一样,且其网络访问被完全禁用。
需要访问能力的组件必须声明这种能力。明确的会话权限模式会决定具体行为:完全访问立即授予;工作区使用 AI 审查器并拒绝其不允许的任何内容;受保护显示允许/拒绝卡片;只读拒绝该请求。若未明确设置会话模式,则应用等效的已配置执行审批策略。
- 网络(
net):直接从沙箱获取所声明的 HTTPS 源——例如,一个从 API 自行刷新的天气卡片。 - Gateway 数据(
data):由 gateway 解析的只读数据源,如会话、用量或 cron 状态——组件永远不会持有你的令牌。 - 自动化(
actions):触发特定的 cron 任务,这样按钮就可以运行真实的任务(可能使用较小的模型),而无需唤醒你的主对话。 - 提示(
prompt):向你的线程发送消息,而无需未获批准组件所要求的逐次点击确认。
已启用的插件可以将自己命名的只读数据源和操作添加到这些能力列表中;禁用插件会移除这些集成。
授权与你的会话策略所批准的组件字节精确绑定。即使权限保持不变或缩小,只要 HTML 或注册源字节发生变化,就需要重新做出决定。只有当已批准的字节仍然匹配且请求的权限没有扩大时,授权才会保留。创作结果会区分待处理、已拒绝和已授予三种访问状态;保存组件并不代表其能力已获批准。当同一代理在另一个会话中以相同名称、来源和声明重新创建 HTML 或注册源组件时,自动审查可以复用低风险审批。这种有界的内存内复用会在运行时配置或执行审批策略发生变化时重置。每个会话当前的权限模式和每个组件的授权仍然适用。MCP 应用和隐身会话不会复用这些评估。新内容仍需等待审查。代理应了解的组件交互(你点击的筛选器、你切换的视图)会以会话通知的形式静默到达——既能保持信息同步,又不会被打断。
看板上的 MCP 应用¶
如果你的 gateway 配置了 MCP 服务器,则聊天中出现的交互式 MCP 应用可以像任何组件一样被固定。固定的应用会在看板上以全新会话重新激活。默认情况下,它们的渲染不包含服务器工具或同服务器资源访问权限。授予组件其声明的服务器工具后,在该修订绑定的授权保持有效期间,两种桥接都会启用。
A2UI 组件¶
当 Canvas 插件启用时,代理可以将 A2UI JSONL 渲染为仪表盘组件。A2UI 组件使用与 HTML 组件相同的稳定名称、标签页、大小、固定、沙箱和就地更新行为。渲染器从 Gateway 的 /__openclaw__/a2ui/ 资源路由加载,因此渲染器包不会被复制到每个组件中。必须启用 Canvas 插件及其托管的资源路由;两者默认均为启用状态。
A2UI 操作使用正常的组件桥接。默认情况下,点击会变成静默的会话通知,代理会在下一轮次看到。如果组件声明并获得了 prompt 授权,其操作则可以改为向线程发送可见的提示。禁用 Canvas 插件会移除 A2UI 类型,并使已存储的组件在插件重新启用之前显示为不可用。
已退役的 Workspaces¶
实验性的 Workspaces 插件、其 Control UI 标签页、openclaw workspaces CLI 和 workspace_* 工具已被移除。会话仪表盘使用不同的存储模型:每个看板属于一个会话,并存在于所属代理的数据库中。旧版 Workspaces 文档和数据库不会自动转换。
在运行 openclaw doctor --fix 之前,请保留任何旧版文档、数据和组件资产:其 Workspaces 修复操作会删除 <stateDir>/workspaces 下已识别的旧版状态,而不会将该内容导入仪表盘。
须知¶
- 重置带有看板的线程时会要求确认,并保留该看板。
- 删除线程会同时删除其看板。
- 看板存在于你的 gateway 上(位于所属代理的数据库中),并且会出现在你连接的每台设备上。
- 已启用仪表盘的线程会出现在
/dashboards中。关闭仪表盘标签页或侧面板不会删除仪表盘,也不会将其从图库中移除。 - 安全模型、存储细节和设计原理参见 Dashboard Architecture,其中包含已记录的沙箱权衡。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw