Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Configuración de desarrollo para macOS

Compila y ejecuta la aplicación de OpenClaw para macOS desde el código fuente.

​
Requisitos previos

Antes de compilar la aplicación, asegúrate de tener instalado lo siguiente:
  1. Xcode 26.2+: Necesario para el desarrollo en Swift.
  2. Node.js 24 y pnpm: Recomendado para el Gateway, la CLI y los scripts de empaquetado. Node 22 LTS, actualmente 22.16+, sigue siendo compatible por motivos de compatibilidad.

​
1. Instalar dependencias

Instala las dependencias de todo el proyecto: 
pnpm install

​
2. Compilar y empaquetar la aplicación

Para compilar la aplicación de macOS y empaquetarla en dist/OpenClaw.app, ejecuta: 
./scripts/package-mac-app.sh
Si no tienes un certificado de Apple Developer ID, el script usará automáticamente firma ad-hoc (-). Para modos de ejecución de desarrollo, opciones de firma y solución de problemas con el Team ID, consulta el README de la aplicación de macOS: https://github.com/openclaw/openclaw/blob/main/apps/macos/README.md
Nota: Las aplicaciones firmadas ad-hoc pueden activar avisos de seguridad. Si la aplicación se cierra inmediatamente con “Abort trap 6”, consulta la sección Solución de problemas.

​
3. Instalar la CLI

La aplicación de macOS espera una instalación global de la CLI openclaw para gestionar tareas en segundo plano. Para instalarla (recomendado):
  1. Abre la aplicación OpenClaw.
  2. Ve a la pestaña de configuración General.
  3. Haz clic en “Instalar CLI”.
También puedes instalarla manualmente: 
npm install -g openclaw@<version>
pnpm add -g openclaw@<version> y bun add -g openclaw@<version> también funcionan. Para el entorno de ejecución del Gateway, Node sigue siendo la ruta recomendada.

​
Solución de problemas

​
Error de compilación: incompatibilidad de cadena de herramientas o SDK

La compilación de la aplicación de macOS espera el SDK de macOS más reciente y la cadena de herramientas de Swift 6.2. Dependencias del sistema (obligatorias):
  • Última versión de macOS disponible en Actualización de software (requerida por los SDK de Xcode 26.2)
  • Xcode 26.2 (cadena de herramientas de Swift 6.2)
Comprobaciones: 
xcodebuild -version
xcrun swift --version
Si las versiones no coinciden, actualiza macOS/Xcode y vuelve a ejecutar la compilación.

​
La aplicación se bloquea al conceder permisos

Si la aplicación se bloquea cuando intentas permitir el acceso a Reconocimiento de voz o Micrófono, puede deberse a una caché TCC dañada o a una incompatibilidad de firma. Corrección:
  1. Restablece los permisos TCC: 
    tccutil reset All ai.openclaw.mac.debug
  2. Si eso falla, cambia temporalmente el BUNDLE_ID en scripts/package-mac-app.sh para forzar un “inicio limpio” desde macOS.

​
Gateway “Iniciando…” indefinidamente

Si el estado del Gateway se queda en “Iniciando…”, comprueba si un proceso zombi está ocupando el puerto: 
openclaw gateway status
openclaw gateway stop

# If you're not using a LaunchAgent (dev mode / manual runs), find the listener:
lsof -nP -iTCP:18789 -sTCP:LISTEN
Si una ejecución manual está ocupando el puerto, detén ese proceso (Ctrl+C). Como último recurso, termina el PID que encontraste arriba.

​
Relacionado