Pular para o conteúdo principal
Execute um OpenClaw Gateway persistente e sempre ativo em um Raspberry Pi. Como o Pi é apenas o gateway (os modelos rodam na nuvem via API), até mesmo um Pi modesto lida bem com a carga de trabalho — o custo típico de hardware é US$ 35–80 uma vez, sem mensalidades.

​
Compatibilidade de hardware

Modelo de PiRAMFunciona?Observações
Pi 54/8 GBMelhorMais rápido, recomendado.
Pi 44 GBBomPonto ideal para a maioria dos usuários.
Pi 42 GBOKAdicione swap.
Pi 41 GBApertadoPossível com swap, configuração mínima.
Pi 3B+1 GBLentoFunciona, mas fica arrastado.
Pi Zero 2 W512 MBNãoNão recomendado.
Mínimo: 1 GB de RAM, 1 núcleo, 500 MB de disco livre, SO de 64 bits. Recomendado: 2 GB+ de RAM, cartão SD de 16 GB+ (ou SSD USB), Ethernet.

​
Pré-requisitos

  • Raspberry Pi 4 ou 5 com 2 GB+ de RAM (4 GB recomendado)
  • Cartão microSD (16 GB+) ou SSD USB (melhor desempenho)
  • Fonte oficial do Pi
  • Conexão de rede (Ethernet ou WiFi)
  • Raspberry Pi OS de 64 bits (obrigatório — não use 32 bits)
  • Cerca de 30 minutos

​
Configuração

1

Grave o SO

Use Raspberry Pi OS Lite (64-bit) — nenhum desktop é necessário para um servidor headless.
  1. Baixe o Raspberry Pi Imager.
  2. Escolha o SO: Raspberry Pi OS Lite (64-bit).
  3. Na caixa de diálogo de configurações, pré-configure:
    • Nome do host: gateway-host
    • Habilite SSH
    • Defina nome de usuário e senha
    • Configure WiFi (se não estiver usando Ethernet)
  4. Grave no seu cartão SD ou unidade USB, insira-o e inicialize o Pi.
2

Conecte via SSH

ssh user@gateway-host
3

Atualize o sistema

sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl build-essential

# Set timezone (important for cron and reminders)
sudo timedatectl set-timezone America/Chicago
4

Instale o Node.js 24

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs
node --version
5

Adicione swap (importante para 2 GB ou menos)

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# Reduce swappiness for low-RAM devices
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
6

Instale o OpenClaw

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

Execute o onboarding

openclaw onboard --install-daemon
Siga o assistente. Chaves de API são recomendadas em vez de OAuth para dispositivos headless. Telegram é o canal mais fácil para começar.
8

Verifique

openclaw status
systemctl --user status openclaw-gateway.service
journalctl --user -u openclaw-gateway.service -f
9

Acesse a Control UI

No seu computador, obtenha uma URL do painel a partir do Pi:
ssh user@gateway-host 'openclaw dashboard --no-open'
Em seguida, crie um túnel SSH em outro terminal:
ssh -N -L 18789:127.0.0.1:18789 user@gateway-host
Abra a URL impressa no seu navegador local. Para acesso remoto sempre ativo, veja a integração com Tailscale.

​
Dicas de desempenho

Use um SSD USB — Cartões SD são lentos e se desgastam. Um SSD USB melhora drasticamente o desempenho. Veja o guia de inicialização USB do Pi. Habilite o cache de compilação de módulos — Acelera invocações repetidas da CLI em hosts Pi de menor potência: 
grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF' # pragma: allowlist secret
export NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
mkdir -p /var/tmp/openclaw-compile-cache
export OPENCLAW_NO_RESPAWN=1
EOF
source ~/.bashrc
OPENCLAW_NO_RESPAWN=1 mantém reinicializações rotineiras do Gateway dentro do processo, o que evita repasses extras de processo e mantém o rastreamento de PID simples em hosts pequenos. Reduza o uso de memória — Para configurações headless, libere memória da GPU e desabilite serviços não usados: 
echo 'gpu_mem=16' | sudo tee -a /boot/config.txt
sudo systemctl disable bluetooth
Drop-in do systemd para reinicializações estáveis — Se este Pi estiver rodando principalmente o OpenClaw, adicione um drop-in de serviço: 
systemctl --user edit openclaw-gateway.service

[Service]
Environment=OPENCLAW_NO_RESPAWN=1
Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
Restart=always
RestartSec=2
TimeoutStartSec=90
Depois execute systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service. Em um Pi headless, também habilite o lingering uma vez para que o serviço do usuário sobreviva ao logout: sudo loginctl enable-linger "$(whoami)".

​
Configuração de modelo recomendada

Como o Pi roda apenas o gateway, use modelos de API hospedados na nuvem: 
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-6",
        "fallbacks": ["openai/gpt-5.4-mini"]
      }
    }
  }
}
Não rode LLMs locais em um Pi — até modelos pequenos são lentos demais para serem úteis. Deixe Claude ou GPT fazerem o trabalho de modelo.

​
Observações sobre binários ARM

A maioria dos recursos do OpenClaw funciona em ARM64 sem alterações (Node.js, Telegram, WhatsApp/Baileys, Chromium). Os binários que ocasionalmente não têm builds ARM normalmente são ferramentas de CLI opcionais em Go/Rust enviadas por skills. Verifique a página de releases do binário ausente em busca de artefatos linux-arm64 / aarch64 antes de recorrer à compilação a partir do código-fonte.

​
Persistência e backups

O estado do OpenClaw fica em:
  • ~/.openclaw/ — openclaw.json, auth-profiles.json por agente, estado de canal/provedor, sessões.
  • ~/.openclaw/workspace/ — workspace do agente (SOUL.md, memória, artefatos).
Eles sobrevivem a reinicializações. Faça um snapshot portátil com: 
openclaw backup create
Se você mantiver esses dados em um SSD, tanto o desempenho quanto a longevidade melhoram em relação ao cartão SD.

​
Solução de problemas

Sem memória — Verifique se a swap está ativa com free -h. Desabilite serviços não usados (sudo systemctl disable cups bluetooth avahi-daemon). Use apenas modelos baseados em API. Desempenho lento — Use um SSD USB em vez de um cartão SD. Verifique se há throttling de CPU com vcgencmd get_throttled (deve retornar 0x0). O serviço não inicia — Verifique os logs com journalctl --user -u openclaw-gateway.service --no-pager -n 100 e execute openclaw doctor --non-interactive. Se este for um Pi headless, também verifique se o lingering está habilitado: sudo loginctl enable-linger "$(whoami)". Problemas com binários ARM — Se uma skill falhar com “exec format error”, verifique se o binário tem um build ARM64. Verifique a arquitetura com uname -m (deve mostrar aarch64). Quedas de WiFi — Desabilite o gerenciamento de energia do WiFi: sudo iwconfig wlan0 power off.

​
Próximas etapas

​
Relacionado