From 154be28eea6383ec467fa25f78eea5cd6f9762ed Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
<161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Thu, 12 Feb 2026 05:53:51 +0000
Subject: [PATCH] docs: update device approval instructions to use Request ID
- Update `get-runclawd.sh` to instruct users to approve using the Request ID (UUID) instead of the device hash.
- Add a "Device Approval" section to `README.md` with CLI examples showing the Request ID column.
- Add a dedicated "Device Approval" card to `index.html` in the hero section, explaining the approval steps.
- Ensure consistency in terminology ("Request ID") across all documentation.
- The `index.html` changes are built on top of the latest `main` branch which enforces a dark theme and new typography.
Co-authored-by: brucx <1300652+brucx@users.noreply.github.com>
---
.github/workflows/docker-build-push.yml | 8 +
README.md | 33 ++++
get-runclawd.sh | 4 +-
index.html | 218 ++++++++++++------------
4 files changed, 153 insertions(+), 110 deletions(-)
diff --git a/.github/workflows/docker-build-push.yml b/.github/workflows/docker-build-push.yml
index 4e0c5ee..1872ce8 100644
--- a/.github/workflows/docker-build-push.yml
+++ b/.github/workflows/docker-build-push.yml
@@ -32,6 +32,14 @@ jobs:
- name: Checkout
uses: actions/checkout@v4
+ - name: Free Disk Space
+ run: |
+ sudo rm -rf /usr/share/dotnet
+ sudo rm -rf /usr/local/lib/android
+ sudo rm -rf /opt/ghc
+ sudo rm -rf /opt/hostedtoolcache/CodeQL
+ sudo docker image prune --all --force
+
- name: Set up QEMU
uses: docker/setup-qemu-action@v3
diff --git a/README.md b/README.md
index 0bf6aa7..7f18a63 100644
--- a/README.md
+++ b/README.md
@@ -62,6 +62,39 @@
The gateway token is generated on first boot and stored in `/data/.openclaw/openclaw.json` inside the `runclawd` container (generated by `scripts/bootstrap.sh`).
+ ## Device approval
+
+ OpenClaw requires devices to be approved before they can access the gateway. The installer provides a link to do this, but you can also do it manually via the CLI or web terminal.
+
+ 1. **List devices** to find the pending **Request ID** (UUID):
+
+ ```bash
+ openclaw devices list
+ ```
+
+ Output example:
+
+ ```text
+ Pending (1)
+ ┌──────────────────────────────────────┬───────────────────────────────────...
+ │ Request │ Device ...
+ ├──────────────────────────────────────┼───────────────────────────────────...
+ │ 62cd8691-b244-4e34-90e1-62b5530ef268 │ 0b874c0cb5c7ea23541cccd1034fc930a1...
+ └──────────────────────────────────────┴───────────────────────────────────...
+ ```
+
+ 2. **Approve the device** using the Request ID from the first column:
+
+ ```bash
+ openclaw devices approve 62cd8691-b244-4e34-90e1-62b5530ef268
+ ```
+
+ Output example:
+
+ ```text
+ Approved 0b874c0cb5c7ea23541cccd1034fc930a1dff0895fc42eedb1ab454060a7cff9
+ ```
+
## Configure API keys (.env)
This compose preset reads API keys from environment variables (see `docker-compose.yaml`, e.g. `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `GEMINI_API_KEY`, etc.).
diff --git a/get-runclawd.sh b/get-runclawd.sh
index 0b4fb6e..eabdaf2 100644
--- a/get-runclawd.sh
+++ b/get-runclawd.sh
@@ -231,9 +231,9 @@ print_result() {
${tunnel_url}/openclaw/?arg=devices&arg=list
Approve a device:
- ${tunnel_url}/openclaw/?arg=devices&arg=approve&arg={device_id}
+ ${tunnel_url}/openclaw/?arg=devices&arg=approve&arg={request_id}
- Tip: open the "List devices" link, copy the returned device_id, then replace "{device_id}" in the approve link.
+ Tip: open the "List devices" link, find the pending request (UUID), copy its ID, then replace "{request_id}" in the approve link.
Notes:
- If the URL is not reachable right away, wait a few minutes for DNS/route propagation and try again.
diff --git a/index.html b/index.html
index 4927ae4..f0f5fed 100644
--- a/index.html
+++ b/index.html
@@ -3,39 +3,27 @@
-
+
RunClawd — OpenClaw deployment preset
+