---
title: "Gateway Não Inicia — Solução OpenClaw"
url: "https://openclaw.ia.br/troubleshooting/gateway-nao-inicia/"
markdown_url: "https://openclaw.ia.br/troubleshooting/gateway-nao-inicia.MD"
description: "O que fazer quando o gateway OpenClaw não sobe. Diagnóstico e correção de erros de inicialização."
date: ""
author: ""
---

# Gateway Não Inicia — Solução OpenClaw

O que fazer quando o gateway OpenClaw não sobe. Diagnóstico e correção de erros de inicialização.


# Gateway Não Inicia

## Sintomas
- `openclaw gateway status` mostra "not running"
- Erro ao iniciar

## Causas e Soluções

### Porta em Uso
```bash
# Verificar porta
lsof -i :18789

# Matar processo
kill -9 PID

# Usar outra porta
openclaw gateway --port 18790
```

### Erro de Configuração
```bash
# Verificar config
openclaw doctor

# Reparar
openclaw doctor --repair
```

### Node.js Antigo
```bash
node --version  # Precisa ser 22+

# Atualizar
nvm install 22
nvm use 22
```

### Permissões
```bash
# Verificar diretórios
ls -la ~/.openclaw/
```
