---
title: "FAQ Técnico — Perguntas de Desenvolvedor"
url: "https://openclaw.ia.br/faq/tecnico/"
markdown_url: "https://openclaw.ia.br/faq/tecnico.MD"
description: "Perguntas técnicas sobre OpenClaw. Arquitetura, requisitos, configuração e troubleshooting."
date: ""
author: ""
---

# FAQ Técnico — Perguntas de Desenvolvedor

Perguntas técnicas sobre OpenClaw. Arquitetura, requisitos, configuração e troubleshooting.


# FAQ Técnico

Respostas para perguntas técnicas sobre o OpenClaw.

## Qual a Arquitetura?

```
┌─────────────────────────────────────────┐
│           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                           │
└─────────────────────────────────────────┘
```

## Requisitos Mínimos

- **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

## Onde Ficam os Arquivos?

```
~/.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
```

## Como Funciona a Memória?

1. **MEMORY.md** - Memória de longo prazo, curada manualmente
2. **memory/YYYY-MM-DD.md** - Logs diários automáticos
3. **Contexto de sessão** - Últimas mensagens (volátil)
4. **memory_search** - Busca semântica nos arquivos

## Posso Rodar em Container?

**Sim!** Docker disponível:

```bash
docker pull openclaw/openclaw
docker run -d \
  -v ~/.openclaw:/root/.openclaw \
  -v ~/clawd:/root/clawd \
  openclaw/openclaw
```

## Posso Rodar em Raspberry Pi?

**Sim!** Funciona em:
- Raspberry Pi 4 (2GB+)
- Raspberry Pi 5
- Qualquer ARM64 com Node.js

Performance pode ser mais lenta, mas funciona.

## Como Faço Backup?

```bash
# Backup completo
tar -czf backup.tar.gz ~/.openclaw ~/clawd

# Restaurar
tar -xzf backup.tar.gz -C /
```

## Como Vejo os Logs?

```bash
# Logs do gateway
openclaw logs

# Logs em tempo real
openclaw logs -f

# Últimas 100 linhas
openclaw logs -n 100
```

## Posso Usar Múltiplos Modelos?

**Sim!** Configure por contexto:

```yaml
models:
  default: claude-3-5-sonnet
  code: claude-3-opus
  simple: claude-3-haiku
```

## Como Debugar Problemas?

1. **Verifique logs:** `openclaw logs`
2. **Teste gateway:** `openclaw gateway status`
3. **Modo verbose:** `DEBUG=* openclaw gateway start`
4. **Verifique API:** Teste key no dashboard do provider

## Posso Ter Múltiplos Agentes?

**Sim!** OpenClaw suporta arquiteturas multi-agentes de várias formas:

### Sessões Isoladas
Cada canal (Telegram, WhatsApp) pode ter seu próprio agente com SOUL.md diferente.

### Sub-Agentes (spawn)
Um agente principal pode delegar tarefas para sub-agentes especializados:

```
sessions_spawn(task="Pesquise tendências de IA no Brasil", label="researcher")
```

### Múltiplas Instâncias
Rode várias instâncias do gateway em portas diferentes:

```yaml
# gateway-1.yaml
port: 3000
workspace: ~/agent-1

# gateway-2.yaml  
port: 3001
workspace: ~/agent-2
```

### Orquestração
Para cenários avançados, use MarshalBot ou ferramentas similares para coordenar equipes de agentes com tarefas específicas.

## Qual o Limite de Rate da API?

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.

## Próximas Perguntas

- [FAQ Geral](/faq/geral/)
- [Troubleshooting](/troubleshooting/)
- [Guia de Segurança](/guias/seguranca/)