#23798: docs: add Docker pairing cross-reference to Control UI page
docs
size: XS
Cluster:
Docker and Deployment Improvements
## Summary
- Problem: Docker users following the Control UI device pairing instructions (`docs/web/control-ui.md`) encounter `openclaw: command not found` because the container doesn't install `openclaw` globally. The docs also state local connections are auto-approved, but Docker bridge networking prevents this.
- Why it matters: Docker users hit a dead end on the Control UI page with no guidance on how to proceed.
- What changed: Added a one-line cross-reference in the device pairing notes pointing to the existing Docker pairing workflow in `docs/install/docker.md`.
- What did NOT change (scope boundary): No commands duplicated, no new sections, no code changes.
## Change Type (select all)
- [x] Docs
## Scope (select all touched areas)
- [x] UI / DX
## Linked Issue/PR
- N/A
## User-visible / Behavior Changes
None — docs-only cross-reference.
## Security Impact (required)
- New permissions/capabilities? No
- Secrets/tokens handling changed? No
- New/changed network calls? No
- Command/tool execution surface changed? No
- Data access scope changed? No
## Repro + Verification
### Environment
- OS: macOS (Docker Desktop)
- Runtime/container: Docker Compose with `openclaw:local` image
### Steps
1. Run OpenClaw via Docker (`./docker-setup.sh`)
2. Open `http://127.0.0.1:18789/` and enter gateway token
3. See "disconnected (1008): pairing required"
4. Try `openclaw devices list` → `command not found`
5. Navigate to `docs/web/control-ui.md` — no Docker-specific guidance
### Expected
- The Control UI docs point Docker users to the correct workflow
### Actual
- Only bare `openclaw` CLI commands shown; no mention of Docker alternative
## Evidence
- [x] Human Verification (see below)
## Human Verification (required)
- Verified scenarios: Followed the Docker setup flow end-to-end, confirmed pairing fails with bare `openclaw`, confirmed `docker compose run --rm openclaw-cli devices approve` works
- Edge cases checked: Verified anchor link matches the heading in `docs/install/docker.md`
- What you did **not** verify: Mintlify rendering (no local Mintlify dev server)
## Compatibility / Migration
- Backward compatible? Yes
- Config/env changes? No
- Migration needed? No
## Failure Recovery (if this breaks)
- Revert the single line added to `docs/web/control-ui.md`
- No config or code impact
## Risks and Mitigations
None
<!-- greptile_comment -->
<h3>Greptile Summary</h3>
Added a cross-reference in the Control UI device pairing notes pointing Docker users to the container-specific pairing workflow documented in `docs/install/docker.md`.
- Solves a documentation gap where Docker users following the Control UI pairing instructions would encounter `openclaw: command not found` errors
- Single-line addition that maintains consistency with existing note structure in the file
- Anchor link correctly references the existing "Control UI token + pairing (Docker)" section at docs/install/docker.md:102
<h3>Confidence Score: 5/5</h3>
- This PR is safe to merge with no risk
- Single-line documentation change that adds a helpful cross-reference. The anchor link is verified to exist and follows Mintlify conventions. No code changes, no behavior changes, and the addition is scoped precisely to the relevant context.
- No files require special attention
<sub>Last reviewed commit: 92c72b2</sub>
<!-- greptile_other_comments_section -->
<sub>(3/5) Reply to the agent's comments like "Can you suggest a fix for this @greptileai?" or ask follow-up questions!</sub>
<!-- /greptile_comment -->
Most Similar PRs
#11915: Docs: Docker + reverse proxy deployment notes and pairing pitfalls
by walshd1 · 2026-02-08
83.2%
#23578: docs(docker): clarify dashboard HTTP access and allowInsecureAuth
by NewdlDewdl · 2026-02-22
81.9%
#9999: Docker: fix token mismatch and add dev setup workflow
by benclarkeio · 2026-02-06
81.1%
#21934: fix #21914 - Add the most obvious option to the error message
by vivganes · 2026-02-20
80.1%
#17151: fix: add npm link to fix CLI permission denied (exit 127)
by sskyu · 2026-02-15
79.3%
#17506: Fix Entrypoint in docker-compose
by NeilSCGH · 2026-02-15
79.2%
#3744: Gateway: fix device pairing when local connection retries with exis...
by photon3710 · 2026-01-29
78.8%
#6698: feat: Add CLI wrapper for Docker integration and update documentation
by barshopen · 2026-02-01
78.1%
#23678: fix(ui): Control UI shows no guidance on 1008 pairing required (#23...
by yinghaosang · 2026-02-22
77.4%
#19851: docs: 新增 OpenClaw Docker 与 Discord 安装调试手册
by JiepengTan · 2026-02-18
77.2%