2026 OpenClaw WhatsApp 연동(Linux 클라우드 VPS): QR 코드 페어링, 세션 지속성과 멀티 채널 공존—재현 단계와 연결 끊김·429 계층별 FAQ

Linux 클라우드 VPS에서 WhatsApp 채널을 붙이는 일은 곧 「모바일 QR 인증 + 웹류 장시간 연결」을 서버에 맡기는 문제입니다. 게이트웨이 프로세스는 상주해야 하고, 토큰·세션 파일은 반드시 지속 볼륨에 두며, 호스트 시각이 믿을 만해야 QR 직후 끊김과 429 한도를 계층적으로 나눠 점검할 수 있습니다. 아래는 운영에서 자주 쓰는 순서이며, 바이너리 이름은 배포판 문서를 따르세요.

1. 전제: HTTPS, 이그레스, 디렉터리 분리

공개 HTTPS(체인·리버스 프록시 대상 포트)를 먼저 맞춘 뒤 openclaw doctor로 TLS·쓰기 권한을 확인합니다. Slack·Telegram과 같이 쓸 때는 WhatsApp 전용 OPENCLAW_HOME 또는 프로필을 나눠 동일 데이터 디렉터리에 두 프로세스가 동시에 쓰지 않게 하세요. 온보딩·HTTPS·업그레이드 롤백 흐름은 다음 글과 맞춰 보면 재현이 빨라집니다: OpenClaw Gateway 운영(Linux): HTTPS 온보딩·롤백 실무.

2. 재현 골격(systemd 사용자 유닛 예시)

# 1) 전용 계정 + 지속 디렉터리
sudo useradd -r -m -s /bin/bash openclaw-wa
sudo mkdir -p /var/lib/openclaw-wa/{data,logs} && sudo chown -R openclaw-wa: /var/lib/openclaw-wa

# 2) onboard에서 WhatsApp/플러그인 선택, 자격 경로를 위 data로
# 3) 사용자 systemd(유닛 파일명은 배포판 기준)
loginctl enable-linger openclaw-wa
sudo -u openclaw-wa systemctl --user enable --now openclaw-gateway.service

컨테이너라면 data를 네임드 볼륨으로 마운트하고, 이미지 교체 전에 반드시 백업하세요. 볼륨이 비어 있으면 QR을 여러 번 찍어도 재부팅마다 처음으로 돌아갑니다.

3. QR 페어링과 세션 지속성

첫 기동 시 로그나 TTY에 나온 QR을, 본인 휴대폰 WhatsApp의 「연결된 기기」로 스캔합니다. 자격 데이터는 JSON·KV 형태가 흔하니 반드시 위 지속 경로에만 기록되게 하세요. 시각이 크게 어긋나면 「스캔 직후 즉시 로그아웃」이 잦으므로 chrony 또는 timedatectl로 NTP를 맞춘 다음 애플리케이션 로그를 봅니다. macOS 쪽에서 동일 스택을 검증할 때는 launchd·경로 차이를 한 번에 정리한 2026 클라우드 Mac에서 OpenClaw 배포: Linux VPS와 다른 macOS 검증, launchd 상주, 재현 가능한 FAQ도 함께 참고하면 좋습니다.

4. 끊김과 429: 계층별 점검표