@@ -22,6 +22,8 @@ Blacksmith fallback playbook.
2222command -v crabbox
2323../crabbox/bin/crabbox --version
2424pnpm crabbox:run -- --help | sed -n '1,120p'
25+../crabbox/bin/crabbox desktop launch --help
26+../crabbox/bin/crabbox webvnc --help
2527```
26282729- OpenClaw scripts prefer `../crabbox/bin/crabbox` when present. The user PATH
@@ -139,6 +141,35 @@ pnpm crabbox:stop -- <id-or-slug>
139141blacksmith testbox stop --id <tbx_id>
140142```
141143144+## Interactive Desktop And WebVNC
145+146+Prefer WebVNC for human inspection because the browser portal can preload the
147+lease VNC password and avoids a native VNC client's copy/paste/password dance.
148+Use native `crabbox vnc` only when WebVNC is unavailable, the browser portal is
149+broken, or the user explicitly wants a local VNC client.
150+151+Common desktop flow:
152+153+```sh
154+../crabbox/bin/crabbox warmup --provider hetzner --desktop --browser --class standard --idle-timeout 60m --ttl 240m
155+../crabbox/bin/crabbox desktop launch --provider hetzner --id <cbx_id-or-slug> --browser --url https://example.com --webvnc --open
156+```
157+158+Useful WebVNC commands:
159+160+```sh
161+../crabbox/bin/crabbox webvnc --provider hetzner --id <cbx_id-or-slug> --open
162+../crabbox/bin/crabbox webvnc --provider hetzner --id <cbx_id-or-slug> --daemon --open
163+../crabbox/bin/crabbox webvnc --provider hetzner --id <cbx_id-or-slug> --status
164+../crabbox/bin/crabbox webvnc --provider hetzner --id <cbx_id-or-slug> --stop
165+../crabbox/bin/crabbox screenshot --provider hetzner --id <cbx_id-or-slug> --output desktop.png
166+```
167+168+`desktop launch --webvnc --open` is usually the nicest one-shot: it starts the
169+browser/app inside the visible session, bridges the lease into the authenticated
170+WebVNC portal, and opens the portal. Keep browsers windowed for human QA; use
171+`--fullscreen` only for capture/video workflows.
172+142173## If Crabbox Fails
143174144175Keep the fallback narrow. First decide whether the failure is Crabbox itself,
@@ -268,11 +299,11 @@ when Blacksmith proof is requested; pass `--provider blacksmith-testbox`.
268299269300### Interactive Desktop / WebVNC
270301271-For human WebVNC demos, keep the remote desktop visible and windowed. Do not
272-fullscreen the remote browser or hide the XFCE panel/window chrome unless the
273-explicit goal is video/capture output. After launch, verify a screenshot shows
274-the desktop panel plus browser title bar. If Chrome is fullscreen, toggle it
275-back with:
302+For human desktop demos, prefer `webvnc` over native `vnc` and keep the remote
303+desktop visible/windowed. Do not fullscreen the remote browser or hide the XFCE
304+panel/window chrome unless the explicit goal is video/capture output. After
305+launch, verify a screenshot shows the desktop panel plus browser title bar. If
306+Chrome is fullscreen, toggle it back with:
276307277308```sh
278309crabbox run --id <lease> --shell -- 'DISPLAY=:99 xdotool search --onlyvisible --class google-chrome windowactivate key F11'
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。