---
title: "Instalar OpenClaw no macOS: Guia Completo 2026"
url: "https://openclaw.ia.br/instalacao/macos.md"
markdown_url: "https://openclaw.ia.br/instalacao/macos.md"
description: "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: 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

<div class="badges">
⏱ <strong>5 minutos</strong> ·  <strong>Iniciante</strong> ·  <strong>macOS 12+</strong>
</div>

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:

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

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

Pronto! Execute o wizard:

```bash
openclaw onboard --install-daemon
```

---

## Instalação sem Homebrew

Se você não tem o Homebrew instalado:

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

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

Siga as instruções na tela, depois:

```bash
brew install node
npm install -g openclaw@latest
```

### Opção B: Baixar Node.js manualmente

1. Acesse [nodejs.org](https://nodejs.org)
2. Baixe a versão LTS para macOS
3. Instale o `.pkg`
4. Abra novo Terminal e execute:

```bash
npm install -g openclaw@latest
```

---

## Configuração Inicial

Execute o wizard de configuração:

```bash
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)

```bash
# 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:

```bash
# 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:

```bash
# 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"

```bash
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:

```bash
# 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](/tutoriais/primeiro-bot/)** - Crie um assistente básico
2. **[Personalize a personalidade](/tutoriais/personalizar-soul/)** - Edite o SOUL.md
3. **[Conecte ao Telegram](/tutoriais/telegram/)** - Configure um bot no Telegram
4. **[Explore as Skills](/skills/)** - Adicione funcionalidades prontas

---

## Artigos Relacionados

- [Instalação no Windows](/instalacao/windows/)
- [Instalação no Linux](/instalacao/linux/)
- [Instalação com Docker](/instalacao/docker/)
- [Deploy na Oracle Cloud (Grátis)](/blog/instalar-openclaw-gratis-oracle-cloud/)