AI 에이전트로 OpenClaw 업그레이드 자동화: 현장 검증된 플레이북

OpenClaw 업그레이드는 문제를 일으키기로 악명 높습니다. 레거시 구성 마이그레이션, 자동 기능 변경, 프로세스 관리 엣지 케이스 등이 있습니다. 한 개발자는 같은 문제를 반복적으로 발견하는 것에 지쳐 Hermes 에이전트에게 전체 업그레이드 프로세스를 처리하도록 가르쳤습니다. 그 결과, 최근 2026.7.1 → 2026.8.1('OpenClaw 2.0') 업그레이드는 '몇 시간의 긴장되는 문제 해결'에서 '플레이북 실행, 두 가지 알려진 문제 발생, 각각 1분 미만으로 자동 진단'으로 바뀌었습니다.

설정

작성자는 소규모 플릿을 운영합니다: EC2 게이트웨이 서버와 두 대의 Mac(MacBook Pro 및 Mac mini)으로, 각각 OpenClaw CLI와 네이티브 앱을 실행합니다. 모두 동일한 백엔드를 가리킵니다. 이 다중 호스트 설정은 '그냥 재시작하고 확인'을 비현실적으로 만듭니다.

핵심 아이디어: 에이전트의 메모리가 제품이다

모든 에이전트는 doctor --fix를 실행하고 출력을 읽을 수 있습니다. 실제 가치는 다음과 같은 때 발생합니다:

• 발견한 내용을 검색 가능한 형식으로 기록합니다.
• 절차적 지식(스킬/런북)을 업데이트하여 다음 업그레이드가 '우리가 아는 것'에서 시작하도록 합니다.
• 과거 사건을 검색 가능한 메모리 저장소와 교차 참조합니다.

작성자는 세 가지 구성 요소를 사용합니다:

• 스킬 파일: 약 9개월간의 업그레이드로 구축된 함정이 포함된 구조화된 절차입니다.
• 의미론적 메모리 저장소: MemPalace (github.com/mempalace/mempalace)는 '장치 ID 충돌 앱'과 같은 퍼지 검색을 위해 과거 사건 기록을 인덱싱합니다.
• 공유 컨텍스트 파일: OpenClaw 측 에이전트도 읽으므로 Hermes가 배운 교훈이 고립되지 않습니다.

2026.8.1에서 실제로 무엇이 잘못되었나

세 가지 특정 문제와 그 이유를 두 번 놀라지 않아야 하는 이유:

1. doctor --repair는 일회성 작업이 아닙니다. 성숙한 다중 에이전트 설치에서는 반복적으로 실행해야 합니다. 각 패스는 레거시 구성/상태의 한 계층을 지우고 다음 계층을 드러냅니다. 작성자는 게이트웨이에서만 깨끗한 종료 전에 11번의 패스가 필요했습니다. 2번의 패스 후 포기하면 잘못된 진단으로 이어집니다.
2. 다중 에이전트 게이트웨이는 명시적 소유권이 필요합니다. 게이트웨이당 둘 이상의 에이전트 페르소나를 실행하는 경우 새 버전에서는 누가 '앰비언트/시스템 수준 작업'을 소유하는지 선언해야 합니다. 두 가지 선언 모드가 있습니다: 엄격 및 단순. 엄격 모드는 이해할 수 없는 크래시 루프를 일으켰습니다. 단순 모드는 모든 엣지 케이스를 매핑하지 않는 한 더 안전합니다.
3. 레거시 구성 파일이 전체 복구 파이프라인을 차단할 수 있습니다. 하나의 오래된 JSON 파일(exec-approvals)이 특별히 해결될 때까지 다른 모든 수정이 적용되는 것을 조용히 방해했습니다.

이 중 어느 것도 OpenClaw 특정 도구가 아닙니다. 에이전트가 기록할 장소와 그렇게 하는 습관을 주는 것입니다. 동일한 접근 방식은 Claude Code, Codex 또는 도구가 있는 모든 에이전트에서 작동합니다.