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

​
복구 봇 빠른 시작

가장 간단한 복구 봇 설정은 다음과 같습니다.
  • 기본 봇은 기본 프로필에서 유지하십시오.
  • 자체 Telegram 봇 토큰을 사용하여 --profile rescue에서 복구 봇을 실행하십시오.
  • 복구 봇에는 다른 기본 포트(예: 19789)를 지정하십시오.
이렇게 하면 기본 봇이 중단된 경우에도 복구 봇으로 디버깅하거나 구성 변경 사항을 적용할 수 있습니다. 파생된 브라우저/CDP 포트가 충돌하지 않도록 기본 포트 사이에 최소 20개의 포트 간격을 두십시오.
기본 봇이 이미 실행 중이라면 일반적으로 이것만으로 충분합니다. 온보딩에서 복구 서비스를 이미 설치했다면 마지막 gateway install을 건너뛰십시오. openclaw --profile rescue onboard 진행 중에는 다음과 같이 하십시오.
  • 복구 계정 전용의 별도 Telegram 봇 토큰을 사용하십시오(운영자 전용으로 유지하기 쉽고, 기본 봇의 채널/앱 설치와 독립적이며, 간단한 DM 기반 복구 경로를 제공합니다).
  • rescue 프로필 이름을 유지하십시오.
  • 기본 봇보다 최소 20 높은 기본 포트를 사용하십시오.
  • 이미 직접 관리하는 작업 공간이 없다면 기본 복구 작업 공간을 사용하십시오.

​
--profile rescue onboard에서 변경되는 사항

--profile rescue onboard은 일반적인 온보딩 흐름을 실행하지만 모든 항목을 별도의 프로필에 기록하므로, 복구 봇에는 다음 항목이 별도로 제공됩니다.
  • 프로필/구성 파일
  • 상태 디렉터리
  • 작업 공간(기본값: ~/.openclaw/workspace-rescue)
  • 관리형 서비스 이름
  • 기본 포트(및 파생 포트)
  • Telegram 봇 토큰
그 외의 프롬프트는 일반 온보딩과 동일합니다.

​
일반적인 다중 Gateway 설정

호스트 하나에서 Gateway 두 개 이상을 실행할 때도 동일한 격리 패턴을 사용할 수 있습니다. 추가 Gateway마다 고유한 명명된 프로필과 기본 포트를 지정하십시오.
양쪽 모두에서 명명된 프로필을 사용해도 됩니다.
서비스에도 같은 패턴을 적용합니다.
대체 운영자 경로에는 복구 봇 빠른 시작을 사용하고, 서로 다른 채널, 테넌트, 작업 공간 또는 운영 역할에 걸쳐 여러 개의 장기 실행 Gateway를 운용하려면 일반 프로필 패턴을 사용하십시오.

​
격리 체크리스트

각 Gateway 인스턴스에서 다음 항목을 고유하게 유지하십시오. 이러한 항목 중 하나라도 공유하면 구성, 상태 또는 포트 충돌이 발생합니다. OPENCLAW_ALLOW_MULTI_GATEWAY=1이 구성별 싱글턴을 건너뛰더라도 Gateway 시작 시 고유한 상태 디렉터리 소유권을 적용합니다.

​
포트 매핑(파생)

기본 포트 = gateway.port(또는 OPENCLAW_GATEWAY_PORT / --port).
  • 브라우저 제어 서비스 포트 = 기본 포트 + 2(루프백 전용).
  • 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을 사용하십시오(프로필별, 인스턴스별).

​
수동 환경 변수 예시

​
빠른 확인

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

​
관련 문서