OpenClaw 2.0舰队迁移：真正出问题的是什么

단일 OpenClaw 인스턴스를 업그레이드하는 것은 하나의 일이지만, 실시간 클라이언트의 플릿 전체에 대해 수행한다는 것은 모든 중단이 배가된다는 것을 의미합니다. 한 팀이 OpenClaw 2.0으로 마이그레이션하는 데 하루를 보냈고 가장 까다로운 부분을 공유했습니다. 실제로 무엇이 문제였고 어떻게 피할 수 있는지 소개합니다.

구성 스키마가 더 엄격해졌습니다

2.0에서는 구성 스키마가 더 엄격해졌고 여러 필드가 이동했습니다(env 키, TTS, 미디어 모델). 가장 큰 함정은 doctor --fix가 알 수 없는 필드를 조용히 삭제한다는 것입니다. 모델 키가 더 이상 사용되지 않는 영역에 있으면 해당 필드와 함께 사라질 수 있습니다. 팀은 키를 잃지 않기 위해 doctor를 실행하기 전에 구성을 수동으로 다시 작성했습니다.

외부 플러그인이 게이트웨이를 중단시킵니다

WhatsApp, Brave, Discord, Perplexity는 더 이상 코어 이미지에 포함되지 않으며 외부 플러그인입니다. 구성에서 여전히 이를 참조하면 게이트웨이가 준비 상태가 되지 않고, 컨테이너가 재시작 루프에 빠지며, 외부에서는 502처럼 보입니다. 플러그인을 이미지에 추가하는 것만으로는 충분하지 않습니다. 기능 동의가 특정 시스템에 연결되어 있고 doctor가 이를 수락하지 않기 때문입니다. 유일한 해결 방법은 openclaw plugins install ... --accept-capabilities를 별도 단계로 실행하는 것입니다.

기기 페어링: Cloudflare 헤더가 지역성을 깨뜨립니다

웹챗이 PAIRING_REQUIRED를 발생시키기 시작했습니다. 근본 원인: 2.0은 전달된 헤더 없이 루프백 요청만 신뢰합니다. nginx에서 설정하지 않는 것만으로는 충분하지 않습니다. Cloudflare가 자체 헤더를 보내므로 nginx에서 명시적으로 null로 설정해야 합니다. 이는 토큰 문제처럼 보였지만 실제로는 Cloudflare, nginx, OpenClaw의 지역성 로직 간의 충돌이었습니다.

Perplexity 자동 로드 문제

Perplexity는 OpenRouter 키를 감지하면 자동으로 로드되어 동의를 요구합니다. 플러그인을 원하지 않아도 마찬가지입니다. enabled: false로 설정해도 도움이 되지 않습니다. 차단하려면 plugins.deny를 사용해야 합니다.

결론: 기능보다 가동 시간을 우선시하세요

핵심 원칙: 일시적으로 웹 검색이나 특정 채널을 잃는 것이 전체 에이전트를 502로 중단시키는 것보다 낫습니다. 여러 장애를 계획하고 각 구성 요소를 개별적으로 테스트하세요.

이 내용은 OpenClaw를 클라이언트에게 호스팅하는 클라우드 플랫폼의 실제 마이그레이션 보고서를 기반으로 합니다. 업그레이드를 계획 중이라면 소스를 통해 더 많은 세부 사항과 커뮤니티 통찰력을 확인하세요.