solution web-ui medium macos linux windows

Control UI assets missing

Fix 'Control UI assets not found' by building UI assets (pnpm ui:build) or running openclaw doctor UI repair when sources are present.

By CoClaw Team •

Symptoms

  • Logs say “Control UI assets not found”.
  • The UI doesn’t load, or certain UI pages 404.

Cause

The gateway can run without UI assets, but the web UI needs a built dist/control-ui/ bundle. In slim/docker-like environments, UI source files may not even be present, so auto-building is skipped.

Fix

openclaw doctor

If it offers to build UI assets, accept.

Option B: Build UI assets manually (source checkout)

From the OpenClaw repo root:

pnpm ui:build

Then restart the gateway (or rerun onboarding if you’re in the wizard flow).

Verify

  • Re-open the dashboard/control UI and confirm pages load.
  • openclaw status --deep succeeds.

Verification & references

  • Reviewed by:CoClaw Code Team
  • Last reviewed:March 14, 2026
  • Verified on: macOS · Linux · Windows

References

Official docs

  1. OpenClaw docs: /start/wizard
Want to explore more? Browse all solutions or ask in the Community Forum .
Report a problem

Related Resources

Control UI: dashboard root returns plain-text 'Not Found' after upgrade (pnpm global install)
Fix
Fix cases where the gateway starts normally after an upgrade, but `/` returns plain-text `Not Found` until Control UI assets are copied out of the pnpm global package tree and `gateway.controlUi.root` points at that local copy.
Control UI shows 'unauthorized' / keeps reconnecting
Fix
Fix OpenClaw dashboard/control UI auth errors (unauthorized, 1008, reconnect loop) by aligning gateway token/password and reachability.
Control UI: disconnected (1008): pairing required
Fix
Fix Control UI disconnects caused by device pairing. Approve the browser/device once, then reconnect (common on remote hosts and Docker).
Control UI error: missing scope: operator.read (LAN/IP access)
Fix
Work around a regression where the Control UI works on localhost but fails via LAN/IP with 'missing scope: operator.read'.
OpenClaw Pairing Explained: The Trust Model Behind Control UI
Guide
Understand what Control UI pairing actually proves, why local and remote access behave differently, where users confuse pairing with auth, and how to troubleshoot trust failures without guessing.
OpenClaw Control UI Auth & Pairing: Fix 'unauthorized', 1008, and Remote Dashboard Access
Guide
Restore stable Control UI access by separating gateway auth from device pairing, fixing unauthorized and 1008 loops, and verifying that your remote path stays stable.