FAQ Técnico — Perguntas de Desenvolvedor
Perguntas técnicas sobre OpenClaw. Arquitetura, requisitos, configuração e troubleshooting.
⏱️ 3 min de leitura
FAQ Técnico
Respostas para perguntas técnicas sobre o OpenClaw.
┌─────────────────────────────────────────┐
│ Canais (WhatsApp, Telegram) │
└────────────────────┬────────────────────┘
│
┌────────────────────▼────────────────────┐
│ Gateway (Node.js) │
│ - Roteamento de mensagens │
│ - Gerenciamento de sessões │
│ - Autenticação │
└────────────────────┬────────────────────┘
│
┌────────────────────▼────────────────────┐
│ Agente (Claude/GPT) │
│ - Processamento de linguagem │
│ - Execução de tools │
│ - Contexto e memória │
└────────────────────┬────────────────────┘
│
┌────────────────────▼────────────────────┐
│ Skills & Integrações │
│ - APIs externas │
│ - Comandos do sistema │
│ - Automações │
└─────────────────────────────────────────┘
- OS: Linux, macOS, Windows (WSL)
- Node.js: 18 ou superior
- RAM: 512MB mínimo, 1GB recomendado
- Disco: 100MB + espaço para logs
- Rede: Conexão estável com internet
~/.openclaw/ # Configurações
└── config.yaml # Config principal
~/clawd/ # Workspace (customizável)
├── SOUL.md # Personalidade
├── MEMORY.md # Memória longo prazo
├── memory/ # Logs diários
└── skills/ # Skills locais
- MEMORY.md - Memória de longo prazo, curada manualmente
- memory/YYYY-MM-DD.md - Logs diários automáticos
- Contexto de sessão - Últimas mensagens (volátil)
- memory_search - Busca semântica nos arquivos
Sim! Docker disponível:
docker pull openclaw/openclaw
docker run -d \
-v ~/.openclaw:/root/.openclaw \
-v ~/clawd:/root/clawd \
openclaw/openclaw
Sim! Funciona em:
- Raspberry Pi 4 (2GB+)
- Raspberry Pi 5
- Qualquer ARM64 com Node.js
Performance pode ser mais lenta, mas funciona.
# Backup completo
tar -czf backup.tar.gz ~/.openclaw ~/clawd
# Restaurar
tar -xzf backup.tar.gz -C /
# Logs do gateway
openclaw logs
# Logs em tempo real
openclaw logs -f
# Últimas 100 linhas
openclaw logs -n 100
Sim! Configure por contexto:
models:
default: claude-3-5-sonnet
code: claude-3-opus
simple: claude-3-haiku
- Verifique logs:
openclaw logs - Teste gateway:
openclaw gateway status - Modo verbose:
DEBUG=* openclaw gateway start - Verifique API: Teste key no dashboard do provider
Sim! OpenClaw suporta arquiteturas multi-agentes de várias formas:
Cada canal (Telegram, WhatsApp) pode ter seu próprio agente com SOUL.md diferente.
Um agente principal pode delegar tarefas para sub-agentes especializados:
sessions_spawn(task="Pesquise tendências de IA no Brasil", label="researcher")
Rode várias instâncias do gateway em portas diferentes:
# gateway-1.yaml
port: 3000
workspace: ~/agent-1
# gateway-2.yaml
port: 3001
workspace: ~/agent-2
Para cenários avançados, use MarshalBot ou ferramentas similares para coordenar equipes de agentes com tarefas específicas.
Depende do provedor de LLM:
| Provedor | Limite Típico |
|---|---|
| Anthropic | 40 req/min (tier 1) |
| OpenAI | 60 req/min (tier 1) |
| Ollama | Sem limite (local) |
O OpenClaw gerencia filas automaticamente e respeita rate limits.