SuperAPI AI 工具集

canvas

通用与其它

查看项目

更新于 10-16 06:42

技能介绍

用途:canvas 工具把 Web 内容展示在任意已连接节点的 canvas 视图中,适用于显示游戏、可视化、仪表盘、生成的 HTML 内容及交互演示。

架构:Canvas Host(HTTP 服务器,端口 18793)提供 canvasHost.root 目录下的静态 HTML/CSS/JS 文件;Node Bridge(TCP 服务器,端口 18790)把 canvas URL 传送到已连接节点;节点应用在 WebView 中渲染内容。

Tailscale 集成:canvas 服务器按 gateway.bind 设置绑定。loopback 绑定 127.0.0.1,URL 用 localhost(仅本地);lan 绑定 LAN 接口,用 LAN IP;tailnet 绑定 Tailscale 接口,用 Tailscale 主机名;auto 取最佳可用(Tailscale > LAN > loopback)。canvasHostHostForBridge 由 bridgeHost 推导,绑定 Tailscale 时节点收到类似 http://<tailscale-hostname>:18793/openclaw/canvas/<file>.html 的 URL,因此 localhost URL 不可用。

动作:present(显示 canvas,可带目标 URL)、hide(隐藏)、navigate(导航到新 URL)、eval(在 canvas 中执行 JavaScript)、snapshot(截图)。

配置:在 ~/.cryptoclaw/cryptoclaw.json 中设置 canvasHost(enabled、port、root、liveReload)与 gateway.bind。liveReload 默认 true 时,canvas host 通过 chokidar 监视 root 目录变化,向 HTML 注入 WebSocket 客户端,文件变化后自动重载已连接 canvas。

使用流程:把 HTML 放在 canvas 根目录(默认 ~/clawd/canvas/);确认 gateway.bind 并构造 URL;用 cryptoclaw nodes list 查找具备 canvas 能力的 Mac/iOS/Android 节点;用 canvas action:present node:<node-id> target:<full-url> 展示;随后可用 navigate、snapshot、hide。URL 前缀为 /openclaw/canvas/,由 CANVAS_HOST_PATH 常量定义。

限制与排错:白屏通常是服务器绑定与节点预期 URL 不匹配,应使用与绑定模式匹配的完整主机名而非 localhost;出现 "node required" 错误需始终指定 node:<node-id>;"node not connected" 表示节点离线,用 cryptoclaw nodes list 查找在线节点;内容不更新时检查 liveReload、文件位置与日志。建议 HTML 自包含(内联 CSS/JS)。canvas 会保持直到隐藏或导航离开。A2UI JSON 推送仍在开发中(WIP),目前使用 HTML 文件。