From 6f98c5f25ca01e9efd8f9a67086f1b814bde2d28 Mon Sep 17 00:00:00 2001
From: Dotta <bippadotta@protonmail.com>
Date: Thu, 5 Mar 2026 11:14:30 -0600
Subject: [PATCH] Clarify zero-flag OpenClaw Docker UI smoke defaults

---
 doc/DEVELOPING.md                    | 2 +-
 docs/guides/openclaw-docker-setup.md | 2 ++
 scripts/smoke/openclaw-docker-ui.sh  | 9 +++++----
 3 files changed, 8 insertions(+), 5 deletions(-)

diff --git a/doc/DEVELOPING.md b/doc/DEVELOPING.md
index d7fd0490..c2f39a56 100644
--- a/doc/DEVELOPING.md
+++ b/doc/DEVELOPING.md
@@ -287,5 +287,5 @@ This script lives at `scripts/smoke/openclaw-docker-ui.sh` and automates clone/b
 
 Pairing behavior for this smoke script:
 
-- default `OPENCLAW_DISABLE_DEVICE_AUTH=1` (no Control UI pairing prompt for local smoke)
+- default `OPENCLAW_DISABLE_DEVICE_AUTH=1` (no Control UI pairing prompt for local smoke; no extra pairing env vars required)
 - set `OPENCLAW_DISABLE_DEVICE_AUTH=0` to require standard device pairing
diff --git a/docs/guides/openclaw-docker-setup.md b/docs/guides/openclaw-docker-setup.md
index 9a852f32..8aa2ad82 100644
--- a/docs/guides/openclaw-docker-setup.md
+++ b/docs/guides/openclaw-docker-setup.md
@@ -33,6 +33,8 @@ To spin up OpenClaw in Docker and print a host-browser dashboard URL in one comm
 pnpm smoke:openclaw-docker-ui
 ```
 
+Default behavior is zero-flag: you can run the command as-is with no pairing-related env vars.
+
 What this command does:
 
 - clones/updates `openclaw/openclaw` in `/tmp/openclaw-docker`
diff --git a/scripts/smoke/openclaw-docker-ui.sh b/scripts/smoke/openclaw-docker-ui.sh
index d29c835d..8b2c3b95 100755
--- a/scripts/smoke/openclaw-docker-ui.sh
+++ b/scripts/smoke/openclaw-docker-ui.sh
@@ -34,6 +34,7 @@ OPENCLAW_BUILD="${OPENCLAW_BUILD:-1}"
 OPENCLAW_WAIT_SECONDS="${OPENCLAW_WAIT_SECONDS:-45}"
 OPENCLAW_OPEN_BROWSER="${OPENCLAW_OPEN_BROWSER:-0}"
 OPENCLAW_SECRETS_FILE="${OPENCLAW_SECRETS_FILE:-$HOME/.secrets}"
+# Keep default one-command UX: local smoke run should not require manual pairing.
 OPENCLAW_DISABLE_DEVICE_AUTH="${OPENCLAW_DISABLE_DEVICE_AUTH:-1}"
 
 case "$OPENCLAW_DISABLE_DEVICE_AUTH" in
@@ -166,14 +167,13 @@ OpenClaw gateway is running.
 
 Dashboard URL:
 $dashboard_url
-
-Pairing mode:
-  OPENCLAW_DISABLE_DEVICE_AUTH=$OPENCLAW_DISABLE_DEVICE_AUTH
 EOF
 
 if [[ "$OPENCLAW_DISABLE_DEVICE_AUTH_JSON" == "true" ]]; then
   cat <<EOF
-  Device pairing is disabled for this local smoke run.
+Pairing:
+  Device pairing is disabled by default for this local smoke run.
+  No extra env vars are required for the default path.
   (Security tradeoff: enable pairing with OPENCLAW_DISABLE_DEVICE_AUTH=0.)
 
 Useful commands:
@@ -182,6 +182,7 @@ Useful commands:
 EOF
 else
   cat <<EOF
+Pairing:
   Device pairing is enabled.
   If UI shows "pairing required", run:
     docker compose -f "$OPENCLAW_DOCKER_DIR/docker-compose.yml" -f "$COMPOSE_OVERRIDE" run --rm openclaw-cli devices list