let5see/clawdbot
1
0
Fork 0
Code Issues Pull Requests Actions 4 Packages Projects Releases Wiki Activity

docs: add dashboard faq

Browse Source
This commit is contained in:
Peter Steinberger
2026-01-12 19:14:00 +00:00
parent 55aeb8a0d3
commit 74806aa5e3
2 changed files with 14 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
docs/start/faq.md
View File

@@ -764,6 +764,8 @@ Facts (from code):
- The UI can import `?token=...` (and/or `?password=...`) once, then strips it from the URL. - The UI can import `?token=...` (and/or `?password=...`) once, then strips it from the URL.
Fix: Fix:
- Fastest: `clawdbot dashboard` (prints + copies tokenized link, tries to open; shows SSH hint if headless).
- If remote, tunnel first: `ssh -N -L 18789:127.0.0.1:18789 user@host` then open `http://127.0.0.1:18789/?token=...`.
- Set `gateway.auth.token` (or `CLAWDBOT_GATEWAY_TOKEN`) on the gateway host. - Set `gateway.auth.token` (or `CLAWDBOT_GATEWAY_TOKEN`) on the gateway host.
- In the Control UI settings, paste the same token (or refresh with a one-time `?token=...` link). - In the Control UI settings, paste the same token (or refresh with a one-time `?token=...` link).

12
docs/web/dashboard.md
View File

@@ -18,3 +18,15 @@ Key references:
Authentication is enforced at the WebSocket handshake via `connect.params.auth` Authentication is enforced at the WebSocket handshake via `connect.params.auth`
(token or password). See `gateway.auth` in [Gateway configuration](/gateway/configuration). (token or password). See `gateway.auth` in [Gateway configuration](/gateway/configuration).
## Fast path (recommended)
- After onboarding, the CLI now auto-opens the dashboard with your token and prints the same tokenized link.
- Re-open anytime: `clawdbot dashboard` (copies link, opens browser if possible, shows SSH hint if headless).
- The token stays local (query param only); the UI strips it after first load and saves it in localStorage.
## If you see “unauthorized” / 1008
- Run `clawdbot dashboard` to get a fresh tokenized link.
- Ensure the gateway is reachable (local: `clawdbot status`; remote: SSH tunnel `ssh -N -L 18789:127.0.0.1:18789 user@host` then open `http://127.0.0.1:18789/?token=...`).
- In the dashboard settings, paste the same token you configured in `gateway.auth.token` (or `CLAWDBOT_GATEWAY_TOKEN`).