Como instalar o OpenClaw em um Mac mini

O que é o OpenClaw

O OpenClaw é um assistente de IA de código aberto que roda no seu próprio computador. Você conversa com ele pelos apps de chat que já usa. O README lista Discord, iMessage, Slack, Teams, Telegram e WhatsApp, além de mais de 20 outros (github.com/openclaw/openclaw, outubro de 2026).

A peça central é o Gateway. Ele é um processo de longa duração que mantém as suas conexões de chat e roda o agente. Se o Gateway para, o assistente para de responder. Por isso a máquina onde ele fica importa mais que a instalação.

Requisitos

• Node 24.16 ou mais novo, ou Node 26.1 ou mais novo. O instalador adiciona o Node 26 no macOS se o Node estiver faltando (docs.openclaw.ai/install, outubro de 2026).
• Um provedor de modelo. O OpenClaw recebe uma API key do provedor que você escolhe durante o onboarding.
• Qualquer Mac com Apple silicon. A documentação não define memória mínima. Com um modelo na nuvem, 16 GB sobram. Um modelo local é outra história, tratada no nosso guia de LLM local.

Instale

Rode o instalador oficial no Terminal.

curl -fsSL https://openclaw.ai/install.sh | bash

Quando termina, ele leva você ao onboarding. Para instalar primeiro e configurar depois, a documentação dá uma flag que pula o onboarding. Depois rode o onboarding você mesmo com a opção de serviço.

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
openclaw onboard --install-daemon

Rodamos o instalador em uma máquina macOS 26 nova hospedada pelo GitHub em 2 de outubro de 2026. O Node já estava lá, então levou cerca de 25 segundos. Isto é o que a verificação de versão mostrou.

$ openclaw --version
OpenClaw 2026.9.7 (c074824)

Depois confira a instalação e o serviço com os comandos documentados.

openclaw doctor
openclaw gateway status

Na nossa máquina de teste, o doctor apontou três coisas antes do onboarding. O modo do Gateway não estava definido. A autenticação do Gateway não tinha token. E nenhum dono de comandos estava definido. Rode o doctor de novo depois do onboarding e resolva o que sobrar. Leve o dono a sério. O doctor descreve essa conta como a que pode mudar a configuração, reiniciar o Gateway e aprovar comandos.

Mantenha rodando 24/7

A opção de serviço instala um LaunchAgent. A documentação informa o label ai.openclaw.gateway e o arquivo ai.openclaw.gateway.plist na pasta LaunchAgents da Library da sua pasta pessoal. O launchd inicia o serviço no login e reinicia se ele travar. Os logs vão para um único arquivo.

openclaw gateway status --deep
openclaw gateway restart
openclaw health
tail -f ~/Library/Logs/openclaw/gateway.log

Você também pode instalar só o serviço, sem onboarding. Fizemos isso em uma segunda máquina de teste. Definimos o modo do Gateway como local, deixamos o doctor gerar um token e rodamos o comando de instalação.

openclaw config set gateway.mode local
openclaw doctor --fix --generate-gateway-token
openclaw gateway install

Uns 15 segundos depois, o comando de status mostrou o serviço no ar.

$ openclaw gateway status
Service file: ~/Library/LaunchAgents/ai.openclaw.gateway.plist
Gateway: bind=loopback (127.0.0.1), port=18789 (service args)
Dashboard: http://127.0.0.1:18789/
Gateway version: 2026.9.7
Runtime: running (pid 16165, state active)
Connectivity probe: ok
Listening: 127.0.0.1:18789

Um LaunchAgent só roda enquanto um usuário está logado. Depois de reinicializar, nada inicia até alguém entrar. Em um Mac sem ninguém por perto, ative o login automático para a conta que roda o OpenClaw. Depois impeça a máquina de entrar em repouso, porque o repouso congela o Gateway e derruba todas as conexões de chat.

sudo pmset -a sleep 0
sudo pmset -a disksleep 0
sudo pmset -a displaysleep 10

Os motivos e as regras da tampa do notebook estão em o que acontece quando um Mac entra em repouso. A lista completa, incluindo quedas de energia, está no guia do Mac sempre ligado.

Notas de segurança

• Em uma instalação normal, o Gateway escuta só no loopback. Deixe assim. Para acessar o painel do seu notebook, a documentação usa um túnel SSH.
• Remetentes desconhecidos em mensagens diretas recebem um código de pareamento, não uma resposta. Você aprova essas pessoas com o comando de pareamento abaixo.
• As ferramentas rodam no host por padrão, a menos que você configure um sandbox. O agente pode mexer em tudo que esse usuário do macOS pode mexer.
• Os segredos ficam no disco, na pasta de estado do OpenClaw, com a configuração em openclaw.json dentro dela. Trate essa pasta como um arquivo de senhas.
• Rode a auditoria embutida depois de cada mudança de configuração. Na nossa instalação de teste nova, ela informou 0 itens críticos, 1 aviso e 1 item informativo.

ssh -N -L 18789:127.0.0.1:18789 user@gateway-host
openclaw pairing approve <channel> <code>
openclaw security audit

A proteção mais simples é física. Rode o OpenClaw em um Mac que não guarda mais nada seu. Sem Apple ID pessoal, sem gerenciador de senhas, sem navegador cheio de logins. Se o agente fizer algo estranho, o estrago fica nessa máquina.

Rodando em um Mac da MacRun

Nosso plano agente é um Mac mini dedicado que nunca entra em repouso. A sessão de login volta sozinha depois de reinicializar, então os LaunchAgents iniciam de novo. Ele vem com Claude Code e Codex instalados. O OpenClaw não vem pré-instalado. Você mesmo instala com os comandos acima, porque tem acesso total de administrador. O OpenClaw precisa de uma API key do provedor de modelo que você escolhe durante o onboarding.

No plano agente, o OpenClaw pode trabalhar nas suas próprias contas. Isso inclui o seu email, o seu calendário e os seus chats. Ele também pode escrever código, acompanhar o CI ou fazer a triagem de issues. O que não é permitido são mensagens em massa ou não solicitadas, conforme a nossa política de uso aceitável. Quem não deve usar a gente para isso: o OpenClaw roda no Linux. Se você não precisa de nada do macOS, um pequeno servidor Linux custa menos que qualquer Mac.

Quer testar em uma máquina que fica no ar? Compare os planos na página do Mac para agentes.