AI Briefing업데이트 함정
4.14 just broke the entrypoint for a bunch of people. if your gateway won't start after updating, here's what happened
·2026.04.16 23:27
핵심 내용
4.14 업데이트 뒤 gateway가 안 뜨면 entrypoint 경로 꼬임을 의심해야 한다.
자세히 보기
4.14에서 gateway가 시작되지 않고 entry.js not found나 stale dist chunk 오류가 나면 설정 문제가 아니라 엔트리포인트 해석이 꼬인 경우다.
릴리스 노트의 수정 내용은 업데이트·재설치·doctor 복구가 오래된 dist/entry.js 와 현재의 dist/index.js 사이를 오가며 혼동하지 않도록 정리한 것이다.
문제는 여러 번 업데이트했거나 부분 설치가 남아 있을 때, 레거시 경로를 가리키는 상태가 남아 실제 존재하지 않는 파일을 찾는 데서 발생한다.
해결 순서는 다음과 같다.
- gateway를 완전히 중지
npm uninstall -g openclawnpm cache clean --forcenpm install -g openclaw@latest- launch agent를 다시 로드
로컬 데이터는 ~/.openclaw/ 아래에 있어 npm uninstall로 지워지지 않는다고 안내한다.
다만 cron job을 쓰는 경우는 먼저 백업하라고 권한다. openclaw update가 일부 환경에서 jobs.json 을 삭제하는 별도 버그(#66401)가 있기 때문이다.
결국 자체 호스팅 openclaw는 이런 유지보수 비용이 적지 않다는 경험담으로 마무리된다.
이 한국어 요약은 AI가 자동으로 만들었습니다. 원문의 주장과 맥락은 원문에서 확인해 주세요. 저작권은 원저작자에게 있습니다.
