> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Vários gateways

A maioria das configurações deve usar um Gateway, porque um único Gateway consegue lidar com várias conexões de mensagens e agentes. Se você precisar de isolamento ou redundância mais fortes (por exemplo, um bot de resgate), execute Gateways separados com perfis/portas isolados.

## Melhor configuração recomendada

Para a maioria dos usuários, a configuração mais simples de bot de resgate é:

* manter o bot principal no perfil padrão
* executar o bot de resgate em `--profile rescue`
* usar um bot do Telegram completamente separado para a conta de resgate
* manter o bot de resgate em uma porta base diferente, como `19789`

Isso mantém o bot de resgate isolado do bot principal, para que ele possa depurar ou aplicar
alterações de configuração se o bot primário estiver fora do ar. Deixe pelo menos 20 portas entre
as portas base para que as portas derivadas de navegador/canvas/CDP nunca entrem em conflito.

## Início rápido do bot de resgate

Use isto como o caminho padrão, a menos que você tenha um motivo forte para fazer outra coisa:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# Rescue bot (separate Telegram bot, separate profile, port 19789)
openclaw --profile rescue onboard
openclaw --profile rescue gateway install --port 19789
```

Se o seu bot principal já estiver em execução, geralmente isso é tudo de que você precisa.

Durante `openclaw --profile rescue onboard`:

* use o token do bot do Telegram separado
* mantenha o perfil `rescue`
* use uma porta base pelo menos 20 acima da do bot principal
* aceite o workspace de resgate padrão, a menos que você já gerencie um por conta própria

Se o onboarding já tiver instalado o serviço de resgate para você, o `gateway install`
final não será necessário.

## Por que isso funciona

O bot de resgate permanece independente porque tem seu próprio:

* perfil/configuração
* diretório de estado
* workspace
* porta base (mais portas derivadas)
* token do bot do Telegram

Para a maioria das configurações, use um bot do Telegram completamente separado para o perfil de resgate:

* fácil de manter somente para operadores
* token e identidade de bot separados
* independente da instalação de canal/app do bot principal
* caminho simples de recuperação baseado em DM quando o bot principal está quebrado

## O que `--profile rescue onboard` altera

`openclaw --profile rescue onboard` usa o fluxo normal de onboarding, mas grava
tudo em um perfil separado.

Na prática, isso significa que o bot de resgate recebe seu próprio:

* arquivo de configuração
* diretório de estado
* workspace (por padrão `~/.openclaw/workspace-rescue`)
* nome de serviço gerenciado

Os prompts são, de resto, iguais aos do onboarding normal.

## Configuração geral de múltiplos Gateways

O layout de bot de resgate acima é o padrão mais fácil, mas o mesmo padrão de isolamento
funciona para qualquer par ou grupo de Gateways em um host.

Para uma configuração mais geral, dê a cada Gateway extra seu próprio perfil nomeado e sua
própria porta base:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# main (default profile)
openclaw setup
openclaw gateway --port 18789

# extra gateway
openclaw --profile ops setup
openclaw --profile ops gateway --port 19789
```

Se você quiser que ambos os Gateways usem perfis nomeados, isso também funciona:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw --profile main setup
openclaw --profile main gateway --port 18789

openclaw --profile ops setup
openclaw --profile ops gateway --port 19789
```

Os serviços seguem o mesmo padrão:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway install
openclaw --profile ops gateway install --port 19789
```

Use o início rápido do bot de resgate quando quiser uma faixa alternativa para operadores. Use o
padrão geral de perfis quando quiser vários Gateways de longa duração para
diferentes canais, locatários, workspaces ou funções operacionais.

## Checklist de isolamento

Mantenha estes itens exclusivos por instância de Gateway:

* `OPENCLAW_CONFIG_PATH` — arquivo de configuração por instância
* `OPENCLAW_STATE_DIR` — sessões, credenciais e caches por instância
* `agents.defaults.workspace` — raiz do workspace por instância
* `gateway.port` (ou `--port`) — exclusiva por instância
* portas derivadas de navegador/canvas/CDP

Se eles forem compartilhados, você encontrará corridas de configuração e conflitos de porta.

## Mapeamento de portas (derivadas)

Porta base = `gateway.port` (ou `OPENCLAW_GATEWAY_PORT` / `--port`).

* porta do serviço de controle do navegador = base + 2 (somente loopback)
* o host do canvas é servido no servidor HTTP do Gateway (mesma porta que `gateway.port`)
* as portas CDP do perfil de navegador são alocadas automaticamente a partir de `browser.controlPort + 9 .. + 108`

Se você substituir qualquer uma delas na configuração ou no env, deverá mantê-las exclusivas por instância.

## Notas sobre navegador/CDP (armadilha comum)

* **Não** fixe `browser.cdpUrl` nos mesmos valores em várias instâncias.
* Cada instância precisa da sua própria porta de controle do navegador e intervalo CDP (derivados da porta do Gateway).
* Se você precisar de portas CDP explícitas, defina `browser.profiles.<name>.cdpPort` por instância.
* Chrome remoto: use `browser.profiles.<name>.cdpUrl` (por perfil, por instância).

## Exemplo manual de env

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
OPENCLAW_CONFIG_PATH=~/.openclaw/main.json \
OPENCLAW_STATE_DIR=~/.openclaw \
openclaw gateway --port 18789

OPENCLAW_CONFIG_PATH=~/.openclaw/rescue.json \
OPENCLAW_STATE_DIR=~/.openclaw-rescue \
openclaw gateway --port 19789
```

## Verificações rápidas

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway status --deep
openclaw --profile rescue gateway status --deep
openclaw --profile rescue gateway probe
openclaw status
openclaw --profile rescue status
openclaw --profile rescue browser status
```

Interpretação:

* `gateway status --deep` ajuda a detectar serviços launchd/systemd/schtasks obsoletos de instalações antigas.
* O texto de aviso de `gateway probe`, como `multiple reachable gateway identities detected`, é esperado somente quando você executa intencionalmente mais de um gateway isolado, ou quando o OpenClaw não consegue provar que os destinos de sondagem alcançáveis são o mesmo gateway. Um túnel SSH, URL de proxy ou URL remota configurada para o mesmo gateway é um gateway com vários transportes, mesmo quando as portas de transporte diferem.

## Relacionado

* [Runbook do Gateway](/pt-BR/gateway)
* [Bloqueio do Gateway](/pt-BR/gateway/gateway-lock)
* [Configuração](/pt-BR/gateway/configuration)