Raspberry Pi

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

# Compatibilidade de hardware

Mínimo: 1 GB de RAM, 1 núcleo, 500 MB de disco livre, sistema operacional 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 de alimentação 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

ssh user@gateway-host

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

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

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

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

openclaw onboard --install-daemon

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

ssh user@gateway-host 'openclaw dashboard --no-open'

ssh -N -L 18789:127.0.0.1:18789 user@gateway-host

# Dicas de desempenho

Use um SSD USB -- Cartões SD são lentos e se desgastam. Um SSD USB melhora drasticamente o desempenho. Consulte 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

Reduza o uso de memória -- Para configurações sem monitor, 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 executa 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

Em seguida, systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service. Em um Pi sem monitor, também habilite lingering uma vez para que o serviço de usuário sobreviva ao logout: sudo loginctl enable-linger "$(whoami)".

# Configuração de modelo recomendada

Como o Pi executa 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 execute LLMs locais em um Pi — até modelos pequenos são lentos demais para serem úteis. Deixe Claude ou GPT fazerem o trabalho do 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 CLI opcionais em Go/Rust enviadas por Skills. Verifique a página de release de um 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 canais/provedores, 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 arquivos em um SSD, tanto o desempenho quanto a durabilidade melhoram em comparação com o cartão SD.

# Solução de problemas

Sem memória -- Verifique se o swap está ativo 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á limitação 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 sem monitor, também verifique se 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óximos passos

• Canais -- conecte Telegram, WhatsApp, Discord e outros
• Configuração do Gateway -- todas as opções de configuração
• Atualização -- mantenha o OpenClaw atualizado

# Relacionado

• Visão geral da instalação
• Servidor Linux
• Plataformas