OpenClaw 2026.9.1 마이그레이션: 레거시 멀티 에이전트 업그레이드 노트 (r/openclaw 출처)

OpenClaw를 주요 버전 간에 업그레이드하는 것은 부담스러울 수 있지만, 최근 r/openclaw 게시물에 따르면 레거시 멀티 에이전트 설정이 2026.7.1-2에서 2026.9.1로 큰 문제 없이 이동했습니다. 특히 AI 코딩 에이전트가 단계를 처리하도록 맡길 때 더욱 그렇습니다.

레거시 설정

마이그레이션은 다음 구성에서 시작되었습니다:

• OpenClaw의 전역 npm 설치
• 버전 2026.7.1-2
• 사용자 systemd 게이트웨이 서비스
• 에이전트별 작업 공간이 있는 여러 구성된 에이전트
• 그룹별 라우팅이 있는 WhatsApp 채널
• 브라우저 프로필 및 여러 관리 플러그인

발견된 문제

업그레이드 후에야 실제로 변경된 사항을 알 수 있습니다. 확인된 문제는 다음과 같습니다:

• 2026.9.1에서 거부된 여러 레거시 구성 키
• 멀티 에이전트 소유권에 명시적 선언 필요
• 공유 SQLite 상태 데이터베이스에 스키마 마이그레이션 필요
• 레거시 작업 공간 설정 상태 마이그레이션 필요
• 여러 공식 플러그인이 여전히 이전 버전
• WhatsApp에 일치하지 않는 메시지에 대한 대체 에이전트 없음
• 웹 UI 역방향 프록시에 신뢰할 수 있는 전달 클라이언트 속성 필요
• 서비스 정의에 오래되었거나 비표준 메타데이터 포함

해결 방법

업그레이드는 Codex(VS Code 확장을 통해 OpenClaw 머신에 원격으로 연결)에 위임되었습니다. 전체 프로세스는 약 30분이 걸렸습니다. 생성된 요약의 주요 단계는 다음과 같습니다:

• 구성, 비밀, 서비스 파일, 패키지 메타데이터 및 런타임 상태의 날짜가 있는 롤백 백업 생성.
• 내장 업데이터를 사용하여 OpenClaw를 2026.9.1로 업데이트.
• 더 이상 사용되지 않는 키를 제거하고 지원되는 시간 초과 설정을 변환하여 구성 마이그레이션.
• 멀티 에이전트 소유권을 명시적으로 설정.
• SQLite, 작업 공간, 장치 및 플러그인 상태 마이그레이션을 완료하기 위해 외부 서비스 복구 정책으로 Doctor 실행.
• systemd 게이트웨이 서비스 정의 새로 고침.
• 공식 플러그인을 2026.9.1로 업데이트.
• main을 기본 하트비트 소유자 및 일치하지 않는 WhatsApp 라우팅 에이전트로 설정.
• 로컬 역방향 프록시에 대해 범위가 제한된 신뢰할 수 있는 프록시 항목 추가.

결과 및 교훈

마이그레이션 후 게이트웨이는 2026.9.1에서 실행되고, 구성이 검증되며, 서비스가 활성화되고, 로컬 HTTP/RPC 리스너가 응답하며, WhatsApp이 인바운드 메시지를 수신 중이라고 보고하고, 하트비트 처리가 정상적으로 시작됩니다.

주요 교훈: 큰 버전 점프의 경우 먼저 백업하고, 스키마 및 상태 마이그레이션을 예상하고, 게이트웨이 소유권과 멀티 에이전트 라우팅을 모두 확인하십시오.