Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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 com lentidão.
Pi Zero 2 W512 MBNãoNão recomendado.
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

1

Grave o sistema operacional

Use Raspberry Pi OS Lite (64-bit) — não é necessário desktop para um servidor sem monitor.
  1. Baixe o Raspberry Pi Imager.
  2. Escolha o sistema operacional: 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 a configuração inicial

openclaw onboard --install-daemon
Siga o assistente. Chaves de API são recomendadas em vez de OAuth para dispositivos sem monitor. 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 exibida no seu navegador local. Para acesso remoto sempre ativo, consulte 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. 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

​
Relacionado