agent-tab-title#

Local OpenClaw Control UI patch: rewrites document.title to <agent name> · OpenClaw.

Mirrors PR openclaw/openclaw#80944 as an out-of-tree patch that edits the bundled Control UI index.html shipped inside the locally installed openclaw npm package. Survives gateway restarts; does not survive openclaw update (re-run apply after upgrades).

When to use#

• User wants per-agent browser tab titles for OpenClaw Control UI.
• User has multiple Control UI tabs open across agents and can't tell them apart.
• User wants to apply / remove / re-apply this patch.
• User just ran openclaw update and the tab title went back to OpenClaw Control.

How it works#

The Control UI is a static SPA shipped inside the npm package at:

text

<npm-global>/openclaw/dist/control-ui/index.html

Gateway serves it as a static file. The patch injects a ~25-line <script> block right before </body> that:

1. Polls <openclaw-app> Lit element every 200 ms.
2. Reads assistantName (preferred) or assistantAgentId (fallback) properties.
3. Sets document.title to <name> · OpenClaw (U+00B7 middle dot), or OpenClaw Control if no agent.

No build, no dependencies, no gateway restart — just refresh the browser tab.

Apply / remove#

bash

# Apply (idempotent — safe to re-run after openclaw update)
bash scripts/apply.sh

# Remove (restores original index.html via .bak)
bash scripts/apply.sh --uninstall

# Custom Control UI path (auto-detect usually works)
bash scripts/apply.sh --target /path/to/openclaw/dist/control-ui/index.html

apply.sh auto-detects the Control UI index.html by probing, in order:

1. OPENCLAW_CONTROL_UI_INDEX env var
2. --target <path> flag
3. $(npm root -g)/openclaw/dist/control-ui/index.html
4. Common nvm path ~/.nvm/versions/node/*/lib/node_modules/openclaw/dist/control-ui/index.html

On apply:

• Creates index.html.bak once (never overwrites an existing backup; that backup is the rollback point).
• Skips re-injection if the patch marker openclaw-tab-title local patch is already present.

After openclaw update#

npm update overwrites the whole dist/ tree, including any prior backup. Re-run bash scripts/apply.sh — it will create a fresh backup off the new pristine file and inject the patch.

Verify#

1. Reload Control UI in browser (no gateway restart needed).
2. Switch between agents (Milly / Sherry / etc.) — tab title should update live to <agent> · OpenClaw.
3. With no agent selected, title falls back to OpenClaw Control.

If title doesn't change, check Service Worker cache: DevTools → Application → Service Workers → Unregister → reload.