Pular para o conteúdo principal

​
Raspberry Pi

Execute um OpenClaw Gateway persistente e sempre ativo em um Raspberry Pi. Como o Pi é apenas o gateway (os modelos são executados na nuvem via API), mesmo um Pi modesto lida bem com a carga de trabalho.

​
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 64-bit (obrigatório — não use 32-bit)
  • Cerca de 30 minutos

​
Configuração

1

Gravar o SO

Use Raspberry Pi OS Lite (64-bit) — não é necessário desktop 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
    • Ative SSH
    • Defina nome de usuário e senha
    • Configure o WiFi (se não for usar Ethernet)
  4. Grave no cartão SD ou unidade USB, insira no Pi e inicialize.
2

Conectar via SSH

ssh user@gateway-host
3

Atualizar 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

Instalar Node.js 24

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

Adicionar 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

Instalar OpenClaw

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

Executar 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

Verificar

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

Acessar 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 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. Ative 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 headless, libere memória da GPU e desative serviços não usados: 
echo 'gpu_mem=16' | sudo tee -a /boot/config.txt
sudo systemctl disable bluetooth

​
Solução de problemas

Sem memória — verifique se o swap está ativo com free -h. Desative 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 limitação térmica da 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, verifique também se lingering está ativado: sudo loginctl enable-linger "$(whoami)". Problemas com binários ARM — se uma Skill falhar com “exec format error”, verifique se o binário tem uma compilação ARM64. Verifique a arquitetura com uname -m (deve mostrar aarch64). Quedas de WiFi — desative o gerenciamento de energia do WiFi: sudo iwconfig wlan0 power off.

​
Próximas etapas