Help

[versed creek]

I want to make some edits to the ui from the source how do i go about this. Do I tell the openclaw to do it or do i use a outside ai like codex? Where is the ui located in the source, and after i make the edits to i need to pnpm build?, how does that work.

[potent sandal]

To help others find answers, you can mark your question as solved via Right click solution message -> Apps -> ✅ Mark Solution

[sleek hornet]

For Control UI edits, use the source checkout directly. You can ask OpenClaw to help if it has access to that checkout, or use an outside coding agent like Codex/Claude Code. For UI work, an agent that can read files and run pnpm in the repo is usually the smoothest path.

Current source layout:

• Control UI app: ui/
• Main entry: ui/src/main.ts
• Lit UI modules: ui/src/ui/
• Styling: ui/src/styles.css and ui/src/styles/
• English strings: ui/src/i18n/locales/en.ts
• Built output served by the gateway: dist/control-ui/

Typical dev loop from the repo root:

pnpm install
pnpm ui:dev

[sleek hornet]

That starts the Vite dev server on port 5173 for fast UI iteration. For the real gateway-served dashboard, rebuild the UI assets:

pnpm ui:build

If you changed backend/gateway TypeScript too, run the full build:

pnpm build
pnpm ui:build

Then restart the gateway so it serves the rebuilt dist/control-ui.

A good agent prompt is something like: “In this OpenClaw checkout, modify the Control UI under ui/. Keep changes scoped, run pnpm ui:build, and tell me what files changed.”