가장 권장되는 설정
대부분의 사용자에게 가장 단순한 구조 봇 설정은 다음과 같습니다.- 기본 프로필에서 메인 봇 유지
--profile rescue에서 구조 봇 실행- 구조 계정에 완전히 별도의 Telegram 봇 사용
- 구조 봇은
19789같은 다른 기본 포트에 유지
구조 봇 빠른 시작
다른 방법을 선택해야 할 강한 이유가 없다면 이 경로를 기본값으로 사용하세요.openclaw --profile rescue onboard 중에는 다음을 수행하세요.
- 별도의 Telegram 봇 토큰 사용
rescue프로필 유지- 메인 봇보다 최소 20 이상 높은 기본 포트 사용
- 이미 직접 관리하는 구조 워크스페이스가 없다면 기본 구조 워크스페이스 수락
gateway install은 필요하지 않습니다.
작동 원리
구조 봇은 자체 항목을 가지므로 독립적으로 유지됩니다.- 프로필/구성
- 상태 디렉터리
- 워크스페이스
- 기본 포트(및 파생 포트)
- Telegram 봇 토큰
- 운영자 전용으로 유지하기 쉬움
- 별도의 봇 토큰과 ID
- 메인 봇의 채널/앱 설치와 독립적
- 메인 봇이 고장났을 때 간단한 DM 기반 복구 경로 제공
--profile rescue onboard가 변경하는 내용
openclaw --profile rescue onboard는 일반 온보딩 흐름을 사용하지만
모든 내용을 별도의 프로필에 기록합니다.
실제로 이는 구조 봇이 자체 항목을 갖는다는 뜻입니다.
- 구성 파일
- 상태 디렉터리
- 워크스페이스(기본값
~/.openclaw/workspace-rescue) - 관리형 서비스 이름
일반 다중 Gateway 설정
위의 구조 봇 레이아웃이 가장 쉬운 기본값이지만, 동일한 격리 패턴은 하나의 호스트에서 임의의 두 개 또는 여러 Gateway에도 적용됩니다. 더 일반적인 설정에서는 각 추가 Gateway에 자체 이름 있는 프로필과 자체 기본 포트를 지정하세요.격리 체크리스트
각 Gateway 인스턴스마다 다음 항목을 고유하게 유지하세요.OPENCLAW_CONFIG_PATH— 인스턴스별 구성 파일OPENCLAW_STATE_DIR— 인스턴스별 세션, 자격 증명, 캐시agents.defaults.workspace— 인스턴스별 워크스페이스 루트gateway.port(또는--port) — 인스턴스별 고유 값- 파생된 브라우저/canvas/CDP 포트
포트 매핑(파생)
기본 포트 =gateway.port(또는 OPENCLAW_GATEWAY_PORT / --port).
- 브라우저 제어 서비스 포트 = 기본 + 2(루프백 전용)
- canvas 호스트는 Gateway HTTP 서버에서 제공됨(
gateway.port와 동일한 포트) - 브라우저 프로필 CDP 포트는
browser.controlPort + 9 .. + 108범위에서 자동 할당됨
브라우저/CDP 참고 사항(흔한 함정)
- 여러 인스턴스에서
browser.cdpUrl을 같은 값으로 고정하지 마세요. - 각 인스턴스에는 자체 브라우저 제어 포트와 CDP 범위가 필요합니다(해당 gateway 포트에서 파생).
- 명시적 CDP 포트가 필요하다면 인스턴스마다
browser.profiles.<name>.cdpPort를 설정하세요. - 원격 Chrome:
browser.profiles.<name>.cdpUrl을 사용하세요(프로필별, 인스턴스별).
수동 env 예시
빠른 확인
gateway status --deep는 이전 설치에서 남은 오래된 launchd/systemd/schtasks 서비스를 찾는 데 도움이 됩니다.multiple reachable gateway identities detected같은gateway probe경고 텍스트는 의도적으로 둘 이상의 격리된 gateway를 실행할 때, 또는 OpenClaw가 도달 가능한 probe 대상이 동일한 gateway임을 증명할 수 없을 때만 예상됩니다. 동일한 gateway로 향하는 SSH 터널, 프록시 URL 또는 구성된 원격 URL은 전송 포트가 다르더라도 여러 전송 수단을 가진 하나의 gateway입니다.