Como instalar e executar o OpenClaw (anteriormente Clawdbot/Moltbot) no Mac

OpenClaw é um gateway de código aberto e auto-hospedado que conecta seus aplicativos de mensagens do dia a dia a agentes de codificação de IA. Em vez de alternar entre abas, aplicativos e interfaces, você envia uma mensagem pelo WhatsApp ou Telegram e recebe uma resposta com tecnologia de IA direto no seu bolso. Ele tem licença MIT, roda no seu hardware e mantém você no controle total dos seus dados.

Neste tutorial, vamos percorrer tudo o que você precisa para instalar e executar o OpenClaw no macOS — dos pré-requisitos ao seu primeiro chat funcionando.

O Que Você Vai Precisar

Antes de começar, certifique-se de ter o seguinte:

• macOS (qualquer versão recente)
• Node.js 22 ou mais recente — o script de instalação cuidará disso para você se ainda não estiver instalado, mas é bom verificar
• Uma chave de API — a Anthropic é recomendada pela equipe do OpenClaw
• Cerca de 5 minutos do seu tempo

Para verificar sua versão atual do Node, abra o Terminal e execute:

node --version

Se você vir v22.x.x ou superior, está tudo pronto. Caso contrário, não se preocupe — o instalador cuidará disso.

Etapa 1: Instale o OpenClaw pelo Script de Instalação (Recomendado)

A maneira mais rápida de instalar o OpenClaw no macOS é o script de instalação de uma linha. Ele cuida da detecção do Node, da instalação da CLI e inicia o assistente de integração — tudo em uma única etapa.

Abra o Terminal e execute:

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

É isso. O script baixará a CLI, a instalará globalmente via npm e iniciará automaticamente o assistente de integração.

Alternativa: Instale Diretamente via npm

Se você já tem o Node 22+ e prefere controle manual, pode instalar o OpenClaw com npm:

npm install -g openclaw@latest
openclaw onboard --install-daemon

Alternativa: Instale via pnpm

Se pnpm é o seu gerenciador de pacotes preferido:

pnpm add -g openclaw@latest
pnpm approve-builds -g   # aprove openclaw, node-llama-cpp, sharp, etc.
openclaw onboard --install-daemon

Observação: pnpm exige aprovação explícita para pacotes com scripts de build. Depois que a primeira instalação mostrar o aviso "Ignored build scripts", execute pnpm approve-builds -g e selecione os pacotes listados.

Solução de Problemas: Erros de Build do sharp

Se você tiver o libvips instalado globalmente (comum no macOS via Homebrew) e o sharp falhar durante a instalação, force os binários pré-compilados:

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

Se você vir o erro sharp: Please add node-gyp to your dependencies, instale as ferramentas de build (Xcode Command Line Tools + npm install -g node-gyp) ou use a variável de ambiente acima.

Etapa 2: Execute o Assistente de Integração

Se o script de instalação não o tiver iniciado automaticamente, inicie o assistente de integração manualmente:

openclaw onboard --install-daemon

O assistente orienta você na configuração da autenticação, das configurações do gateway e das conexões opcionais de canais. Ele também instala o OpenClaw como um serviço em segundo plano (daemon), para que o Gateway continue em execução mesmo depois que você fechar o Terminal.

O Que o Assistente Configura

• Autenticação — gera um token para o Gateway para que clientes locais e remotos precisem se autenticar
• Configurações do Gateway — porta, endereço de bind e instalação do serviço
• Conexões de canais — configuração opcional para WhatsApp, Telegram, Discord e mais

Etapa 3: Verifique se o Gateway Está em Execução

Depois que a integração for concluída, verifique se o Gateway está ativo:

openclaw gateway status

Você deve ver a confirmação de que o Gateway está em execução. Se quiser executá-lo em primeiro plano para depuração ou testes rápidos, use:

openclaw gateway --port 18789

Para uma verificação completa de integridade:

openclaw health

Etapa 4: Abra a UI de Controle (Dashboard)

A maneira mais rápida de começar a conversar com o OpenClaw é pela UI de Controle baseada em navegador — sem necessidade de configurar canais.

Execute:

openclaw dashboard

Isso copia a URL do dashboard, abre seu navegador se possível e exibe o link. Por padrão, a UI de Controle é servida em:

http://127.0.0.1:18789/

Se o dashboard solicitar autenticação, cole o token da sua configuração do Gateway. Você pode recuperá-lo com:

openclaw config get gateway.auth.token

Nota de segurança: A Control UI é uma superfície de administração — ela fornece acesso a chat, configuração e aprovações de execução. Não a exponha publicamente. Use apenas localhost, Tailscale Serve ou um túnel SSH.

Etapa 5: Conecte um Canal de Chat (Opcional)

Embora a Control UI ofereça acesso instantâneo ao chat, o verdadeiro poder do OpenClaw é enviar mensagens ao seu agente de IA a partir dos apps que você já usa. Aqui está uma visão geral rápida dos canais compatíveis:

Canal	Complexidade de Configuração	Observações
Telegram	Mais fácil	Token de bot simples
WhatsApp	Fácil	Pareamento por QR necessário; armazena mais estado em disco
Discord	Moderada	API de bot + Gateway
iMessage	Moderada	Recomendado via servidor BlueBubbles macOS
IRC	Baixa	IRC clássico; canais + DMs
Slack	Moderada	Bolt SDK; apps de workspace
Signal	Moderada	Focado em privacidade; usa signal-cli

Vários canais podem ser executados simultaneamente — configure quantos quiser e o OpenClaw roteia mensagens por chat.

Confira esta publicação para: Tutorial do OpenClaw: Conectar ao Slack para Assistente de IA Local - Blog da Milvus

Exemplo Rápido: Parear WhatsApp

Para conectar o WhatsApp, execute:

openclaw channels login

Siga o fluxo de pareamento por QR e você poderá enviar mensagens ao seu agente de IA diretamente pelo WhatsApp.

Etapa 6: Envie uma Mensagem de Teste

Com um canal configurado, envie uma mensagem de teste pela CLI:

openclaw message send --target +15555550123 --message "Hello from OpenClaw"

Substitua o número de telefone pelo seu. Se tudo estiver conectado corretamente, você verá a mensagem chegar no seu app de mensagens — e o agente de IA do OpenClaw responderá.

Opcional: Compilar a partir do Código-fonte

Para colaboradores ou qualquer pessoa que queira executar a partir de um checkout local:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build

Vincule a CLI globalmente:

pnpm link --global

Então execute o onboarding:

openclaw onboard --install-daemon

Para recarregamento automático durante o desenvolvimento, use pnpm gateway:watch em vez do comando padrão do gateway.

Opcional: Onboarding do App macOS

O OpenClaw também oferece um app nativo para macOS (barra de menus) com seu próprio fluxo de onboarding. Se você estiver usando o app:

1. Aprove o aviso de segurança do macOS ao iniciar pela primeira vez
2. Permita a permissão "Find Local Networks"
3. Escolha Local vs. Remote — selecione "This Mac" para um Gateway somente local
4. Conceda permissões — o app pode solicitar Automação, Notificações, Acessibilidade e outras permissões TCC dependendo do seu caso de uso
5. Instale a CLI (opcional) — o app pode instalar a CLI global openclaw via npm para que fluxos de trabalho no terminal funcionem junto com o app
6. Converse na sessão de onboarding — o app abre um chat dedicado para que o agente possa se apresentar

O fluxo de trabalho estável recomendado pela documentação do OpenClaw: instale e inicie OpenClaw.app, conclua a lista de verificação de onboarding e então vincule seus canais com openclaw channels login.

Noções Básicas de Configuração

O OpenClaw armazena sua configuração em ~/.openclaw/openclaw.json. Por padrão, ele usa o binário Pi incluído em modo RPC com sessões por remetente — nenhuma configuração é necessária.

Se você quiser restringir quem pode enviar mensagens ao seu agente, adicione uma regra allowFrom:

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+15555550123"],
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  },
  "messages": {
    "groupChat": {
      "mentionPatterns": ["@openclaw"]
    }
  }
}

Principais Localizações de Arquivos no macOS

Caminho	Finalidade
~/.openclaw/openclaw.json	Arquivo de configuração principal
~/.openclaw/workspace/	Habilidades, prompts, memórias
~/.openclaw/credentials/	Credenciais de canais
~/.openclaw/agents/<agentId>/sessions/	Dados de sessão do agente
/tmp/openclaw/	Logs

Variáveis de Ambiente Úteis

Variável	Finalidade
OPENCLAW_HOME	Substituir o diretório inicial para resolução de caminhos internos
OPENCLAW_STATE_DIR	Substituir o diretório de estado
OPENCLAW_CONFIG_PATH	Substituir o caminho do arquivo de configuração

Solução de problemas: openclaw Não Encontrado

Se seu shell não consegue encontrar o comando openclaw após a instalação, o problema quase sempre é uma entrada PATH ausente.

Diagnóstico rápido:

node -v
npm -v
npm prefix -g
echo "$PATH"

Se a saída de npm prefix -g mais /bin não estiver no seu $PATH, adicione-a ao arquivo de inicialização do seu shell (~/.zshrc para macOS moderno):

export PATH="$(npm prefix -g)/bin:$PATH"

Em seguida, abra uma nova janela do Terminal ou execute source ~/.zshrc.

Solução de problemas: Erro "Unauthorized" / 1008 no Dashboard

Se a Control UI mostrar um erro de não autorizado:

1. Certifique-se de que o Gateway esteja acessível: openclaw status
2. Recupere o token: openclaw config get gateway.auth.token
3. Nas configurações do dashboard, cole o token no campo de autenticação e reconecte

Se você precisar gerar um novo token:

openclaw doctor --generate-gateway-token

O Que Você Tem Agora

Depois de concluir este tutorial, você tem:

• Um Gateway em execução no seu Mac
• Autenticação configurada para acesso seguro
• Acesso à Control UI para chat baseado em navegador
• Opcionalmente, um ou mais canais de mensagens conectados (WhatsApp, Telegram, Discord, etc.)

A partir daqui, você pode explorar roteamento multiagente, isolamento de workspace, suporte a mídia e toda a gama de recursos do OpenClaw.

Recursos

• Extraímos o Sistema de Memória do OpenClaw e o Tornamos Open Source (memsearch)

• O Que É OpenClaw? Guia Completo do Agente de IA Open-Source

• Crie Agentes de IA no Estilo Clawdbot com LangGraph e Milvus

• Como o Claude Code Gerencia Armazenamento Local para Agentes de IA