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분을 예산으로 잡을 것을 권장하며, 업그레이드가 완료된 후에는 "진정으로 더 나아졌다"고 언급합니다.
📖 Read the full source: r/openclaw
👀 See Also
Windows 11 Home에서 Claude Cowork '작업 공간 시작 실패' 오류 해결하기
사용자가 Microsoft Store에서 Windows Subsystem for Linux(WSL2)를 설치하여 Claude Cowork의 Windows 11 Home 시작 오류를 해결했습니다. 이는 기본 VM 기술에 필요한 구성 요소입니다.
OpenClaw에서 별도의 작업 공간으로 서브 에이전트 설정하는 방법
여러 하위 에이전트를 격리된 작업 공간과 다양한 모델로 구성하는 커뮤니티 솔루션
연구에 따르면 효과적인 AI 프롬프트 작성은 공학적 접근이 아닌 협력적 소통이다
동료 검토 연구에 따르면 AI 모델과의 효과적인 프롬프팅은 인간이 사용하는 협력적 의사소통 원칙과 동일하게 작동하며, Lakera의 분석에 따르면 대부분의 프롬프트 실패는 모델의 한계가 아닌 모호함에서 비롯됩니다.
OpenClaw 커뮤니티 스레드: 여러분의 AI 코딩 환경과 월간 비용을 공유해 주세요
r/openclaw의 레딧 스레드는 AI 코딩 에이전트를 사용하는 개발자를 위한 실용적인 자료를 만들기 위해 실제 설정과 비용을 수집합니다. 이 스레드는 토큰 사용량을 줄이는 방법, 효과적인 로컬/클라우드 모델 조합, 일상적으로 사용하기에 충분히 안정적인 구성 등 세 가지 일반적인 질문을 다룹니다.