IPC de macOS

''Modelo actual:'' un socket Unix local conecta el ''servicio host de nodo'' a la ''app macOS'' para aprobaciones de exec + ''system.run''. Existe un CLI de debug ''openclaw-mac'' para verificaciones de descubrimiento/conexión; las acciones del agente aún fluyen a través del WebSocket del Gateway y ''node.invoke''. La automatización de UI usa PeekabooBridge.

- Instancia única de app GUI que posee todo el trabajo facing-TCC (notificaciones, grabación de pantalla, micrófono, voz, AppleScript).

- Una superficie pequeña para automatización: comandos de Gateway + nodo, más PeekabooBridge para automatización de UI.

- Permisos predecibles: siempre el mismo bundle ID firmado, lanzado por launchd, para que las concesiones TCC persistan.

#

- La app ejecuta el Gateway (modo local) y se conecta a él como un nodo.

- Las acciones del agente se realizan vía ''node.invoke'' (ej. ''system.run'', ''system.notify'', ''canvas.*'').

#

- Un servicio host de nodo headless se conecta al WebSocket del Gateway.

- Las solicitudes ''system.run'' se reenvían a la app macOS sobre un socket Unix local.

- La app ejecuta el exec en contexto de UI, solicita si es necesario, y retorna la salida.

Diagrama (SCI):

Agent -> Gateway -> Node Service (WS)
                      |  IPC (UDS + token + HMAC + TTL)
                      v
                  Mac App (UI + TCC + system.run)

#

- La automatización de UI usa un socket UNIX separado llamado ''bridge.sock'' y el protocolo JSON de PeekabooBridge.

- Orden de preferencia de host (lado cliente): Peekaboo.app → Claude.app → OpenClaw.app → ejecución local.

- Seguridad: los hosts del bridge requieren un TeamID permitido; el escape hatch same-UID solo-DEBUG está protegido por ''PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1'' (convención de Peekaboo).

- Ver: ''Uso de PeekabooBridge'' para detalles.

- Reiniciar/reconstruir: ''SIGN_IDENTITY="Apple Development: <Nombre de Desarrollador> (<TEAMID>)" scripts/restart-mac.sh''

- Mata instancias existentes

- Build Swift + empaquetado

- Escribe/bootstrap/kickstart el LaunchAgent

- Instancia única: la app termina temprano si otra instancia con el mismo bundle ID está ejecutándose.

- Preferir requerir coincidencia de TeamID para todas las superficies privilegiadas.

- PeekabooBridge: ''PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1'' (solo DEBUG) puede permitir llamadores same-UID para desarrollo local.

- Toda comunicación permanece solo local; no se exponen sockets de red.

- Los prompts de TCC se originan solo desde el bundle de la app GUI; mantén el bundle ID firmado estable entre reconstrucciones.

- Endurecimiento de IPC: modo de socket ''0600'', token, verificaciones de peer-UID, challenge/response HMAC, TTL corto.