The open-source app everyone uses to manage agents at work
TypeScript acpxagent-orchestrationagent-skillsagentic-aiai-agentsai-engineeringai-governanceai-toolsautonomous-agentsclaudeclaude-codeclaude-skillscodexhermesllmmcpmulti-agentopenclawproject-managementworkflow-automation
Improve OpenClaw Docker UI smoke pairing ergonomics
Dotta9dbd72cffdc9
diff --git a/doc/DEVELOPING.md b/doc/DEVELOPING.mdindex 5eec30a74c..d7fd049062 100644--- a/doc/DEVELOPING.md+++ b/doc/DEVELOPING.md@@ -284,3 +284,8 @@ pnpm smoke:openclaw-docker-ui```This script lives at `scripts/smoke/openclaw-docker-ui.sh` and automates clone/build/config/start for Compose-based local OpenClaw UI testing.++Pairing behavior for this smoke script:++- default `OPENCLAW_DISABLE_DEVICE_AUTH=1` (no Control UI pairing prompt for local smoke)+- set `OPENCLAW_DISABLE_DEVICE_AUTH=0` to require standard device pairingdiff --git a/docs/guides/openclaw-docker-setup.md b/docs/guides/openclaw-docker-setup.mdindex 4d90991d8b..9a852f32b6 100644--- a/docs/guides/openclaw-docker-setup.md+++ b/docs/guides/openclaw-docker-setup.md@@ -41,6 +41,7 @@ What this command does:- starts `openclaw-gateway` via Compose (with required `/tmp` tmpfs override)- waits for health and prints:- `http://127.0.0.1:18789/#token=...`+- disables Control UI device pairing by default for local smoke ergonomicsEnvironment knobs:@@ -50,6 +51,8 @@ Environment knobs:- `OPENCLAW_GATEWAY_TOKEN` (default random)- `OPENCLAW_BUILD=0` to skip rebuild- `OPENCLAW_OPEN_BROWSER=1` to auto-open the URL on macOS+- `OPENCLAW_DISABLE_DEVICE_AUTH=1` (default) disables Control UI device pairing for local smoke+- `OPENCLAW_DISABLE_DEVICE_AUTH=0` keeps pairing enabled (then approve browser with `devices` CLI commands)### Authenticated modediff --git a/scripts/smoke/openclaw-docker-ui.sh b/scripts/smoke/openclaw-docker-ui.shindex 1845f17606..d29c835d70 100755--- a/scripts/smoke/openclaw-docker-ui.sh+++ b/scripts/smoke/openclaw-docker-ui.sh@@ -34,6 +34,19 @@ 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}"+OPENCLAW_DISABLE_DEVICE_AUTH="${OPENCLAW_DISABLE_DEVICE_AUTH:-1}"++case "$OPENCLAW_DISABLE_DEVICE_AUTH" in+ 1|true|TRUE|True|yes|YES|Yes)+ OPENCLAW_DISABLE_DEVICE_AUTH_JSON="true"+ ;;+ 0|false|FALSE|False|no|NO|No)+ OPENCLAW_DISABLE_DEVICE_AUTH_JSON="false"+ ;;+ *)+ fail "OPENCLAW_DISABLE_DEVICE_AUTH must be one of: 1,0,true,false,yes,no"+ ;;+esacif [[ -z "${OPENAI_API_KEY:-}" && -f "$OPENCLAW_SECRETS_FILE" ]]; thenset +u@@ -75,6 +88,7 @@ cat > "$OPENCLAW_CONFIG_DIR/openclaw.json" <<EOF},"controlUi": {"enabled": true,+ "dangerouslyDisableDeviceAuth": ${OPENCLAW_DISABLE_DEVICE_AUTH_JSON},"allowedOrigins": ["http://127.0.0.1:${OPENCLAW_GATEWAY_PORT}","http://localhost:${OPENCLAW_GATEWAY_PORT}"@@ -153,10 +167,31 @@ 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.+ (Security tradeoff: enable pairing with OPENCLAW_DISABLE_DEVICE_AUTH=0.)++Useful commands:+ docker compose -f "$OPENCLAW_DOCKER_DIR/docker-compose.yml" -f "$COMPOSE_OVERRIDE" logs -f openclaw-gateway+ docker compose -f "$OPENCLAW_DOCKER_DIR/docker-compose.yml" -f "$COMPOSE_OVERRIDE" down+EOF+else+ cat <<EOF+ 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+ docker compose -f "$OPENCLAW_DOCKER_DIR/docker-compose.yml" -f "$COMPOSE_OVERRIDE" run --rm openclaw-cli devices approve --latest+Useful commands:docker compose -f "$OPENCLAW_DOCKER_DIR/docker-compose.yml" -f "$COMPOSE_OVERRIDE" logs -f openclaw-gatewaydocker compose -f "$OPENCLAW_DOCKER_DIR/docker-compose.yml" -f "$COMPOSE_OVERRIDE" downEOF+fiif [[ "$OPENCLAW_OPEN_BROWSER" == "1" ]] && command -v open >/dev/null 2>&1; thenlog "opening dashboard in browser"