Instalar OpenClaw no macOS: Guia Completo 2026

Passo a passo para instalar o OpenClaw no Mac (Intel e Apple Silicon M1/M2/M3). Comandos prontos para copiar no Terminal.

Instalar OpenClaw no macOS

⏱️ 5 minutos · 🎯 Iniciante · 💻 macOS 12+

O macOS é a plataforma mais simples para rodar o OpenClaw. Funciona em Macs Intel e Apple Silicon (M1/M2/M3) sem configuração extra.

💡 Mac com chip Apple Silicon? Perfeito! O OpenClaw roda nativamente e aproveita toda a performance do seu M1/M2/M3.

Pré-requisitos

  • macOS 12 (Monterey) ou superior
  • 4GB de RAM (8GB recomendado)
  • Homebrew instalado (opcional, facilita)
  • Terminal (já vem instalado)

Instalação Rápida (2 comandos)

Abra o Terminal (Cmd + Espaço, digite “Terminal”) e execute:

# 1. Instalar Node.js (se não tiver)
brew install node

# 2. Instalar OpenClaw
npm install -g openclaw@latest

Pronto! Execute o wizard:

openclaw onboard --install-daemon

Instalação sem Homebrew

Se você não tem o Homebrew instalado:

Opção A: Instalar Homebrew primeiro (recomendado)

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

Siga as instruções na tela, depois:

brew install node
npm install -g openclaw@latest

Opção B: Baixar Node.js manualmente

  1. Acesse nodejs.org
  2. Baixe a versão LTS para macOS
  3. Instale o .pkg
  4. Abra novo Terminal e execute:
npm install -g openclaw@latest

Configuração Inicial

Execute o wizard de configuração:

openclaw onboard --install-daemon

O wizard vai guiar você para:

  1. Escolher seu provedor de IA (OpenAI, Anthropic, etc.)
  2. Configurar suas chaves de API
  3. Conectar um canal (WhatsApp, Telegram, Discord)

Manter OpenClaw Rodando

Como Daemon (recomendado)

# Iniciar
openclaw gateway start

# Ver status
openclaw gateway status

# Parar
openclaw gateway stop

# Ver logs
openclaw gateway logs

Iniciar automaticamente no boot

Para que o OpenClaw inicie quando você ligar o Mac:

# Criar o launch agent
mkdir -p ~/Library/LaunchAgents
cat > ~/Library/LaunchAgents/com.openclaw.gateway.plist << 'EOF'
<?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.gateway</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/bin/openclaw</string>
        <string>gateway</string>
        <string>start</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
</dict>
</plist>
EOF

# Ativar
launchctl load ~/Library/LaunchAgents/com.openclaw.gateway.plist

Troubleshooting macOS

Erro: “command not found: npm”

O Node.js não está no PATH. Tente:

# Se instalou via Homebrew
eval "$(/opt/homebrew/bin/brew shellenv)"

# Se instalou via pkg
export PATH="/usr/local/bin:$PATH"

Adicione a linha ao seu ~/.zshrc para persistir.

Erro: “EACCES permission denied”

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g openclaw@latest

Mac com Apple Silicon (M1/M2/M3)

Se tiver problemas com pacotes nativos:

# Forçar arquitetura ARM
arch -arm64 npm install -g openclaw@latest

Permissão de acesso ao Terminal

Se o macOS pedir permissões:

  1. Vá em Ajustes do Sistema → Privacidade e Segurança
  2. Ative Automação para o Terminal
  3. Ative Acesso Total ao Disco se necessário

Onde Ficam os Arquivos

  • Workspace: ~/clawd/
  • Configuração: ~/clawd/config.yaml
  • Memória: ~/clawd/memory/
  • Logs: Use openclaw gateway logs

Próximos Passos

Agora que o OpenClaw está instalado:

  1. Configure seu primeiro bot - Crie um assistente básico
  2. Personalize a personalidade - Edite o SOUL.md
  3. Conecte ao Telegram - Configure um bot no Telegram
  4. Explore as Skills - Adicione funcionalidades prontas

Artigos Relacionados