Files
openclaw/docs/cli/dashboard.md
praveen9354 0677a4f8b3 fix(dashboard): guide manual token auth fallback
Summary:
- Add a redaction-safe dashboard fallback hint when tokenized URL delivery fails.
- Document the manual auth path and update the changelog.

Verification:
- PR CI exact head 48ccb97c08 green for relevant CI/security checks.
- pnpm test src/commands/dashboard.links.test.ts src/commands/dashboard.test.ts
- pnpm exec oxfmt --check --threads=1 src/commands/dashboard.ts src/commands/dashboard.links.test.ts
- pnpm format:docs:check
- pnpm docs:check-mdx
- pnpm docs:check-i18n-glossary
- targeted markdownlint for docs/cli/dashboard.md and docs/web/dashboard.md
2026-05-04 18:39:25 -05:00

1.3 KiB

summary, read_when, title
summary read_when title
CLI reference for `openclaw dashboard` (open the Control UI)
You want to open the Control UI with your current token
You want to print the URL without launching a browser
Dashboard

openclaw dashboard

Open the Control UI using your current auth.

openclaw dashboard
openclaw dashboard --no-open

Notes:

  • dashboard resolves configured gateway.auth.token SecretRefs when possible.
  • dashboard follows gateway.tls.enabled: TLS-enabled gateways print/open https:// Control UI URLs and connect over wss://.
  • If clipboard/browser delivery fails for a token-authenticated dashboard URL, dashboard logs a safe manual-auth hint naming OPENCLAW_GATEWAY_TOKEN, gateway.auth.token, and fragment key token without printing the token value.
  • For SecretRef-managed tokens (resolved or unresolved), dashboard prints/copies/opens a non-tokenized URL to avoid exposing external secrets in terminal output, clipboard history, or browser-launch arguments.
  • If gateway.auth.token is SecretRef-managed but unresolved in this command path, the command prints a non-tokenized URL and explicit remediation guidance instead of embedding an invalid token placeholder.