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
VDBBench Adds Cost-Aware Benchmarking for Vector Databases
Compare Zilliz Cloud, Pinecone, and turbopuffer with VDBBench cost-aware vector database benchmarks across latency, freshness, multitenancy, and cold starts.
Vector Databases vs. Key-Value Databases
Use a vector database for AI-powered similarity search; use a key-value database for high-throughput, low-latency simple data lookups.
Introducing DeepSearcher: A Local Open Source Deep Research
In contrast to OpenAI’s Deep Research, this example ran locally, using only open-source models and tools like Milvus and LangChain.