> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ciclo de vida do Gateway no macOS

O app para macOS **gerencia o Gateway via launchd** por padrão e não inicia
o Gateway como um processo filho. Primeiro, ele tenta se conectar a um
Gateway já em execução na porta configurada; se nenhum estiver acessível, ele habilita o serviço
launchd via CLI externa `openclaw` (sem runtime incorporado). Isso fornece
inicialização automática confiável no login e reinicialização em caso de falhas.

O modo de processo filho (Gateway iniciado diretamente pelo app) **não está em uso** hoje.
Se você precisa de um acoplamento mais estreito com a UI, execute o Gateway manualmente em um terminal.

## Comportamento padrão (launchd)

* O app instala um LaunchAgent por usuário rotulado como `ai.openclaw.gateway`
  (ou `ai.openclaw.<profile>` ao usar `--profile`/`OPENCLAW_PROFILE`; o legado `com.openclaw.*` é compatível).
* Quando o modo Local está habilitado, o app garante que o LaunchAgent esteja carregado e
  inicia o Gateway se necessário.
* Os logs são gravados no caminho de log do gateway do launchd (visível nas Configurações de depuração).

Comandos comuns:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
launchctl kickstart -k gui/$UID/ai.openclaw.gateway
launchctl bootout gui/$UID/ai.openclaw.gateway
```

Substitua o rótulo por `ai.openclaw.<profile>` ao executar um perfil nomeado.

## Builds de desenvolvimento não assinadas

`scripts/restart-mac.sh --no-sign` é usado para builds locais rápidas quando você não tem
chaves de assinatura. Para impedir que o launchd aponte para um binário de retransmissão não assinado, ele:

* Grava `~/.openclaw/disable-launchagent`.

Execuções assinadas de `scripts/restart-mac.sh` removem essa substituição se o marcador estiver
presente. Para redefinir manualmente:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
rm ~/.openclaw/disable-launchagent
```

## Modo somente conexão

Para forçar o app para macOS a **nunca instalar nem gerenciar o launchd**, inicie-o com
`--attach-only` (ou `--no-launchd`). Isso define `~/.openclaw/disable-launchagent`,
então o app apenas se conecta a um Gateway já em execução. Você pode alternar o mesmo
comportamento nas Configurações de depuração.

## Modo remoto

O modo remoto nunca inicia um Gateway local. O app usa um túnel SSH para o
host remoto e se conecta por esse túnel.

## Por que preferimos launchd

* Inicialização automática no login.
* Semântica integrada de reinicialização/KeepAlive.
* Logs e supervisão previsíveis.

Se um verdadeiro modo de processo filho for necessário novamente algum dia, ele deverá ser documentado como um
modo separado, explícito e exclusivo para desenvolvimento.

## Relacionado

* [app para macOS](/pt-BR/platforms/macos)
* [runbook do Gateway](/pt-BR/gateway)