---
read_when:
    - Configuración del entorno de desarrollo de macOS
summary: Guía de configuración para desarrolladores que trabajan en la aplicación de OpenClaw para macOS
title: Configuración de desarrollo en macOS
x-i18n:
    generated_at: "2026-07-11T23:15:11Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: bd7d556af92892d3deea3f5d8238a33cd413e10b0b377468396221e174ace8fe
    source_path: platforms/mac/dev-setup.md
    workflow: 16
---

# Configuración de desarrollo para macOS

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

## Requisitos previos

- **Xcode 26.2+** (cadena de herramientas de Swift 6.2), en la versión más reciente de macOS disponible en
  Software Update.
- **Node.js 24 y pnpm** para el Gateway, la CLI y los scripts de empaquetado. Node
  22.19+ también funciona.

## 1. Instalar las dependencias

```bash
pnpm install
```

## 2. Compilar y empaquetar la aplicación

```bash
./scripts/package-mac-app.sh
```

Genera `dist/OpenClaw.app`. Si no hay un certificado de Apple Developer ID, el
script recurre a una firma ad hoc.

Para conocer los modos de ejecución de desarrollo, las opciones de firma y la resolución de problemas del ID de equipo, consulta
[apps/macos/README.md](https://github.com/openclaw/openclaw/blob/main/apps/macos/README.md).
Ciclo rápido de desarrollo desde la raíz del repositorio: `scripts/restart-mac.sh` (añade `--no-sign` para
usar una firma ad hoc; los permisos de TCC no se conservan con `--no-sign`).

<Note>
Las aplicaciones con firma ad hoc pueden activar avisos de seguridad. Si la aplicación se bloquea
inmediatamente con "Abort trap 6", consulta [Solución de problemas](#troubleshooting).
</Note>

## 3. Instalar la CLI y el Gateway

La aplicación empaquetada incluye el instalador canónico `scripts/install-cli.sh`. En un
perfil nuevo, selecciona **This Mac** durante la incorporación; la aplicación instala la
CLI y el entorno de ejecución correspondientes en el espacio del usuario antes de iniciar el asistente del Gateway.

Para la recuperación manual durante el desarrollo, instala tú mismo la CLI correspondiente:

```bash
npm install -g openclaw@<version>
```

`pnpm add -g openclaw@<version>` y `bun add -g openclaw@<version>` también
funcionan. Node sigue siendo el entorno de ejecución recomendado para el propio Gateway.

## Solución de problemas

### Error de compilación: incompatibilidad de la cadena de herramientas o del SDK

La compilación de la aplicación para macOS requiere el SDK más reciente de macOS y la cadena de herramientas
de Swift 6.2 (Xcode 26.2+).

```bash
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 al intentar permitir el acceso a **Speech Recognition** o
**Microphone**, puede deberse a una caché de TCC dañada o a una incompatibilidad de firma.

1. Restablece los permisos de TCC para el identificador del paquete de depuración:

   ```bash
   tccutil reset All ai.openclaw.mac.debug
   ```

2. Si eso falla, cambia temporalmente `BUNDLE_ID` en
   [`scripts/package-mac-app.sh`](https://github.com/openclaw/openclaw/blob/main/scripts/package-mac-app.sh)
   para forzar que macOS parta de cero.

### El Gateway permanece en "Starting..." indefinidamente

Comprueba si un proceso zombi mantiene ocupado el puerto:

```bash
openclaw gateway status
openclaw gateway stop

# Si no utilizas un LaunchAgent (modo de desarrollo / ejecuciones manuales), busca el proceso que escucha:
lsof -nP -iTCP:18789 -sTCP:LISTEN
```

Si una ejecución manual mantiene ocupado el puerto, detenla (Ctrl+C) o, como
último recurso, termina el PID encontrado anteriormente.

## Recursos relacionados

- [Aplicación para macOS](/es/platforms/macos)
- [Descripción general de la instalación](/es/install)