Холст

Приложение macOS встраивает управляемую агентом панель Canvas, используя WKWebView, — легковесное визуальное рабочее пространство для HTML/CSS/JS, A2UI и небольших интерактивных интерфейсов.

Где находится Canvas

Состояние Canvas хранится в Application Support:

~/Library/Application Support/OpenClaw/canvas/<session>/...

Панель Canvas предоставляет эти файлы через пользовательскую схему URL openclaw-canvas://<session>/<path>:

openclaw-canvas://main/ -> <canvasRoot>/main/index.html
openclaw-canvas://main/assets/app.css -> <canvasRoot>/main/assets/app.css
openclaw-canvas://main/widgets/todo/ -> <canvasRoot>/main/widgets/todo/index.html

Если в корневом каталоге нет index.html, приложение отображает встроенную страницу-заготовку.

Поведение панели

Панель без рамки с изменяемым размером, закреплённая рядом со строкой меню (или указателем мыши).
Запоминает размер и положение для каждого сеанса.
Автоматически перезагружается при изменении локальных файлов Canvas.
Одновременно отображается только одна панель Canvas (при необходимости сеансы переключаются).

Canvas можно отключить в Settings -> Allow Canvas. Когда он отключён, команды узла Canvas возвращают CANVAS_DISABLED.

API агента

Canvas доступен через WebSocket Gateway, поэтому агент может отображать и скрывать панель, переходить по пути или URL, выполнять JavaScript и создавать снимок:

openclaw nodes canvas present --node <id>
openclaw nodes canvas navigate --node <id> "/"
openclaw nodes canvas eval --node <id> --js "document.title"
openclaw nodes canvas snapshot --node <id>

canvas.navigate принимает локальные пути Canvas, URL http(s) и URL file://. Передача "/" отображает локальную заготовку или index.html. Целевые ресурсы, размещённые в Gateway по адресам /__openclaw__/canvas/ и /__openclaw__/a2ui/, разрешаются через текущий URL Canvas с ограниченной областью действия для сеанса узла. Перед переходом приложение обновляет эту кратковременную возможность; вам не нужно самостоятельно создавать или копировать URL возможности.

A2UI в Canvas

A2UI размещается на хосте Canvas в Gateway и отображается внутри панели Canvas. Когда Gateway объявляет хост Canvas, приложение macOS при первом открытии автоматически переходит на страницу хоста A2UI. Объявленный URL ограничен областью действия возможности, например http://<gateway-host>:18789/__openclaw__/cap/<token>/__openclaw__/a2ui/?platform=macos. Считайте его временными учётными данными, а не постоянной ссылкой.

Команды A2UI (v0.8)

Canvas принимает сообщения A2UI v0.8 от сервера к клиенту: beginRendering, surfaceUpdate, dataModelUpdate, deleteSurface. createSurface (v0.9) пока не поддерживается.

cat > /tmp/a2ui-v0.8.jsonl <<'EOFA2'
{"surfaceUpdate":{"surfaceId":"main","components":[{"id":"root","component":{"Column":{"children":{"explicitList":["title","content"]}}}},{"id":"title","component":{"Text":{"text":{"literalString":"Canvas (A2UI v0.8)"},"usageHint":"h1"}}},{"id":"content","component":{"Text":{"text":{"literalString":"Если вы можете прочитать это сообщение, отправка A2UI работает."},"usageHint":"body"}}}]}}
{"beginRendering":{"surfaceId":"main","root":"root"}}
EOFA2

openclaw nodes canvas a2ui push --jsonl /tmp/a2ui-v0.8.jsonl --node <id>

Быстрая дымовая проверка:

openclaw nodes canvas a2ui push --node <id> --text "Привет от A2UI"

Запуск агентов из Canvas

Canvas может запускать новые сеансы агента через глубокие ссылки openclaw://agent?...:

window.location.href = "openclaw://agent?message=Review%20this%20design";

Поддерживаемые параметры запроса:

Параметр	Значение
`message`	Предварительно заполненный запрос агента.
`sessionKey`	Стабильный идентификатор сеанса.
`thinking`	Необязательный профиль рассуждений.
`deliver`, `to`, `channel`	Цель доставки.
`timeoutSeconds`	Необязательный тайм-аут запуска.
`key`	Созданный приложением токен безопасности для доверенных локальных вызывающих сторон.

Приложение запрашивает подтверждение, если не предоставлен действительный ключ. Ссылки без ключа перед подтверждением показывают сообщение и URL и игнорируют поля маршрутизации доставки; ссылки с ключом используют обычный путь запуска через Gateway.

Примечания по безопасности

Схема Canvas блокирует обход каталогов; файлы должны находиться в корне сеанса.
Локальное содержимое Canvas использует пользовательскую схему (loopback-сервер не требуется).
Внешние URL http(s) разрешены только при явном переходе.
Обычные веб-страницы предназначены только для отображения. Действия агента принимаются только из принадлежащей приложению схемы Canvas или из точного документа A2UI в Gateway с ограниченной областью действия возможности, выбранного приложением; вложенные фреймы, перенаправления, устаревшие возможности и изменённые запросы не могут инициировать действия.

Platforms overview

macOS companion app

Где находится Canvas

Поведение панели

API агента

A2UI в Canvas

Команды A2UI (v0.8)

Запуск агентов из Canvas

Примечания по безопасности

Связанные материалы

​Где находится Canvas

​Поведение панели

​API агента

​A2UI в Canvas

​Команды A2UI (v0.8)

​Запуск агентов из Canvas

​Примечания по безопасности

​Связанные материалы

Где находится Canvas

Поведение панели

API агента

A2UI в Canvas

Команды A2UI (v0.8)

Запуск агентов из Canvas

Примечания по безопасности

Связанные материалы