> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# aplicación para macOS

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

¿Solo necesitas la CLI y el Gateway? Empieza con [Primeros pasos](/es/start/getting-started).

## Descarga

Obtén las compilaciones de la app de macOS desde las [versiones de OpenClaw en GitHub](https://github.com/openclaw/openclaw/releases).
Cuando una versión incluya recursos de la app de macOS, busca:

* `OpenClaw-<version>.dmg` (preferido)
* `OpenClaw-<version>.zip`

Algunas versiones solo incluyen recursos de CLI, evidencia o Windows. Si la versión más reciente
no tiene ningún recurso de la app de macOS, usa la más reciente que sí lo tenga, o compila desde el código fuente con
[configuración de desarrollo de macOS](/es/platforms/mac/dev-setup).

## Primera ejecución

1. Instala e inicia **OpenClaw\.app**.
2. Elige **This Mac** para un Gateway local, o conéctate a un Gateway remoto.
3. Modo local: espera mientras la app instala su entorno de ejecución en espacio de usuario y el Gateway.
4. Completa la configuración del proveedor y la lista de verificación de permisos de macOS.
5. Envía el mensaje de prueba de incorporación.

Para la ruta de configuración de CLI/Gateway, usa [Primeros pasos](/es/start/getting-started).
Para recuperar permisos, usa [permisos de macOS](/es/platforms/mac/permissions).

## Elige un modo de Gateway

| Modo   | Úsalo cuando                                                               | Página de detalles                                    |
| ------ | -------------------------------------------------------------------------- | ----------------------------------------------------- |
| Local  | Este Mac debe ejecutar el Gateway y mantenerlo activo con launchd.         | [Gateway en macOS](/es/platforms/mac/bundled-gateway) |
| Remoto | Otro host ejecuta el Gateway; este Mac lo controla por SSH, LAN o Tailnet. | [Control remoto](/es/platforms/mac/remote)            |

El modo local necesita una CLI `openclaw` instalada. En un Mac nuevo, la app instala
automáticamente la CLI y el entorno de ejecución correspondientes antes de iniciar el asistente de Gateway.
Consulta [Gateway en macOS](/es/platforms/mac/bundled-gateway) para la 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 locales de Node: 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 ni a la documentación general de la CLI. La
configuración del Gateway, 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](/es/platforms/mac/bundled-gateway)                                                          |
| Mantener el estado fuera de carpetas sincronizadas en la nube     | [Gateway en macOS](/es/platforms/mac/bundled-gateway#state-directory-on-macos)                                 |
| Depurar el descubrimiento y la conectividad de la app             | [Gateway en macOS](/es/platforms/mac/bundled-gateway#debug-app-connectivity)                                   |
| Entender el comportamiento de launchd                             | [Ciclo de vida del Gateway](/es/platforms/mac/child-process)                                                   |
| Corregir permisos o problemas de firma/TCC                        | [permisos de macOS](/es/platforms/mac/permissions)                                                             |
| Conectarse a un Gateway remoto                                    | [Control remoto](/es/platforms/mac/remote)                                                                     |
| Leer el estado de la barra de menús y las comprobaciones de salud | [Barra de menús](/es/platforms/mac/menu-bar), [Comprobaciones de salud](/es/platforms/mac/health)              |
| Usar la interfaz de chat integrada                                | [WebChat](/es/platforms/mac/webchat)                                                                           |
| Usar activación por voz o pulsar para hablar                      | [Activación por voz](/es/platforms/mac/voicewake)                                                              |
| Usar Canvas y enlaces profundos de Canvas                         | [Canvas](/es/platforms/mac/canvas)                                                                             |
| Alojar PeekabooBridge para automatización de UI                   | [Puente Peekaboo](/es/platforms/mac/peekaboo)                                                                  |
| Configurar aprobaciones de comandos                               | [Aprobaciones de ejecución](/es/tools/exec-approvals), [detalles avanzados](/es/tools/exec-approvals-advanced) |
| Inspeccionar comandos de Node de Mac e IPC de la app              | [IPC de macOS](/es/platforms/mac/xpc)                                                                          |
| Capturar registros                                                | [Registro de macOS](/es/platforms/mac/logging)                                                                 |
| Compilar desde el código fuente                                   | [configuración de desarrollo de macOS](/es/platforms/mac/dev-setup)                                            |

## Relacionado

* [Plataformas](/es/platforms)
* [Primeros pasos](/es/start/getting-started)
* [Gateway](/es/gateway)
* [Aprobaciones de ejecución](/es/tools/exec-approvals)
