Canvas para macOS: Tu espacio visual interactivo

¿Te ha pasado que intentas visualizar datos complejos o una interfaz rápida y terminas peleando con ventanas del navegador que no tienen nada que ver con tu flujo de trabajo? Es frustrante tener que cambiar de contexto constantemente cuando solo necesitas un espacio visual ligero para que tu agente interactúe contigo.

Canvas resuelve esto integrando un panel controlado por un agente directamente en macOS. Es un workspace visual basado en WKWebView diseñado para renderizar HTML, CSS, JS y superficies de UI interactivas sin la carga de una aplicación completa.

What You’ll Need

• La aplicación de macOS instalada.
• Gateway activo (Canvas se expone a través de su WebSocket).
• Archivos en la ruta de soporte: ~/Library/Application Support/OpenClaw/canvas/<session>/.

Quick Start

Canvas vive cerca de tu barra de menú y recuerda su posición por sesión. Para empezar a interactuar con el panel, puedes usar la CLI de openclaw.

1. Presenta el panel:

   openclaw nodes canvas present --node <id>

2. Navega a un path o URL: Si pasas "/", Canvas buscará un index.html en la raíz de tu sesión o mostrará una página base predeterminada.

   openclaw nodes canvas navigate --node <id> --url "/"

3. Ejecuta JavaScript y captura resultados: Puedes evaluar código JS en tiempo real o tomar una captura de pantalla del estado actual.

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

4. Prueba A2UI (v0.8): Si quieres enviar componentes de interfaz de forma rápida, usa el comando push:

   openclaw nodes canvas a2ui push --node <id> --text "Hola desde A2UI"

Troubleshooting

• Error CANVAS_DISABLED: Este error aparece si la función está apagada en la configuración global. Ve a Settings → Allow Canvas para habilitarla.
• A2UI no carga: Canvas soporta específicamente A2UI v0.8. Si intentas usar comandos de la v0.9 (como createSurface), no funcionarán. Asegúrate de usar beginRendering o surfaceUpdate.
• Acceso a archivos denegado: Canvas bloquea el salto entre directorios (directory traversal). Todos tus archivos deben vivir estrictamente bajo el root de la sesión en Application Support.
• El panel no aparece: Verifica que el Gateway esté publicando correctamente el host de Canvas. Por defecto, A2UI se sirve en http://<gateway-host>:18793/__openclaw__/a2ui/.

Para configurar tu entorno de forma personalizada, consulta al AI Setup Assistant.

What’s Next

• Configuración de Gateway WebSocket
• Referencia de comandos CLI
• Guía de Deep Links para Agentes
• Estructura de archivos de sesión