Platforms overview
app de macOS
La app de macOS es la compañera de barra de menús de OpenClaw. Úsala cuando quieras una
interfaz nativa de bandeja, solicitudes de permisos de macOS, notificaciones, WebChat, entrada de voz,
Canvas o herramientas de nodo alojadas en Mac, como system.run.
Si solo necesitas la CLI y el Gateway, empieza con Primeros pasos.
Descarga
Descarga las compilaciones de la app de macOS desde los lanzamientos de OpenClaw en GitHub. Cuando un lanzamiento incluya recursos de la app de macOS, busca:
OpenClaw-<version>.dmg(preferido)OpenClaw-<version>.zip
Algunos lanzamientos solo incluyen recursos de CLI, evidencia o Windows. Si el lanzamiento más reciente no tiene ningún recurso de la app de macOS, usa el lanzamiento más reciente que sí lo tenga, o compila la app desde el código fuente con configuración de desarrollo de macOS.
Primera ejecución
- Instala e inicia OpenClaw.app.
- Elige Este Mac para un Gateway local, o conéctate a un Gateway remoto.
- En modo local, espera mientras la app instala su runtime de espacio de usuario y Gateway.
- Completa la configuración del proveedor y la lista de comprobación de permisos de macOS.
- Envía el mensaje de prueba de incorporación.
Para la ruta de configuración de la CLI/Gateway, usa Primeros pasos. Para recuperar permisos, usa permisos de macOS.
Elige un modo de Gateway
| Modo | Cuándo usarlo | Página de detalles |
|---|---|---|
| Local | Este Mac debe ejecutar el Gateway y mantenerlo activo con launchd. | Gateway en macOS |
| Remoto | Otro host ejecuta el Gateway y este Mac debe controlarlo por SSH, LAN o Tailnet. | Control remoto |
El modo local requiere una CLI openclaw instalada. En un Mac nuevo, la app instala
automáticamente la CLI y el runtime correspondientes antes de iniciar el asistente del Gateway.
Consulta Gateway en macOS para recuperación manual.
Qué gestiona la app
- Estado de la barra de menús, notificaciones, estado de salud y WebChat.
- Solicitudes de permisos de macOS para pantalla, micrófono, voz, automatización y accesibilidad.
- Herramientas de nodo locales como Canvas, captura de cámara/pantalla, notificaciones y
system.run. - Solicitudes de aprobación de ejecución para comandos alojados en Mac.
- Túneles SSH en modo remoto o conexiones directas al Gateway.
La app no sustituye al Gateway de OpenClaw ni a la documentación general de la CLI. La configuración principal del Gateway, los proveedores, plugins, canales, herramientas y seguridad tienen su propia documentación.
Páginas detalladas de macOS
| Tarea | Leer |
|---|---|
| Instalar o depurar el servicio CLI/Gateway | Gateway en macOS |
| Mantener el estado fuera de carpetas sincronizadas con la nube | Gateway en macOS |
| Depurar el descubrimiento y la conectividad de la app | Gateway en macOS |
| Entender el comportamiento de launchd | Ciclo de vida del Gateway |
| Corregir permisos o problemas de firma/TCC | permisos de macOS |
| Conectarse a un Gateway remoto | Control remoto |
| Leer el estado de la barra de menús y las comprobaciones de salud | Barra de menús, Comprobaciones de salud |
| Usar la interfaz de chat integrada | WebChat |
| Usar activación por voz o pulsar para hablar | Activación por voz |
| Usar Canvas y enlaces profundos de Canvas | Canvas |
| Alojar PeekabooBridge para automatización de interfaz | Puente Peekaboo |
| Configurar aprobaciones de comandos | Aprobaciones de ejecución, detalles avanzados |
| Inspeccionar comandos de nodo de Mac e IPC de la app | IPC de macOS |
| Capturar registros | Registro de macOS |
| Compilar desde el código fuente | Configuración de desarrollo de macOS |
