Guia de configuração do OpenClaw macOS: instalação em Macs Apple Silicon e Intel

Introdução

macOS é uma das plataformas mais populares para executar OpenClaw, graças à sua base Unix e excelentes ferramentas de desenvolvedor. Este guia cobre tudo que você precisa para instalar e configurar o OpenClaw em seu Mac, esteja você usando Apple Silicon (M1/M2/M3) ou um Mac baseado em Intel.

Para obter instruções gerais de instalação, consulte nosso guia completo de instalação.

Requisitos do sistema

Versão macOS

macOS 13 Ventura ou posterior (recomendado: macOS 14 Sonoma+)
Versões mais antigas podem funcionar, mas não são oficialmente suportadas

Hardware

Apple Silicon (M1, M2, M3, M1 Pro, M2 Max, etc.) — Desempenho nativo totalmente suportado

Macs Intel — Compatível com compatibilidade com Rosetta 2
RAM — 2 GB+ recomendado (4 GB+ para melhor desempenho)
Armazenamento — 500 MB+ para instalação, espaço adicional para memória/dados

Pré-requisitos de software

Ferramentas de linha de comando do Xcode — Necessário para criar módulos nativos
Node.js 18+ — Pode ser instalado automaticamente pelo instalador one-liner
Terminal — Terminal.app integrado ou iTerm2

Métodos de instalação

Método 1: instalação One-Liner (mais fácil)

A maneira mais simples de instalar o OpenClaw no macOS:

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

Este script automaticamente:

Verifica Node.js (instala via Homebrew se estiver faltando)
Instala OpenClaw globalmente
Configura as permissões necessárias
Verifica a instalação

Observação: Sua senha pode ser solicitada para instalar o Homebrew ou o Node.js se eles ainda não estiverem instalados.

Método 2: instalação do Homebrew

Se você usa o Homebrew, pode instalar o OpenClaw diretamente:

brew install openclaw

Ou se estiver usando o toque Homebrew:

brew tap openclaw/openclaw
brew install openclaw

Observação: A fórmula Homebrew pode não estar disponível imediatamente. Verifique os documentos oficiais para obter os métodos de instalação mais recentes.

Método 3: instalação npm

Se você já possui o Node.js instalado:

npm i -g openclaw

Verifique primeiro a versão do Node.js:

node --version

Deve ser v18.0.0 ou superior.

Método 4: aplicativo macOS Companion

Para uma experiência GUI junto com a CLI, instale o aplicativo complementar do macOS:

Baixar: Visite Lançamentos do GitHub
Abrir: Clique duas vezes no arquivo .dmg
Instalar: Arraste OpenClaw para a pasta Aplicativos
Iniciar: Abrir em Aplicativos ou Spotlight (⌘+Espaço)

O aplicativo complementar fornece:

Ícone da barra de menu com indicador de status
Acesso rápido às configurações
Visualizador de registros
Controles de partida/parada

Requisitos:

macOS 14+ (Sonoma)
Universal Binary (funciona em Apple Silicon e Intel)

Instalando pré-requisitos

Ferramentas de linha de comando do Xcode

Muitos pacotes npm requerem ferramentas de linha de comando do Xcode. Instale-os:

xcode-select --install

Clique em “Instalar” quando solicitado. Isso pode levar de 10 a 15 minutos.

Verifique a instalação:

xcode-select -p

Deve gerar: /Library/Developer/CommandLineTools

Node.js via Homebrew

Se o Node.js não estiver instalado, use o Homebrew:

brew install node

Ou instale a versão LTS:

brew install node@18

Verifique:

node --version
npm --version

Homebrew (se não estiver instalado)

Se você não possui o Homebrew:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Siga as instruções na tela. No Apple Silicon, pode ser necessário adicionar o Homebrew ao seu PATH:

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

Apple Silício x Intel

Apple Silício (M1/M2/M3)

OpenClaw roda nativamente em Apple Silicon com excelente desempenho:

Não é necessário Rosetta — Binários ARM64 nativos
Melhor desempenho — Otimizado para Apple Silicon ** Menor consumo de energia ** — Mais eficiente que Macs Intel
Binários universais — Funciona perfeitamenteA instalação é idêntica aos Macs Intel. O instalador one-liner detecta sua arquitetura automaticamente.

Macs Intel

OpenClaw funciona perfeitamente em Macs Intel via Rosetta 2:

Compatibilidade automática — Rosetta cuida da tradução
Um pouco mais lento — Impacto mínimo no desempenho
Funcionalidade completa — Todos os recursos funcionam de forma idêntica

Nenhuma configuração especial é necessária – basta instalar normalmente.

Configuração pós-instalação

Após a instalação, configure o OpenClaw:

openclaw onboard

Esta configuração interativa abrange:

1. Configuração do modelo de IA

Escolha seu provedor de IA. Opções populares:

Claude Anthropic:

Soneto Claude 3.5 (recomendado)
Claude 3 Opus
Cláudio 4

Obtenha sua chave de API em console.anthropic.com.

OpenAI GPT:

GPT-4o
GPT-4 Turbo
GPT-4.1

Obtenha sua chave de API em platform.openai.com.

Modelos locais:

Ollama (executado localmente, sem necessidade de chave de API)
Estúdio LM
MiniMax

2. Permissões do macOS

OpenClaw pode solicitar permissões:

Acesso total ao disco — Para leitura/gravação de arquivos
Automação — Para controlar outros aplicativos
Rede — Para chamadas de API e pontes de chat

Conceda permissões em Configurações do sistema → Privacidade e segurança.

3. Integração com iMessage (específico para macOS)

Configure a integração do iMessage:

openclaw integrations imessage

Isso requer:

Aplicativo macOS Mensagens ativado
conta iMessage conectada
Permissões concedidas

Consulte nosso guia de configuração do iMessage para obter detalhes.

Executando o OpenClaw

Inicie o servidor

openclaw

Isso inicia o servidor local e conecta todas as integrações configuradas.

Executar em segundo plano

Use nohup ou um gerenciador de processos:

nohup openclaw > ~/.openclaw/logs/output.log 2>&1 &

Ou instale pm2:

npm i -g pm2
pm2 start openclaw
pm2 save
pm2 startup

Crie um Launch Agent para iniciar o OpenClaw automaticamente:

mkdir -p ~/Library/LaunchAgents

Crie ~/Library/LaunchAgents/com.openclaw.plist:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key>
  <string>com.openclaw</string>
  <key>ProgramArguments</key>
  <array>
    <string>/usr/local/bin/openclaw</string>
  </array>
  <key>RunAtLoad</key>
  <true/>
  <key>KeepAlive</key>
  <true/>
</dict>
</plist>

Carregue:

launchctl load ~/Library/LaunchAgents/com.openclaw.plist

Recursos específicos do macOS

Integração de aplicativos complementares

O aplicativo complementar do macOS funciona junto com a CLI:

Acesso à barra de menu — Status e controles rápidos
Indicadores visuais — Veja rapidamente o status da conexão
IU de configurações — Configuração gráfica
Log Viewer — Depure problemas facilmente

Suporte iMessage

macOS é a única plataforma com suporte nativo ao iMessage:

Integração direta com Apple Mensagens
Funciona com mensagens do iPhone via Continuidade
Suporte para bate-papo em grupo
Compartilhamento de mídia

Consulte o guia de configuração do iMessage para configuração.

Integração Spotlight

Torne os comandos do OpenClaw pesquisáveis:

ln -s /usr/local/bin/openclaw /usr/local/bin/claw

Agora você pode digitar “claw” no Spotlight para executar comandos.

Solução de problemas

Erros de permissão negada

Se você vir erros de permissão:

sudo npm i -g openclaw

Ou corrija as permissões npm:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zprofile
source ~/.zprofile

Comando não encontrado

Se openclaw não for encontrado:

Verifique o caminho global do npm:
```
npm config get prefix
```

Adicione ao PATH:

echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zprofile
source ~/.zprofile

Reinicie o Terminal

Problemas com ferramentas de linha de comando do Xcode

Se as compilações falharem:

sudo xcode-select --reset
xcode-select --install

Compatibilidade com Apple Silicon

Se você encontrar problemas de arquitetura:

arch -arm64 npm i -g openclaw

Forçar Rosetta (se necessário):

arch -x86_64 npm i -g openclaw

Porta já em uso

Altere a porta:

openclaw --port 3001

Ou encontre e elimine o processo:

lsof -ti:3000 | xargs kill

Dicas de desempenho

Otimização de silício da Apple

Use ARM64 Node.js nativo (instalado automaticamente)
Habilite binários nativos para melhor desempenho
Monitorar o Activity Monitor para uso de recursos

Gerenciamento de memória

OpenClaw usa memória para:

Contexto do modelo de IA
Histórico de bate-papo
Sessões do navegador
Dados de habilidade

Monitore o uso:

openclaw status
```### Vida útil da bateria

A execução contínua do OpenClaw consome o mínimo de bateria:
- As chamadas da API AI são baseadas em rede (baixa CPU)
- O processamento local é eficiente
- A operação em segundo plano é otimizada

Para uso sempre ativo, mantenha seu Mac conectado ou use um Mac Mini/servidor.

## Atualizando o OpenClaw

Atualize para a versão mais recente:

```bash
npm update -g openclaw

Ou execute novamente o instalador:

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

Desinstalando

Remover OpenClaw:

npm uninstall -g openclaw

Remover configuração:

rm -rf ~/.openclaw

Remover agente de inicialização (se criado):

launchctl unload ~/Library/LaunchAgents/com.openclaw.plist
rm ~/Library/LaunchAgents/com.openclaw.plist

Próximas etapas

Agora que o OpenClaw está instalado no macOS:

Configurar o iMessage — Guia de integração do iMessage
Conecte outros aplicativos — WhatsApp, Telegram, Discord
Explorar habilidades — Biblioteca de habilidades
Leia as perguntas frequentes — Perguntas comuns

Conclusão

Instalar o OpenClaw no macOS é simples, esteja você usando Apple Silicon ou Intel. O instalador de uma linha lida com a maior complexidade e o aplicativo complementar do macOS oferece uma excelente experiência de GUI.

Para obter mais ajuda, consulte nosso guia geral de instalação ou página de perguntas frequentes. Boa automação!

Protocolo de cookies iniciado

Quick Answer