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 |
| 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:
- Aprove o aviso de segurança do macOS ao iniciar pela primeira vez
- Permita a permissão "Find Local Networks"
- Escolha Local vs. Remote — selecione "This Mac" para um Gateway somente local
- Conceda permissões — o app pode solicitar Automação, Notificações, Acessibilidade e outras permissões TCC dependendo do seu caso de uso
- Instale a CLI (opcional) — o app pode instalar a CLI global
openclawvia npm para que fluxos de trabalho no terminal funcionem junto com o app - 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:
- Certifique-se de que o Gateway esteja acessível:
openclaw status - Recupere o token:
openclaw config get gateway.auth.token - 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
Continue lendo
What Exactly Are AI Agents? Why OpenAI and LangChain Are Fighting Over Their Definition?
AI agents are software programs powered by AI that can perceive their environment, make decisions, and take actions to achieve a goal—often autonomously.
Cosmos World Foundation Model Platform for Physical AI
NVIDIA's Cosmos platform enables safe, digital twin training of GenAI models for physical applications, overcoming data scarcity and safety challenges.
Legal Document Analysis: Harnessing Zilliz Cloud's Semantic Search and RAG for Legal Insights
Enhance legal document analysis with Zilliz Cloud’s Semantic Search and RAG. Improve accuracy, efficiency, and scalability for contracts, case law, and compliance.