---
title: "OpenClaw Consumindo Muita Memória RAM"
url: "https://openclaw.ia.br/troubleshooting/alto-uso-memoria/"
markdown_url: "https://openclaw.ia.br/troubleshooting/alto-uso-memoria.MD"
description: "Resolva o alto consumo de memória do OpenClaw. Aprenda a monitorar, limitar cache e otimizar uso de RAM para evitar travamentos."
date: ""
author: ""
---

# OpenClaw Consumindo Muita Memória RAM

Resolva o alto consumo de memória do OpenClaw. Aprenda a monitorar, limitar cache e otimizar uso de RAM para evitar travamentos.


# OpenClaw Consumindo Muita Memória RAM

O OpenClaw está usando muita memória e deixando seu sistema lento? Este guia mostra como diagnosticar e resolver o problema.

```
JavaScript heap out of memory
FATAL ERROR: CALL_AND_RETRY_LAST Allocation failed
Process killed (OOM)
Memory usage exceeded limit
```

## Por Que Isso Acontece?

| Causa | Sintoma |
|-------|---------|
| **Memory leak** | Uso cresce sem parar |
| **Cache sem limite** | Muitos dados acumulados |
| **Muitas conexões** | Centenas de sessões abertas |
| **Arquivos grandes** | Pico ao processar mídia |
| **Histórico extenso** | Contexto de conversas muito longo |

## Soluções

### 1. Monitorar Uso de Memória

```bash
# Ver uso de memória do processo
ps aux | grep openclaw

# Monitorar em tempo real
top -p $(pgrep -f openclaw)

# Usar htop para visualização melhor
htop -p $(pgrep -f openclaw)
```

### 2. Aumentar Limite de Memória do Node

```bash
# Aumentar para 4GB
export NODE_OPTIONS="--max-old-space-size=4096"

# Ou ao iniciar
node --max-old-space-size=4096 app.js

# No script de inicialização
NODE_OPTIONS="--max-old-space-size=4096" openclaw gateway start
```

### 3. Configurar Limites de Cache

```yaml
# config.yaml
cache:
  messages:
    max_size: 1000
    ttl: 3600  # 1 hora
  sessions:
    max_size: 100
  media:
    max_size: 50
    max_file_size: 10mb
```

### 4. Limpar Cache Periodicamente

```bash
# Limpar cache manualmente
openclaw cache clear

# Ou programar limpeza
openclaw cache clear --older-than 24h
```

```javascript
// Limpar cache no código
setInterval(() => {
  cache.clear();
  global.gc && global.gc();  // Forçar garbage collection
}, 3600000);  // A cada hora
```

### 5. Usar Garbage Collection Manual

```bash
# Iniciar com GC exposto
node --expose-gc app.js
```

```javascript
// Forçar GC quando necessário
if (global.gc) {
  global.gc();
}
```

### 6. Limitar Histórico de Mensagens

```yaml
# Limitar contexto de conversas
conversation:
  max_history: 50  # Últimas 50 mensagens
  max_tokens: 4000
  cleanup_interval: 3600
```

### 7. Processar Mídia em Stream

```javascript
// Em vez de carregar tudo na memória
// Use streams para arquivos grandes
const stream = fs.createReadStream(filePath);
stream.pipe(destination);
```

## Diagnóstico

```bash
#!/bin/bash
echo "=== Diagnóstico de Memória ==="

echo -e "\n1. Uso atual:"
ps aux | grep openclaw | awk '{print "PID:", $2, "MEM%:", $4, "VSZ:", $5, "RSS:", $6}'

echo -e "\n2. Memória do sistema:"
free -h

echo -e "\n3. Top processos por memória:"
ps aux --sort=-%mem | head -10

echo -e "\n4. Cache do openclaw:"
openclaw cache status 2>/dev/null || echo "Comando não disponível"
```

## Problemas Relacionados

- [Respostas Lentas](/troubleshooting/lentidao/) — Performance degradada
- [Gateway Não Inicia](/troubleshooting/gateway-nao-inicia/) — Serviço não sobe
- [Memória Cheia](/troubleshooting/memoria-cheia/) — Sistema travando

## Prevenção

- ✅ Configure limites de cache desde o início
- ✅ Monitore uso de memória regularmente  
- ✅ Use `htop` ou ferramentas de profiling
- ✅ Reinicie o serviço periodicamente (cron semanal)
- ✅ Configure alertas de uso de memória

## Próximos Passos

Se o problema persistir após essas otimizações:

1. Considere aumentar a RAM do servidor
2. Use um modelo mais leve (Sonnet em vez de Opus)
3. Consulte a [FAQ de Performance](/faq/tecnico/)