OpenClaw 3.22 업그레이드 체크리스트: 실패에서 배운 개발자의 실용적 단계

OpenClaw 3.22로 업데이트하기 전에

.env 파일에서 CLAWDBOT_ 또는 MOLTBOT_ 접두사가 붙은 변수가 있는지 확인하세요. 버전 3.22에서는 이러한 모든 변수가 폴백이나 호환성 없이 제거되었습니다. 해당 변수가 있다면 에이전트가 시작되지 않고 오류 메시지도 도움이 되지 않을 것입니다. 먼저 모든 것을 OPENCLAW_로 이름을 변경하세요. 2월 중순 이전에 OpenClaw를 설정했다면 거의 확실하게 이러한 변수 중 하나 이상을 가지고 있을 것입니다.

어떤 작업도 하기 전에 openclaw backup create를 실행하세요. 필요한 경우 즉시 롤백할 수 있도록 현재 Docker 이미지를 :pre-upgrade로 태깅하는 것을 고려해 보세요.

OpenClaw 3.22로 업데이트한 후

openclaw doctor --fix를 실행하세요. 이 명령은 대부분의 설정 마이그레이션을 자동으로 처리합니다.

어떤 채널에서든 /tools를 확인하여 실제로 사용 가능한 도구가 무엇인지 확인하세요. 버전 3.22에서는 플러그인 SDK 표면이 변경되었으며(openclaw/extension-api에서 openclaw/plugin-sdk/*로 이동), 이전 가져오기 경로를 사용하는 타사 플러그인은 조용히 로드되지 않을 것입니다.

openclaw secrets audit을 실행하여 작업 공간의 일반 텍스트 API 키를 찾으세요. 개발자는 스킬 설정 파일에 완전히 잊혀진 두 개의 키를 발견했습니다.

3.22의 새로운 기능

• /btw 사이드 대화
• CLI에서 네이티브 ClawHub 설치(skill.md 파일을 수동으로 다운로드하는 대신 openclaw skills install 사용)
• 죽은 세션 정리
• 실패한 작업이 하룻밤 사이에 API 예산을 소진하지 않도록 하는 Cron 재시도 백오프
• 10분 대신 48시간 에이전트 타임아웃으로, 이제 긴 작업이 실제로 완료됩니다

개발자는 업그레이드가 순조롭게 진행될 것이라고 가정하기보다는 신중한 업그레이드를 위해 30-45분을 예산으로 잡을 것을 권장하며, 업그레이드가 완료된 후에는 "진정으로 더 나아졌다"고 언급합니다.