OpenClaw 업데이트 후 'Cannot find module' 오류 해결 방법

문제: OpenClaw 업데이트 후 누락된 모듈

OpenClaw를 2026.3.24 버전에서 2026.4.5로 업데이트한 사용자들이 Cannot find module '@buape/carbon' 오류를 겪고 있습니다. 이 문제는 일주일 이상 전에 풀 리퀘스트에서 수정되었다고 보고되었지만, 일부 설치에서는 여전히 문제가 발생하고 있습니다.

누락된 패키지를 전역으로 수동 설치하는 것은 권장되지 않습니다. 나중에 의존성 불일치를 초래할 수 있기 때문입니다.

해결 방법: 설치 후 스크립트를 수동으로 실행

해결 방법은 업데이트 과정에서 자동으로 실행되었어야 할 설치 후 스크립트를 수동으로 실행하는 것입니다.

수정 단계

1. OpenClaw 설치 위치 확인:
   which openclaw를 실행하여 어떤 패키지 관리자(pnpm 또는 npm)가 설치를 관리하는지 확인합니다.
2. 전역 설치 디렉토리 찾기:
   패키지 관리자에 따라 pnpm root -g 또는 npm root -g를 실행합니다.
3. OpenClaw 디렉토리로 이동:
   cd $(pnpm root -g)/openclaw 또는 npm에 해당하는 명령어를 실행합니다.
4. 설치 후 스크립트 실행:
   node scripts/postinstall-bundled-plugins.mjs를 실행합니다.
5. 완료 대기:
   스크립트는 로그를 표시하지 않고 실행됩니다. 완료될 때까지 기다립니다.
6. 수정 확인:
   openclaw doctor를 실행하여 설치가 올바르게 작동하는지 확인합니다.

이 방법은 수동 패키지 설치로 발생할 수 있는 버전 불일치를 만들지 않으면서 의존성을 올바르게 설치합니다.