Canvas

这个“画布”是电脑上的一个小窗口，它没有边框，你可以像拉橡皮筋一样改变它的大小。它就像一个专门用来放网页和互动小工具的透明板子。

画布住在哪里？ 它就像一个住在你电脑里的小房间。它所有的东西（比如网页、图片）都放在一个固定的地方： ~/Library/Application Support/OpenClaw/canvas/<session>/... 你可以把它想成是你的玩具箱，每个玩具箱（session）里都装着不同的玩具（文件）。

怎么找到画布里的东西？ 画布里的东西有一个特别的“地址”，就像“魔法咒语”一样。这个咒语的开头是：openclaw-canvas://。 比如，咒语 openclaw-canvas://main/ 就会打开“main”这个玩具箱里最上面的一个叫 index.html 的玩具。如果这个玩具箱里没有 index.html 这个玩具，画布就会给你看一个它自己准备好的空白画板。

画布怎么工作？

1. 它没有边框，可以改变大小，通常停在你电脑屏幕的顶部菜单栏附近。
2. 它会记住自己上次的大小和位置。
3. 当你修改了画布里的文件，它会自己刷新，就像你眨一下眼睛就看到新画面一样。
4. 一次只能看到一个画布窗口，但你可以切换不同的“玩具箱”（session）来看。

怎么打开或关上画布？ 你可以去电脑的“设置”里，找到一个叫 Allow Canvas 的开关。如果你把它关上了，画布就不能用了，一些命令会告诉你 CANVAS_DISABLED（意思是“画布被关掉了”）。

聪明的小助手（智能体）怎么控制画布？ 小助手可以通过一条叫 Gateway WebSocket 的秘密通道和画布说话。这条通道就像对讲机。通过它，小助手可以：

1. 让画布窗口出现或消失。
2. 让画布去显示某个地址的东西。
3. 在画布里运行一小段 JavaScript（这是一种让网页动起来的语言）。
4. 给画布拍一张“照片”（快照）。

你可以用一些命令来让小助手做这些事，比如：

• openclaw nodes canvas present --node <id> （让画布出现）
• openclaw nodes canvas navigate --node <id> --url "/" （让画布显示主页）
• 这里的 --node <id> 是告诉命令你要控制哪个小助手。

画布里的一种特别工具：A2UI A2UI 是一种用来做界面的特别工具，它就像一套高级的积木。画布可以显示用 A2UI 搭出来的东西。当小助手准备好 A2UI 后，画布会自动打开并显示它。 目前，画布只认识 A2UI v0.8 版本的积木搭建指令，比如 beginRendering（开始搭积木）、surfaceUpdate（更新积木表面）。它还不认识新版本（v0.9）里的 createSurface 这个指令。

怎么从画布里叫小助手来帮忙？ 如果你在画布（网页）里写一小段 JavaScript 代码，比如： window.location.href = "openclaw://agent?message=Review%20this%20design"; 这就像你对着对讲机喊：“小助手，快来帮我看看这个设计！”然后电脑就会问你要不要真的叫它来，除非你有正确的“钥匙”。

要小心的事情

• 画布很安全，它只会在自己的“玩具箱”里找东西，不会跑到电脑的其他地方乱翻。
• 它主要用自己那个特别的“魔法咒语”地址，所以不需要在电脑里开一个额外的“小服务器”。
• 只有当小助手明确告诉它时，它才会去显示外面的普通网页地址（比如 http://...）。