🦞 28. OpenClaw 듀얼 릴레이 운영 가이드

듀얼 머신(예: 37/39)을 번갈아 쓰는 환경에서는, 브라우저 릴레이가 안 붙는 원인의 대부분이 “포트 충돌”이나 “계정 혼선”에서 나옵니다. 한 번만 표준 템플릿으로 정리해두면 이후에는 rel37, rel39만 호출해서 바로 작업을 시작할 수 있습니다.

이 문서는 실제 운영 중 자주 터지는 실패 패턴을 기준으로, 경로·호스트·계정을 익명화한 상태로 재사용 가능한 기본 틀을 제공합니다.

안내: 본문은 생성형 AI를 활용해 초안을 만든 뒤, 실제 운영 흐름 기준으로 편집·검수했습니다.

flowchart LR
A[요청: rel37/rel39 실행] --> B[SSH Config Host 매핑]
B --> C[로컬 포트 분리 포워딩]
C --> D{프로필 선택}
D --> E[기본: profile=openclaw]
D --> F[예외: profile=chrome + 탭 Relay ON]
E --> G[작업/검증]
F --> G

한 줄 결론

듀얼 릴레이 운영의 기준선은 **기본 profile=openclaw + 예외 profile=chrome(탭 attach 필수)**로 고정하고, 포트/계정/Host 별칭을 분리하는 것이다.

맥락 보완

문제가 생길 때 대부분은 OpenClaw 자체 이슈가 아니라 환경 불일치다. 예를 들어 39는 무비번인데 37은 비번 프롬프트가 뜨거나, 로컬 18789/18792가 이미 점유되어 포워딩이 실패한다. 그래서 “머신별 분리 포트 + Host 별칭 + 스크립트 분리”가 실무에서는 가장 안전하다.

핵심 요약

• 브라우저 자동화 기본값은 profile=openclaw로 고정하고, 기존 로그인 세션이 꼭 필요할 때만 profile=chrome으로 쓴다(탭 attach 필수).
• 로컬 기본 포트(18789/18792) 직접 재사용보다, 머신별 분리 포트(예: 28789/28792, 38789/38792)가 안정적이다.
• ~/.openclaw-relay/*.sh로 실행 파일을 분리하면 alias/function 충돌을 줄일 수 있다.
• ~/.ssh/config에서 Host 별칭(relay37, relay39)을 쓰면 사용자명 혼선을 막을 수 있다.
• 종료 명령(rel37_off, rel39_off)을 함께 두면 stale socket 정리가 쉬워진다.

용어를 한 번에 이해하기

릴레이는 “원격 장비의 문을 내 컴퓨터의 다른 문으로 복사해 붙이는 작업”에 가깝다. 문제는 이미 문을 누가 쓰고 있으면(포트 점유) 같은 번호로 복사할 수 없다는 점이다. 그래서 장비별로 문 번호를 분리해 두는 게 핵심이다.

칠판 판서형 치트시트

1. 기본 자동화는 profile=openclaw로 고정한다.
2. 실제 Chrome 탭이 필요할 때만 profile=chrome + Relay ON을 쓴다.
3. 포트는 장비별로 분리한다(37→2878x, 39→3878x).
4. 연결 확인은 rel_ls + ssh -o BatchMode=yes <host> 'echo ok'로 끝낸다.

개념 분리: 무엇을 표준화할까

• 프로필 계층: 기본 openclaw, 예외 chrome(+탭 attach)
• 접속 계층: HostName/User/IdentityFile
• 포트 계층: 머신별 로컬 포워딩 포트
• 실행 계층: rel37, rel39, rel_ls, rel37_off, rel39_off
• 검증 계층: LISTEN 확인 + 무비번 로그인 확인 + profile별 tabs 상태 확인

원인 분해: 왜 자주 실패할까

1. 로컬 18789/18792가 이미 사용 중인데 같은 포트로 다시 포워딩함.
2. 37/39 사용자명이 다르지만 스크립트는 한 사용자명으로 고정됨.
3. .zshrc에서 alias와 함수를 같은 이름으로 동시에 정의함.
4. SSH control socket이 남아서 설정 변경이 즉시 반영되지 않음.

대응 설계: 익명화된 표준 템플릿

아래 템플릿은 개인 식별 정보 없이 그대로 재사용할 수 있다.

1) 실행 스크립트 경로

mkdir -p ~/.openclaw-relay

2) ~/.openclaw-relay/rel37.sh

#!/usr/bin/env bash
ssh -fN -M -S "$HOME/.ssh/rel37.sock" \
  -o ExitOnForwardFailure=yes \
  -o ServerAliveInterval=30 \
  -o ServerAliveCountMax=3 \
  -L 28789:127.0.0.1:18789 \
  -L 28792:127.0.0.1:18792 \
  relay37

3) ~/.openclaw-relay/rel39.sh

#!/usr/bin/env bash
ssh -fN -M -S "$HOME/.ssh/rel39.sock" \
  -o ExitOnForwardFailure=yes \
  -o ServerAliveInterval=30 \
  -o ServerAliveCountMax=3 \
  -L 38789:127.0.0.1:18789 \
  -L 38792:127.0.0.1:18792 \
  relay39

4) ~/.ssh/config (익명화 템플릿)

Host relay37
  HostName <HOST_37_IP_OR_DNS>
  User <HOST_37_USER>
  IdentityFile ~/.ssh/<HOST_37_KEY>
  IdentitiesOnly yes
 
Host relay39
  HostName <HOST_39_IP_OR_DNS>
  User <HOST_39_USER>
  IdentityFile ~/.ssh/<HOST_39_KEY>
  IdentitiesOnly yes

5) ~/.zshrc alias

unalias rel37 rel39 rel_ls rel37_off rel39_off 2>/dev/null
 
alias rel37="$HOME/.openclaw-relay/rel37.sh"
alias rel39="$HOME/.openclaw-relay/rel39.sh"
alias rel_ls='lsof -nP -iTCP:28789 -iTCP:28792 -iTCP:38789 -iTCP:38792 -sTCP:LISTEN'
alias rel37_off='ssh -S $HOME/.ssh/rel37.sock -O exit relay37 2>/dev/null || true'
alias rel39_off='ssh -S $HOME/.ssh/rel39.sock -O exit relay39 2>/dev/null || true'

6) 적용 및 검증

chmod +x ~/.openclaw-relay/rel37.sh ~/.openclaw-relay/rel39.sh
exec zsh
 
rel37_off; rel39_off
rm -f ~/.ssh/rel37.sock ~/.ssh/rel39.sock
 
rel37
rel39
rel_ls
 
ssh -o BatchMode=yes relay37 'echo relay37-ok'
ssh -o BatchMode=yes relay39 'echo relay39-ok'
 
# 프로필별 점검
openclaw browser --browser-profile openclaw status
openclaw browser --browser-profile openclaw tabs
openclaw browser --browser-profile chrome status
openclaw browser --browser-profile chrome tabs

20분 도입 루틴

• 5분: 브라우저 기본 프로필을 openclaw로 고정(팀 공통 규칙)
• 5분: SSH Host 별칭 2개(relay37, relay39) 작성
• 5분: rel37.sh / rel39.sh 생성 + 실행권한 부여
• 5분: rel_ls, BatchMode, browser tabs 검증으로 무비번/포트/프로필 상태 확인

현장형 미니 사례

사례 A (성공)

한 팀은 37/39를 모두 18789/18792로 포워딩하던 상태에서, 머신별 분리 포트(2878x/3878x)로 바꾼 뒤 포트 충돌 이슈가 사라졌다. 운영자가 연결 상태를 묻는 시간 자체가 줄었다.

사례 B (실패)

다른 팀은 .zshrc에 rel37() 함수와 alias rel37=...를 함께 유지해 parse error near '()'가 반복됐다. 함수 블록을 제거하고 alias 방식으로 통일하자 즉시 복구됐다.

적용 체크리스트

• 기본 브라우저 자동화 프로필이 openclaw로 고정되어 있다.
• chrome 프로필은 예외 작업에서만 사용하고 탭 attach 필요성을 팀이 인지한다.
• rel37/rel39 포트가 서로 다르다.
• 37/39 사용자 계정이 SSH config에 분리되어 있다.
• alias와 함수가 같은 이름으로 중복되지 않는다.
• rel37_off, rel39_off 정리 명령이 동작한다.
• 무비번 검증(BatchMode=yes)이 통과한다.

다음 읽기

• 12. 브라우저 릴레이 연동 구조
• 18. 텔레그램 5분 복구
• 22. 텔레그램 그룹 협업 세팅 + 보안
• 23. node run plaintext ws 보안 에러 해결

※ AI 생성 결과물을 포함한 문서입니다. 최종 배포 전 실제 네트워크/권한 정책에 맞춰 HostName, User, Key 경로를 다시 확인하세요.