Aplicación para macOS

La app para macOS es el complemento de barra de menús de OpenClaw: interfaz nativa en la bandeja, solicitudes de permisos de macOS, notificaciones, WebChat, entrada de voz, Canvas y herramientas de Node alojadas en el Mac, como system.run.

Use Chat rápido para disponer de un editor de la sesión principal al estilo de Spotlight sin abrir una ventana completa. Pulse Opción-Espacio (⌥Espacio) de forma predeterminada, selecciónelo en el menú de la barra de menús o registre otro atajo en Configuración → General.

¿Solo necesita la CLI y el Gateway? Comience con Primeros pasos.

Descarga

Obtenga las compilaciones de la app para macOS en las versiones de OpenClaw en GitHub. Cuando una versión incluya recursos de la app para macOS, busque:

• OpenClaw-<version>.dmg (preferido)
• OpenClaw-<version>.zip

Algunas versiones solo incluyen la CLI, pruebas o recursos para Windows. Si la versión más reciente no tiene un recurso de la app para macOS, use la versión más reciente que sí lo tenga o compile desde el código fuente con la configuración de desarrollo para macOS.

Primera ejecución

1. Instale e inicie OpenClaw.app.
2. Elija Este Mac para usar un Gateway local o conéctese a un Gateway remoto.
3. Espere mientras la app instala el entorno de ejecución de la CLI correspondiente. En el modo local, también instala e inicia el Gateway.
4. Establezca la inferencia mediante una comprobación de un modelo activo. Una vez superada, OpenClaw se encarga del resto de la configuración.
5. Complete la lista de permisos de macOS y envíe el mensaje de prueba de incorporación.

Si la app accede a un Gateway existente cuyo agente predeterminado tiene un modelo configurado, considera que ese Gateway ya está configurado, omite la incorporación del proveedor y de OpenClaw y abre el panel. Si no puede conectarse al Gateway o su agente predeterminado no tiene ningún modelo, la incorporación de inferencia continúa disponible para la recuperación.

Para la ruta de configuración de la CLI y el Gateway, use Primeros pasos. Para recuperar los permisos, consulte Permisos de macOS.

Actualizaciones

La tarjeta de actualización del panel indica qué actualizará la app:

• Actualizar la app para Mac y el Gateway significa que la app firmada controla el Gateway local mediante launchd. Sparkle actualiza primero la app; después de reiniciarse, la app actualiza y reinicia automáticamente su Gateway con la versión correspondiente y, a continuación, verifica la conexión.
• Actualizar el Gateway significa que la app está conectada a un Gateway remoto, a un Gateway local administrado manualmente o a otra instalación que la app no controla. El botón ejecuta el flujo de actualización normal de ese Gateway en lugar de modificar la app para Mac.

Una actualización coordinada fallida permanece en su ventana de configuración con acciones para reintentar, consultar la guía de actualización y acceder a Discord. La reparación automática nunca revierte un Gateway más reciente ni anula una fijación del canal extended-stable.

Después de una actualización correcta, la app busca la sesión directa de nivel superior que una persona haya utilizado más recientemente y envía a ese agente un evento de actualización único. La actividad de Heartbeat y Cron no afecta a esta selección. A continuación, el agente puede darle la bienvenida de nuevo desde la conversación que probablemente estaba utilizando. En el modo remoto, la app solo actualiza el entorno de ejecución del Node local del Mac y omite la notificación cuando el Gateway remoto es anterior a la app.

Sparkle sigue la configuración update.channel del Gateway. beta y dev habilitan las compilaciones beta de la app; stable, extended-stable y los valores ausentes o desconocidos mantienen las compilaciones estables de la app.

Abrir enlaces del panel

En el panel integrado de la app para macOS, al hacer clic en un enlace web externo, este se abre en una barra lateral redimensionable del navegador que ocupa la mitad del ancho de la ventana y mantiene visible la navegación del panel. Arrastre el separador para elegir otro ancho; la app lo recuerda. Cada enlace se abre en su propia pestaña, la barra de pestañas aparece cuando hay varias páginas abiertas y, al volver a hacer clic en el mismo enlace, se reutiliza la pestaña existente. Arrastre las pestañas para reordenarlas, ciérrelas mediante el botón de cierre de la pestaña o con un clic central y haga clic con el botón derecho en una pestaña para acceder a Abrir en el navegador predeterminado, Copiar enlace, Recargar, Cerrar pestaña y Cerrar las demás pestañas. Los controles de retroceso y avance de la barra de título de la ventana y los gestos del trackpad permiten desplazarse por el historial del panel; los controles de retroceso y avance propios de la barra lateral permiten desplazarse por el historial de la pestaña activa. La barra lateral también incluye controles para recargar, abrir en el navegador predeterminado y cerrar.

Los controles de la barra de título siguen a la barra lateral de la app: cuando está expandida, los botones de retroceso y avance se sitúan en su borde derecho, junto al control de la barra lateral; cuando está contraída, dejan espacio para un botón de búsqueda, que abre la paleta de comandos, y un botón de nueva sesión.

Haga clic con el botón derecho en un enlace externo para elegir Abrir en la barra lateral, Abrir en el navegador predeterminado o Copiar enlace. Los clics con teclas modificadoras y los enlaces de nueva ventana activados por el usuario desde el panel continúan abriéndose en el navegador predeterminado; los enlaces de nueva ventana dentro de la barra lateral se abren como nuevas pestañas de la barra lateral. Las páginas normales de la interfaz de control alojadas en el navegador conservan el comportamiento habitual del navegador para los enlaces y los menús contextuales.

Importar inicios de sesión del navegador

La primera vez que se abre la barra lateral del navegador mientras la app utiliza un Gateway local, el panel muestra un aviso descartable si existe en el Mac un perfil de la familia de Chrome que contenga cookies. El aviso permite copiar esas cookies en un perfil administrado y aislado que los agentes utilizan para navegar. Elija un perfil mediante su control Importar; es posible que se requiera Touch ID. El progreso y la cantidad de cookies importadas aparecen en línea, y solo se copian las cookies: las contraseñas nunca salen del navegador de origen. Al descartar el aviso, se registra la elección; Configuración → General → Inicio de sesión del navegador → Importar… vuelve a ofrecerla en cualquier momento. Consulte Navegador para conocer el flujo de importación subyacente y la condición browser.allowSystemProfileImport.

Elegir un modo de Gateway

Ambos modos necesitan una CLI openclaw instalada porque la app reutiliza su entorno de ejecución del host de Node. En un Mac nuevo, la app instala automáticamente la CLI correspondiente; a continuación, el modo local inicia el asistente del Gateway, mientras que el modo remoto se conecta al Gateway seleccionado sin iniciar un segundo Gateway local. Consulte Gateway en macOS para realizar una recuperación manual.

Qué controla la app

• Estado de la barra de menús, notificaciones, estado del sistema, WebChat y la barra flotante de Chat rápido.
• Solicitudes de permisos de macOS para la pantalla, el micrófono, el habla, la automatización y la accesibilidad.
• Un Node de Mac que combina Canvas nativo, captura de cámara y pantalla, notificaciones, ubicación y control del equipo con los comandos de sistema, navegador, Plugin, Skills y MCP del host de Node de la CLI.
• Solicitudes de aprobación de ejecución para comandos alojados en el Mac.
• Ejecución en el contexto de la app para comandos de shell aprobados, que conserva la atribución de permisos de macOS de la app mientras el entorno de ejecución de la CLI controla la política compartida del Node.
• Túneles SSH o conexiones directas al Gateway en el modo remoto.

En la interfaz de control integrada, Configuración → Notificaciones muestra el permiso de notificaciones nativo de la app en lugar de las notificaciones push del navegador, porque la app entrega las notificaciones de forma nativa.

La app no sustituye la documentación del Gateway ni la documentación general de la CLI. La configuración del Gateway, los proveedores, los plugins, los canales, las herramientas y la seguridad se describen en su propia documentación.

Páginas detalladas de macOS

Contenido relacionado

• Plataformas
• Primeros pasos
• Gateway
• Aprobaciones de ejecución