本页内容
本页内容
macOS 配套应用程序
小部件面板
macOS 应用程序包括一个用于显示托管小部件文档的本机面板。 Canvas 插件拥有此演示路径。它不是独立的可视工作区或 A2UI 推送目标。
建议的代理路径是 show_widget 和 presentation.target: "node_panel"。 OpenClaw 将小部件存储为托管文档,选择连接的 macOS 节点,打开面板并将其导航到该文档。如果未连接符合条件的 Mac 或演示失败,小部件仍会内联显示在聊天中,并且工具结果会说明如何重试。
本机面板中的小部件仅用于渲染。主机集成的小部件操作在 Control UI 聊天和 会话仪表板 表面中仍然可用,而不是在面板中。
面板行为
- 该面板无边框、可调整大小,并固定在菜单栏或鼠标光标附近。
- 呈现小部件不会切换应用程序或获取键盘焦点。
- 一次只能看到一个小部件面板。
- 该应用程序会记住每个会话的面板大小和位置。
可以从 Dashboard → 设置 → 本机 → 功能 禁用画布。禁用时,面板命令返回 CANVAS_DISABLED。
代理路径
要求代理使用 show_widget 并定位节点面板。该工具仅在小部件呈现器插件处于活动状态时才会公开 node_panel。
演示成功后,结果会识别所选的 Mac。 OpenClaw 当前仅选择声明 canvas.present 的已连接 macOS 节点。
Node 命令
配对节点命令界面包含三个命令:
canvas.present显示面板。它还接受现有的可选目标和放置参数。canvas.navigate加载托管小部件文档路径或应用程序本地画布 URL。canvas.hide隐藏面板而不更改其当前文档。
下的托管路径/__openclaw__/canvas/通过节点会话的当前作用域来解决pluginSurfaceUrls.canvas URL。该应用程序会在导航前刷新这种短暂的功能。调用者应该传递文档路径,而不是构造或复制功能URL。
应用程序本地方案仍然可用于应用程序拥有的内容:
该方案处理的文件必须保留在应用程序支持中会话的 Canvas 根目录内。目录遍历被阻止。
A2UI 属于会话仪表板
A2UI 小部件在 会话仪表板 上呈现,它们与其他仪表板小部件共享相同的固定、布局、批准和交互模型。他们的渲染器包继续从网关的 /__openclaw__/a2ui/ 资源路径加载。
macOS 面板不接受 A2UI push/reset 命令,并且不会自动导航到 A2UI 页面。
从自定义根迁移文档
跑步openclaw doctor --fix转移退休人员的文件plugins.entries.canvas.config.host.root(或较旧的canvasHost.root) 进入状态目录canvas/documents文件夹。显式插件根优先于旧设置。 Doctor 仅在没有遗留文档后才会删除根设置。如果目录访问或文档复制失败,doctor 会发出警告并保留源定位器以供重试。它可能会将旧设置移至插件配置中,同时保留路径。已经指向默认存储文件夹(包括通过符号链接)的根不需要复制。
修复报告的权限或目标冲突,然后重新运行命令。请勿自行删除 root 设置。托管路由仅服务于默认存储文件夹,因此在迁移完成之前剩余的旧文档不可用。