Как проявляется
При запуске OpenClaw глобально через npm появляется сообщение «Missing Control UI assets. Build them with pnpm ui:build», хотя ассеты есть в пакете.
Из-за чего возникает
Функция resolveControlUiDistIndexPath() проверяет путь process.argv[1], ожидая, что он находится в папке dist/, но при глобальной установке путь указывает на корень пакета, из-за чего поиск ассетов не удаётся. Фолбэк тоже не работает, так как в npm-пакете отсутствуют исходные файлы для сборки UI.
Как исправить
-
Убедитесь, что используете версию OpenClaw с исправлением, которое добавляет проверку ассетов относительно корня пакета (например, коммит https://github.com/LeenixP-Copilot/openclaw/commit/b3c7ec908a12ccab697c5935e172e1a3c0a11213).
-
Если исправления нет, временно можно собрать UI вручную, но в npm-пакете скрипты сборки отсутствуют, поэтому это не всегда возможно.
-
Альтернативно, если вы разрабатываете или используете локальную копию, выполните:
cd ui
pnpm install
pnpm build- Следите за обновлениями OpenClaw, где эта проблема будет устранена официально.
Как не столкнуться снова
Используйте версии OpenClaw с исправлением поиска UI-ассетов или запускайте OpenClaw не через глобальную установку npm, если требуется доступ к UI без ошибок.
Источник
Разбор основан на обсуждении в репозитории проекта: issue #4855.
Другие типичные проблемы — в разделе ошибок и решений, а базовая настройка разобрана в первом запуске.