여러 Gateway

대부분의 설정에는 Gateway 하나면 충분합니다. 단일 Gateway가 여러 메시징 연결과 에이전트를 처리합니다. 더 강력한 격리나 이중화가 필요한 경우(예: 복구 봇)에만 격리된 프로필/포트로 별도의 Gateway를 실행하세요.

복구 봇 빠른 시작

가장 간단한 복구 봇 설정은 다음과 같습니다.

• 기본 봇은 기본 프로필에서 유지합니다.
• 자체 Telegram 봇 토큰을 사용하여 --profile rescue에서 복구 봇을 실행합니다.
• 복구 봇에는 다른 기본 포트(예: 19789)를 지정합니다.

이렇게 하면 기본 봇이 중단되어도 복구 봇을 통해 디버깅하거나 구성 변경을 적용할 수 있습니다. 파생된 브라우저/CDP 포트가 충돌하지 않도록 기본 포트 간에 최소 20개의 포트 간격을 두세요.

# 복구 봇(별도의 Telegram 봇, 별도의 프로필, 포트 19789)openclaw --profile rescue onboardopenclaw --profile rescue gateway install --port 19789

기본 봇이 이미 실행 중이라면 일반적으로 이것만으로 충분합니다. 온보딩 과정에서 복구 서비스가 이미 설치되었다면 마지막 gateway install은 건너뛰세요.

openclaw --profile rescue onboard 실행 중에는 다음과 같이 설정하세요.

• 복구 계정 전용의 별도 Telegram 봇 토큰을 사용합니다(운영자 전용으로 유지하기 쉽고, 기본 봇의 채널/앱 설치와 독립적이며, 간단한 DM 기반 복구 경로를 제공합니다).
• rescue 프로필 이름을 유지합니다.
• 기본 봇보다 최소 20 높은 기본 포트를 사용합니다.
• 이미 직접 관리하는 워크스페이스가 없다면 기본 복구 워크스페이스를 사용합니다.

--profile rescue onboard가 변경하는 항목

--profile rescue onboard는 일반 온보딩 흐름을 실행하지만 모든 항목을 별도의 프로필에 기록하므로, 복구 봇에는 다음 항목이 독립적으로 생성됩니다.

• 프로필/구성 파일
• 상태 디렉터리
• 워크스페이스(기본값: ~/.openclaw/workspace-rescue)
• 관리형 서비스 이름
• 기본 포트(및 파생 포트)
• Telegram 봇 토큰

그 외의 프롬프트는 일반 온보딩과 동일합니다.

일반적인 다중 Gateway 설정

호스트 하나에서 Gateway 두 개 이상을 실행할 때도 동일한 격리 패턴을 사용할 수 있습니다. 추가하는 각 Gateway에 고유한 이름의 프로필과 기본 포트를 지정하세요.

# 기본(기본 프로필)openclaw setupopenclaw gateway --port 18789 # 추가 Gatewayopenclaw --profile ops setupopenclaw --profile ops gateway --port 19789

양쪽 모두에 이름이 지정된 프로필을 사용할 수도 있습니다.

openclaw --profile main setupopenclaw --profile main gateway --port 18789 openclaw --profile ops setupopenclaw --profile ops gateway --port 19789

서비스에도 동일한 패턴을 적용합니다.

openclaw gateway installopenclaw --profile ops gateway install --port 19789

운영자용 예비 경로에는 복구 봇 빠른 시작을 사용하고, 서로 다른 채널, 테넌트, 워크스페이스 또는 운영 역할에 걸쳐 장기간 실행되는 여러 Gateway에는 일반 프로필 패턴을 사용하세요.

격리 점검 목록

Gateway 인스턴스마다 다음 항목을 고유하게 유지하세요.

이러한 항목을 공유하면 구성 경합과 포트 충돌이 발생합니다.

포트 매핑(파생)

기본 포트 = gateway.port(또는 OPENCLAW_GATEWAY_PORT / --port).

• 브라우저 제어 서비스 포트 = 기본 포트 + 2(local loopback 전용).
• Canvas 호스트는 Gateway HTTP 서버 자체에서 제공됩니다(gateway.port와 동일한 포트).
• 브라우저 프로필 CDP 포트는 browser control port + 9부터 + 108까지의 범위에서 자동 할당됩니다.

구성이나 환경 변수에서 이러한 값을 재정의하는 경우 인스턴스마다 고유하게 유지해야 합니다.

브라우저/CDP 참고 사항(흔한 실수)

• 여러 인스턴스에서 browser.cdpUrl을 동일한 값으로 고정하지 마세요.
• 각 인스턴스에는 자체 브라우저 제어 포트와 CDP 범위가 필요합니다(Gateway 포트에서 파생됨).
• CDP 포트를 명시적으로 지정하려면 인스턴스마다 browser.profiles.<name>.cdpPort를 설정합니다.
• 원격 Chrome에는 browser.profiles.<name>.cdpUrl을 사용합니다(프로필별, 인스턴스별).

수동 환경 변수 예시

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

빠른 확인

openclaw gateway status --deepopenclaw --profile rescue gateway status --deepopenclaw --profile rescue gateway probeopenclaw statusopenclaw --profile rescue statusopenclaw --profile rescue browser status

• gateway status --deep는 이전 설치에서 남은 오래된 launchd/systemd/schtasks 서비스를 감지합니다.
• multiple reachable gateway identities detected와 같은 gateway probe 경고 문구는 둘 이상의 격리된 Gateway를 의도적으로 실행하거나, OpenClaw가 연결 가능한 검사 대상이 동일한 Gateway인지 확인할 수 없는 경우에만 예상되는 메시지입니다. 동일한 Gateway로 연결되는 SSH 터널, 프록시 URL 또는 구성된 원격 URL은 전송 포트가 서로 달라도 여러 전송 방식을 사용하는 하나의 Gateway입니다.

관련 문서

• Gateway 운영 지침서
• Gateway 잠금
• 구성