macOS companion app
Gateway no macOS
OpenClaw.app não inclui mais Node/Bun nem o runtime do Gateway. O app macOS
espera uma instalação externa da CLI openclaw, não inicia o Gateway como um
processo filho e gerencia um serviço launchd por usuário para manter o Gateway
em execução (ou se conecta a um Gateway local existente se já houver um em execução).
Instale a CLI (obrigatório para o modo local)
Node 24 é o runtime padrão no Mac. Node 22 LTS, atualmente 22.16+, ainda funciona por compatibilidade. Em seguida, instale openclaw globalmente:
npm install -g openclaw@<version>
O botão Instalar CLI do app macOS executa o mesmo fluxo de instalação global que o app usa internamente: ele prefere npm primeiro, depois pnpm, depois bun se esse for o único gerenciador de pacotes detectado. Node continua sendo o runtime recomendado para o Gateway.
Launchd (Gateway como LaunchAgent)
Rótulo:
ai.openclaw.gateway(ouai.openclaw.<profile>; o legadocom.openclaw.*pode permanecer)
Localização do plist (por usuário):
~/Library/LaunchAgents/ai.openclaw.gateway.plist(ou~/Library/LaunchAgents/ai.openclaw.<profile>.plist)
Gerenciador:
- O app macOS é responsável por instalar/atualizar o LaunchAgent no modo Local.
- A CLI também pode instalá-lo:
openclaw gateway install.
Comportamento:
- "OpenClaw Ativo" ativa/desativa o LaunchAgent.
- Sair do app não interrompe o gateway (o launchd o mantém ativo).
- Se um Gateway já estiver em execução na porta configurada, o app se conecta a ele em vez de iniciar um novo.
Logs:
- stdout/err do launchd:
/tmp/openclaw/openclaw-gateway.log
Compatibilidade de versões
O app macOS verifica a versão do gateway em relação à sua própria versão. Se elas forem incompatíveis, atualize a CLI global para corresponder à versão do app.
Verificação smoke
openclaw --version
OPENCLAW_SKIP_CHANNELS=1 \
OPENCLAW_SKIP_CANVAS_HOST=1 \
openclaw gateway --port 18999 --bind loopback
Em seguida:
openclaw gateway call health --url ws://127.0.0.1:18999 --timeout 3000