ClawKit Logo
ClawKitReliability Toolkit

How to Fix Control UI assets not found in OpenClaw

TL;DR โ€” Quick Fix

The npm v2026.3.22 package is missing production assets; manually overwrite your local directory with the official UI tarball.

Run Diagnostics

Next Step

Fix now, then reduce repeat incidents

If this issue keeps coming back, validate your setup in Doctor first, then harden your config.

Error Signal

Control UI assets not found. Build them with pnpm ui:build

What's Happening

You're trying to launch the dashboard and hitting: "Control UI assets not found. Build them with pnpm ui:build". This is occurring specifically on version 2026.3.22. It happens because the published npm package failed to bundle the necessary UI source files and the final dist/bundled/ui artifacts.

The Fix

You need to inject the missing assets manually. Download the official patch from the OpenClaw repo, extract it, and overwrite your local install directory.

  1. Download the control-ui.tar.gz file from the GitHub issue thread.
  2. Locate your global npm installation folder. You can find this path by running npm root -g in your terminal.
  3. Navigate to the openclaw/dist/control-ui folder inside that path.
  4. Extract the contents of control-ui.tar.gz directly into this directory, overwriting existing files if prompted.
  5. Restart the dashboard using openclaw dashboard.

Why This Occurs

The build pipeline for v2026.3.22 failed to include the ui/ directory and the generated bundle in the final tarball uploaded to npm. While your package.json specifies pnpm ui:build in the prepack phase, the files simply didn't make it into the artifact. You cannot "build" them yourself easily because the source code required for the build process is also missing from the installed package.

Prevention

The development team is aware of this packaging error and is tracking it as a high-priority fix. Updates will be pushed to the registry shortly. If you are reading this after the release of a newer patch version, run npm install -g openclaw@latest to get the corrected package. Avoid building manually from source if you are not an OpenClaw contributor, as you risk version mismatches between the core engine and your manually compiled frontend.


Last Updated: March 2026

Did this guide solve your problem?