Recomendado: Windows Hub
Windows Hub es la aplicación complementaria nativa de WinUI para Windows 10 20H2+ y Windows 11. Se instala sin privilegios de administrador y se distribuye como instaladores x64 y ARM64 firmados en las versiones de OpenClaw. Descarga el instalador estable más reciente desde la página de versiones de OpenClaw o directamente mediantereleases/latest/download:
Si un enlace anterior devuelve 404, visita la página de versiones
y busca los recursos OpenClawCompanion-Setup-* en la versión más reciente.
Después de la instalación, inicia OpenClaw Companion desde el menú Inicio o la
bandeja del sistema. El instalador también añade accesos directos para la configuración de Gateway, Chat, Ajustes,
Buscar actualizaciones y desinstalar.
Qué incluye Windows Hub
- Estado en la bandeja del sistema e inicio al iniciar sesión.
- Configuración inicial para un Gateway WSL local propiedad de la aplicación.
- Ajustes de conexión para Gateways locales, remotos y con túnel SSH.
- Ventana de chat nativa y acceso a la Control UI del navegador.
- Diagnósticos de Command Center para sesiones, uso, canales, nodes, emparejamiento y comandos de reparación.
- Modo de Node de Windows para lienzo, pantalla, cámara,
notificaciones, estado del dispositivo, habla y
system.runcontrolado por el agente. - Modo de servidor MCP local para clientes MCP como Claude Desktop, Claude Code y Cursor.
Primer inicio
En el primer inicio, Windows Hub abre la configuración cuando no hay ningún Gateway guardado utilizable. La ruta más rápida es Configurar localmente, que aprovisiona una distribución WSLOpenClawGateway propiedad de la aplicación, instala el Gateway dentro de ella y
empareja la aplicación. Esto no exporta ni modifica tu distribución Ubuntu existente.
Elige Configuración avanzada o abre la pestaña Conexiones cuando ya tengas un
Gateway. Puedes conectarte a:
- un Gateway local en este PC
- un Gateway WSL en este PC
- un Gateway remoto por URL y token o código de configuración
- un Gateway accesible mediante un túnel SSH
Modo de Node de Windows
Windows Hub puede registrarse como un Node de OpenClaw para que el agente pueda usar las capacidades nativas de Windows declaradas a través del Gateway. Los comandos de Node deben ser declarados por el Node y permitidos por la política de Gateway antes de ejecutarse; consulta Nodes para ver el modelo completo de permitir/denegar. Comandos comunes:| Familia | Comandos |
|---|---|
| Lienzo | canvas.present, canvas.hide, canvas.navigate, canvas.eval, canvas.snapshot |
| Pantalla | screen.snapshot; screen.record requiere participación explícita |
| Cámara | camera.list; camera.snap, camera.clip requieren participación explícita |
| Sistema | system.notify, system.run, system.run.prepare, system.which |
| Dispositivo | location.get, device.info, device.status |
| Habla | talk.ptt.start, talk.ptt.stop, talk.ptt.cancel, talk.ptt.once, talk.speak |
screen.record, camera.snap
y camera.clip, necesitan una participación explícita en gateway.nodes.allowCommands.
Modo MCP local
Windows Hub puede exponer el mismo registro de capacidades nativas de Windows como servidor MCP local en loopback, para que los clientes MCP locales puedan controlar capacidades de Windows sin un Gateway de OpenClaw en ejecución. Actívalo en los Ajustes de Windows Hub, en la sección de desarrollador/avanzada. La aplicación muestra el endpoint de loopback y el token bearer una vez activado el servidor. Matriz de modos:| Modo de Node | Servidor MCP | Comportamiento |
|---|---|---|
| desactivado | desactivado | Aplicación de escritorio solo para el operador |
| activado | desactivado | Node de Windows conectado a Gateway |
| desactivado | activado | Solo servidor MCP local |
| activado | activado | Node de Gateway más servidor MCP local |
CLI y Gateway nativos de Windows
Para uso centrado en la terminal, instala OpenClaw desde PowerShell:gateway.cmd en el directorio de estado de OpenClaw, pero lo inicia
mediante un contenedor WScript gateway.vbs generado, de modo que el Gateway en segundo plano
no abre una ventana de consola visible. Si se deniega la creación de la tarea, OpenClaw
recurre a un elemento de inicio de sesión en la carpeta Inicio por usuario.
Instala el servicio Gateway:
Gateway WSL2
WSL2 sigue siendo el runtime de Gateway más compatible con Linux en Windows. Windows Hub puede configurar por ti un Gateway WSL propiedad de la aplicación, o puedes instalarlo manualmente dentro de tu propia distribución. Configuración manual:Inicio automático de Gateway antes del inicio de sesión de Windows
Para configuraciones WSL sin interfaz, asegúrate de que toda la cadena de arranque se ejecute aunque nadie inicie sesión en Windows. Dentro de WSL:Ubuntu por el nombre de tu distribución desde:
Dos cambios respecto a recetas anteriores:
dbus-launch trueen lugar de/bin/true: en WSL >= 2.6.1.0, una regresión (microsoft/WSL #13416) termina la distribución por inactividad 15-20 segundos después de que sale el último cliente, incluso con linger activado.dbus-launch truemantiene vivo un proceso hijo de init como solución alternativa (discusión de la comunidad, microsoft/WSL #9245)./ru "$env:USERNAME"en lugar de/ru SYSTEM: las distribuciones WSL por usuario (la configuración predeterminada) no son visibles para la cuenta SYSTEM, por lo que la tarea parece ejecutarse, pero la distribución nunca se inicia. Ejecutarla con tu propia cuenta evita esto; Windows solicita tu contraseña cuando se crea la tarea.
Exponer servicios WSL por LAN
WSL tiene su propia red virtual. Si otra máquina debe alcanzar un servicio dentro de WSL, reenvía un puerto de Windows a la IP actual de WSL. La IP de WSL puede cambiar después de reinicios, así que actualiza la regla de reenvío cuando sea necesario. Ejemplo en PowerShell como administrador:- SSH desde otra máquina apunta a la IP del host Windows, por ejemplo
ssh user@windows-host -p 2222. - Los Nodes remotos deben apuntar a una URL de Gateway alcanzable, no a
127.0.0.1. - Usa
listenaddress=0.0.0.0para acceso LAN,127.0.0.1para acceso solo local.
Solución de problemas
El icono de la bandeja no aparece
Comprueba en el Administrador de tareas si existeOpenClaw.Tray.WinUI.exe. Si está en ejecución, abre el
área de iconos ocultos de la bandeja y fíjalo. Si no, inicia OpenClaw Companion desde
el menú Inicio.
La configuración local falla
Abre el registro de configuración desde Windows Hub o inspecciona:La aplicación dice que se requiere emparejamiento
Aprueba la solicitud de operador o Node desde el Gateway:El chat web no puede alcanzar un Gateway remoto
El chat web remoto necesita HTTPS o localhost. Para certificados autofirmados, confía en el certificado en Windows o usa un túnel SSH hacia una URL localhost.Fallan los comandos screen.snapshot, cámara o audio
Confirma los permisos de Windows para cámara, micrófono, captura de pantalla y
notificaciones. Las instalaciones empaquetadas declaran las capacidades protegidas, pero
Windows aún puede solicitar confirmación la primera vez que un comando las usa.
Falla la conectividad con Git o GitHub
Algunas redes bloquean o limitan HTTPS hacia GitHub. Sigit clone o
gh auth login falla, prueba otra red, una VPN o un proxy HTTP/HTTPS.
Para autenticación de gh basada en token en la sesión actual: