​

Múltiplos Gateways (mesmo host)

​

Checklist de isolamento (obrigatório)

• 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) — único por instância
• Portas derivadas (browser/canvas) não devem se sobrepor

​

Recomendado: perfis (--profile)

# main
openclaw --profile main setup
openclaw --profile main gateway --port 18789

# rescue
openclaw --profile rescue setup
openclaw --profile rescue gateway --port 19001

openclaw --profile main gateway install
openclaw --profile rescue gateway install

​

Guia do bot de resgate

• perfil/configuração
• diretório de estado
• workspace
• porta base (mais portas derivadas)

​

Como instalar (bot de resgate)

# Main bot (existing or fresh, without --profile param)
# Runs on port 18789 + Chrome CDC/Canvas/... Ports
openclaw onboard
openclaw gateway install

# Rescue bot (isolated profile + ports)
openclaw --profile rescue onboard
# Notes:
# - workspace name will be postfixed with -rescue per default
# - Port should be at least 18789 + 20 Ports,
#   better choose completely different base port, like 19789,
# - rest of the onboarding is the same as normal

# To install the service (if not happened automatically during onboarding)
openclaw --profile rescue gateway install

​

Mapeamento de portas (derivadas)

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

​

Notas de Browser/CDP (armadilha comum)

• Não fixe browser.cdpUrl nos mesmos valores em várias instâncias.
• Cada instância precisa de sua própria porta de controle do browser e intervalo de CDP (derivado 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 com env

OPENCLAW_CONFIG_PATH=~/.openclaw/main.json \
OPENCLAW_STATE_DIR=~/.openclaw-main \
openclaw gateway --port 18789

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

​

Verificações rápidas

openclaw --profile main status
openclaw --profile rescue status
openclaw --profile rescue browser status