OpenClaw “Control UI assets not found” 오류 — 재설치 말고 pnpm ui:build 해야 한다

OpenClaw 대시보드를 열었더니 “Control UI assets not found” 오류만 떴다. 공식 재설치를 여러 번 해도 똑같았다. 원인은 패키지 배포 버그였고, 해결은 직접 빌드하는 것뿐이었다.

사건의 시작은 황당했다

에이전트한테 “바탕화면에 열린 다른 창 닫아라”고 했다. 에이전트가 macOS 단축키 ⌘W를 실행했는데, 그 순간 활성 상태였던 창이 OpenClaw 채팅창이었다. 채팅창이 그대로 닫혀버렸다.

⌘W는 현재 포커스된 창을 닫는 단축키다. 에이전트가 어떤 창이 활성 상태인지 구분 못 한 게 원인이었다.

이후 브라우저에서 http://127.0.0.1:18789 를 다시 열었더니 이 화면만 떴다.

Control UI assets not found. Build them with `pnpm ui:build`
(auto-installs UI deps), or run `pnpm ui:dev` during development.

터미널 로그에도 이렇게 찍혔다.

[gateway] Missing Control UI assets at
/opt/homebrew/lib/node_modules/openclaw/dist/control-ui/index.html.

gateway 자체는 살아 있었다. 문제는 브라우저 화면을 그리는 정적 파일(index.html 등)이 아예 없다는 것이었다.

원인은 Homebrew/npm 패키지 배포 과정의 버그다. 공식 설치 스크립트로 재설치해도 이 파일은 복구되지 않는다. 직접 빌드해서 넣어줘야 한다.

ls -la /opt/homebrew/bin/openclaw

/opt/homebrew/lib/node_modules/openclaw/ 경로가 나오면 정상이다.

git clone https://github.com/openclaw/openclaw.git ~/openclaw-src
cd ~/openclaw-src
pnpm install
pnpm ui:build

아래 메시지가 나오면 빌드 성공이다.

✓ built in 561ms

주의: pnpm ui:build 는 반드시 클론한 디렉토리(~/openclaw-src) 안에서 실행해야 한다. 홈 디렉토리나 .openclaw 폴더에서 실행하면 ERR_PNPM_NO_IMPORTER_MANIFEST_FOUND 에러가 난다.

cp -r ~/openclaw-src/dist/control-ui /opt/homebrew/lib/node_modules/openclaw/dist/

새 터미널 탭에서 실행한다.

openclaw gateway --force

브라우저에서 새로고침하면 대시보드가 정상으로 돌아온다.

[이미지 삽입: 정상 복구된 OpenClaw 대시보드 화면]

OpenClaw를 업데이트하면 같은 증상이 재발할 수 있다. 업데이트할 때마다 2~4단계를 반복하면 된다.

이건 사용자 실수가 아니다. 패키지 배포 버그다.

같은 오류를 만났다면 재설치 시도는 그만하고 바로 이 순서로 가자.

재설치로 안 된다면 빌드가 답이다.

복구하고 다시 재회한 화면

오늘도 자비스는 진보한다.