다중 게이트웨이 (동일 호스트)
일반적으로 하나의 게이트웨이를 사용하는 것이 좋습니다. 하나의 게이트웨이는 여러 메시징 연결과 에이전트를 처리할 수 있습니다. 더 강력한 격리 또는 중복성이 필요한 경우(예: 구조 봇), 격리된 프로필/포트를 사용하여 별도의 게이트웨이를 실행하세요.격리 체크리스트 (필수)
OPENCLAW_CONFIG_PATH— 인스턴스별 설정 파일OPENCLAW_STATE_DIR— 인스턴스별 세션, 인증 정보, 캐시agents.defaults.workspace— 인스턴스별 작업 공간 루트gateway.port(또는--port) — 인스턴스별 고유 포트- 파생 포트 (브라우저/캔버스)가 중첩되지 않아야 함
권장 방법: 프로필 (--profile)
프로필은 OPENCLAW_STATE_DIR + OPENCLAW_CONFIG_PATH를 자동으로 범위 지정하고 서비스 이름에 접미사를 붙입니다.
구조 봇 가이드
같은 호스트에서 두 번째 게이트웨이를 다음 항목이 각각 독립적으로 구성된 상태로 실행합니다:- 프로필/설정
- 상태 디렉터리
- 작업 공간
- 기본 포트 (및 파생 포트)
설치 방법 (구조 봇)
포트 매핑 (파생)
기본 포트 =gateway.port (또는 OPENCLAW_GATEWAY_PORT / --port).
- 브라우저 제어 서비스 포트 = 기본값 + 2 (루프백 전용)
- 캔버스 호스트는 게이트웨이 HTTP 서버에서 제공됩니다 (포트는
gateway.port와 동일) - 브라우저 프로필 CDP 포트는
browser.controlPort + 9 .. + 108에서 자동 할당됩니다
브라우저/CDP 주의사항 (흔한 실수)
- 여러 인스턴스에서
browser.cdpUrl을 동일한 값으로 고정하지 마십시오. - 각 인스턴스는 자체 브라우저 제어 포트와 CDP 범위(게이트웨이 포트에서 파생)를 필요로 합니다.
- 명시적인 CDP 포트가 필요한 경우, 인스턴스별로
browser.profiles.<name>.cdpPort를 설정하세요. - 원격 Chrome:
browser.profiles.<name>.cdpUrl을 사용하세요 (프로필별, 인스턴스별).