Configuración inicial de la App para macOS

Configurar una herramienta nueva suele ser un proceso pesado que te quita tiempo de lo que realmente importa: programar. Quieres que el entorno esté listo para trabajar sin pelearte con permisos del sistema o archivos de configuración ocultos.

Esta guía te ayuda a completar la configuración inicial para que el agente empiece a funcionar de inmediato en tu Mac.

Requisitos previos

• macOS instalado.
• Node.js (npm o pnpm) si decides instalar la interfaz de línea de comandos.

Inicio rápido

Sigue estos pasos para completar el flujo de “día 0” y dejar el agente listo para operar:

1. Aprobar advertencias del sistema: Abre la aplicación y acepta los avisos de seguridad de macOS y el permiso para buscar dispositivos en redes locales.
2. Revisar el modelo de seguridad: Lee el aviso de seguridad. Por defecto, las nuevas configuraciones locales usan tools.profile: "coding". Esto permite que el agente use herramientas del sistema de archivos y runtime sin necesidad de usar el perfil full que no tiene restricciones.
3. Elegir la ubicación del Gateway:
   • This Mac (Local only): El asistente configura el auth y guarda las credenciales en tu máquina.
   • Remote (via SSH/Tailnet): El asistente no configura el auth local; las credenciales ya deben existir en el host donde corre el Gateway.
   • Configure later: Salta la configuración para hacerla después.
   • Nota sobre tokens: El asistente genera un token incluso para conexiones locales. Si decides desactivar el auth, cualquier proceso local podrá conectarse.
4. Gestionar permisos (TCC): Selecciona qué acceso quieres dar a OpenClaw. El sistema te pedirá permisos para:
   • Automation (AppleScript)
   • Notifications
   • Accessibility
   • Screen Recording
   • Microphone
   • Speech Recognition
   • Camera
   • Location
5. Instalar la CLI (Opcional): Puedes instalar la CLI global openclaw mediante npm o pnpm para integrar el flujo en tu terminal o tareas de launchd.
6. Sesión de chat inicial: Al terminar, se abrirá un chat dedicado donde el agente se presentará y te guiará en los siguientes pasos.

Solución de problemas

• Problemas de autenticación en el Gateway: Si usas accesos entre varias máquinas o conexiones que no sean loopback, asegúrate de usar un token. Sin auth, la seguridad depende totalmente de que la máquina sea de confianza.
• Configuración de herramientas: Si el agente no puede acceder a tus archivos, verifica que el perfil tools.profile esté en coding o superior.
• Contenido no confiable: Si activas webhooks o feeds de datos externos, usa un modelo de lenguaje moderno y mantén políticas estrictas de sandboxing para las herramientas.
• Permisos denegados: Si una función falla, revisa los permisos TCC en los Ajustes del Sistema de macOS para asegurar que OpenClaw tiene el acceso necesario.

AI Setup Assistant

Próximos pasos

• Onboarding Overview
• Security
• Bootstrapping