---
read_when:
    - Diseñar el asistente de incorporación de macOS
    - Implementar la autenticación o la configuración de identidad
sidebarTitle: 'Onboarding: macOS App'
summary: Flujo de configuración inicial para OpenClaw (aplicación de macOS)
title: Incorporación (aplicación de macOS)
x-i18n:
    generated_at: "2026-04-05T12:54:09Z"
    model: gpt-5.4
    provider: openai
    source_hash: a3c5f313a8e5c3a2e68a9488f07c40fcdf75b170dc868c7614565ad9f67755d6
    source_path: start/onboarding.md
    workflow: 15
---

# Incorporación (aplicación de macOS)

Este documento describe el flujo **actual** de configuración en la primera ejecución. El objetivo es ofrecer una
experiencia fluida desde el “día 0”: elegir dónde se ejecuta el Gateway, conectar la autenticación, ejecutar el
asistente y dejar que el agente se inicialice por sí solo.
Para obtener una visión general de las rutas de incorporación, consulta [Información general de la incorporación](/start/onboarding-overview).

<Steps>
<Step title="Aprobar advertencia de macOS">
<Frame>
<img src="/assets/macos-onboarding/01-macos-warning.jpeg" alt="" />
</Frame>
</Step>
<Step title="Aprobar buscar redes locales">
<Frame>
<img src="/assets/macos-onboarding/02-local-networks.jpeg" alt="" />
</Frame>
</Step>
<Step title="Bienvenida y aviso de seguridad">
<Frame caption="Lee el aviso de seguridad mostrado y decide en consecuencia">
<img src="/assets/macos-onboarding/03-security-notice.png" alt="" />
</Frame>

Modelo de confianza de seguridad:

- De forma predeterminada, OpenClaw es un agente personal: un límite de operador de confianza.
- Las configuraciones compartidas/multiusuario requieren endurecimiento (separar límites de confianza, mantener el acceso a herramientas al mínimo y seguir [Seguridad](/es/gateway/security)).
- La incorporación local ahora establece de forma predeterminada las configuraciones nuevas con `tools.profile: "coding"` para que las configuraciones locales nuevas conserven herramientas de sistema de archivos/entorno de ejecución sin forzar el perfil `full` sin restricciones.
- Si se habilitan hooks/webhooks u otras fuentes de contenido no confiables, usa un nivel de modelo moderno y sólido y mantén una política de herramientas estricta/sandboxing.

</Step>
<Step title="Local vs Remoto">
<Frame>
<img src="/assets/macos-onboarding/04-choose-gateway.png" alt="" />
</Frame>

¿Dónde se ejecuta el **Gateway**?

- **Este Mac (solo local):** la incorporación puede configurar la autenticación y escribir credenciales
  localmente.
- **Remoto (por SSH/Tailnet):** la incorporación **no** configura la autenticación local;
  las credenciales deben existir en el host del gateway.
- **Configurar más tarde:** omite la configuración y deja la aplicación sin configurar.

<Tip>
**Consejo sobre autenticación del Gateway:**

- El asistente ahora genera un **token** incluso para loopback, por lo que los clientes WS locales deben autenticarse.
- Si desactivas la autenticación, cualquier proceso local puede conectarse; úsalo solo en máquinas de total confianza.
- Usa un **token** para acceso desde varias máquinas o enlaces que no sean loopback.

</Tip>
</Step>
<Step title="Permisos">
<Frame caption="Elige qué permisos quieres dar a OpenClaw">
<img src="/assets/macos-onboarding/05-permissions.png" alt="" />
</Frame>

La incorporación solicita los permisos TCC necesarios para:

- Automatización (AppleScript)
- Notificaciones
- Accesibilidad
- Grabación de pantalla
- Micrófono
- Reconocimiento de voz
- Cámara
- Ubicación

</Step>
<Step title="CLI">
  <Info>Este paso es opcional</Info>
  La aplicación puede instalar la CLI global `openclaw` mediante npm, pnpm o bun.
  Prefiere primero npm, luego pnpm y después bun si ese es el único
  gestor de paquetes detectado. Para el tiempo de ejecución del Gateway, Node sigue siendo la ruta recomendada.
</Step>
<Step title="Chat de incorporación (sesión dedicada)">
  Después de la configuración, la aplicación abre una sesión de chat de incorporación dedicada para que el agente pueda
  presentarse y guiar los siguientes pasos. Esto mantiene la orientación de la primera ejecución separada
  de tu conversación normal. Consulta [Inicialización](/start/bootstrapping) para ver
  qué sucede en el host del gateway durante la primera ejecución del agente.
</Step>
</Steps>
