Passer au contenu principal

​
Canvas (application macOS)

L’application macOS intègre un panneau Canvas contrôlé par l’agent à l’aide de WKWebView. Il s’agit d’un espace de travail visuel léger pour HTML/CSS/JS, A2UI et de petites surfaces d’interface interactives.

​
Où se trouve Canvas

L’état de Canvas est stocké sous Application Support :
  • ~/Library/Application Support/OpenClaw/canvas/<session>/...
Le panneau Canvas expose ces fichiers via un schéma d’URL personnalisé :
  • openclaw-canvas://<session>/<path>
Exemples :
  • 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
Si aucun index.html n’existe à la racine, l’application affiche une page d’échafaudage intégrée.

​
Comportement du panneau

  • Panneau sans bordure, redimensionnable, ancré près de la barre de menus (ou du curseur de la souris).
  • Mémorise la taille et la position par session.
  • Se recharge automatiquement lorsque les fichiers Canvas locaux changent.
  • Un seul panneau Canvas est visible à la fois (la session est changée si nécessaire).
Canvas peut être désactivé depuis Réglages → Autoriser Canvas. Lorsqu’il est désactivé, les commandes de nœud Canvas renvoient CANVAS_DISABLED.

​
Surface de l’API agent

Canvas est exposé via le Gateway WebSocket, de sorte que l’agent peut :
  • afficher/masquer le panneau
  • naviguer vers un chemin ou une URL
  • évaluer du JavaScript
  • capturer une image instantanée
Exemples CLI : 
openclaw nodes canvas present --node <id>
openclaw nodes canvas navigate --node <id> --url "/"
openclaw nodes canvas eval --node <id> --js "document.title"
openclaw nodes canvas snapshot --node <id>
Notes :
  • canvas.navigate accepte des chemins Canvas locaux, des URL http(s) et des URL file://.
  • Si vous passez "/", Canvas affiche l’échafaudage local ou index.html.

​
A2UI dans Canvas

A2UI est hébergé par l’hôte Canvas de la Gateway et rendu à l’intérieur du panneau Canvas. Lorsque la Gateway annonce un hôte Canvas, l’application macOS navigue automatiquement vers la page hôte A2UI à la première ouverture. URL par défaut de l’hôte A2UI : 
http://<gateway-host>:18793/__openclaw__/a2ui/

​
Commandes A2UI (v0.8)

Canvas accepte actuellement les messages serveur→client A2UI v0.8 :
  • beginRendering
  • surfaceUpdate
  • dataModelUpdate
  • deleteSurface
createSurface (v0.9) n’est pas pris en charge. Exemple CLI : 
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":"If you can read this, A2UI push works."},"usageHint":"body"}}}]}}
{"beginRendering":{"surfaceId":"main","root":"root"}}
EOFA2

openclaw nodes canvas a2ui push --jsonl /tmp/a2ui-v0.8.jsonl --node <id>
Fumée rapide: 
openclaw nodes canvas a2ui push --node <id> --text "Hello from A2UI"

​
Déclencher des exécutions d’agent depuis Canvas

Canvas peut déclencher de nouvelles exécutions d’agent via des liens profonds :
  • openclaw://agent?...
Exemple (en JS) : 
window.location.href = "openclaw://agent?message=Review%20this%20design";
L’application demande une confirmation sauf si une clé valide est fournie.

​
Notes de sécurité

  • Le schéma Canvas bloque la traversée de répertoires ; les fichiers doivent se trouver sous la racine de la session.
  • Le contenu Canvas local utilise un schéma personnalisé (aucun serveur de loopback requis).
  • Les URL http(s) externes ne sont autorisées que lorsqu’elles sont explicitement visitées.