From 1809da659ea838909aef832aa3afa27ba0b415fd Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Sat, 4 Apr 2026 07:22:57 +0100
Subject: [PATCH] docs: refresh cli and node pairing references

---
 docs/channels/pairing.md |  2 +-
 docs/cli/gateway.md      | 14 ++++++++++
 docs/cli/index.md        | 60 +++++++++++++++++++++++++++++++++++++++-
 docs/cli/nodes.md        |  4 ++-
 docs/nodes/index.md      |  2 +-
 5 files changed, 78 insertions(+), 4 deletions(-)

diff --git a/docs/channels/pairing.md b/docs/channels/pairing.md
index a40a6b96986..cd6581bffce 100644
--- a/docs/channels/pairing.md
+++ b/docs/channels/pairing.md
@@ -100,7 +100,7 @@ Stored under `~/.openclaw/devices/`:
 
 ### Notes
 
-- The legacy `node.pair.*` API (CLI: `openclaw nodes pending/approve`) is a
+- The legacy `node.pair.*` API (CLI: `openclaw nodes pending|approve|reject|rename`) is a
   separate gateway-owned pairing store. WS nodes still require device pairing.
 
 ## Related docs
diff --git a/docs/cli/gateway.md b/docs/cli/gateway.md
index 52c752e1e74..1b76f71d5cf 100644
--- a/docs/cli/gateway.md
+++ b/docs/cli/gateway.md
@@ -91,6 +91,20 @@ Pass `--token` or `--password` explicitly. Missing explicit credentials is an er
 openclaw gateway health --url ws://127.0.0.1:18789
 ```
 
+### `gateway usage-cost`
+
+Fetch usage-cost summaries from session logs.
+
+```bash
+openclaw gateway usage-cost
+openclaw gateway usage-cost --days 7
+openclaw gateway usage-cost --json
+```
+
+Options:
+
+- `--days <days>`: number of days to include (default `30`).
+
 ### `gateway status`
 
 `gateway status` shows the Gateway service (launchd/systemd/schtasks) plus an optional RPC probe.
diff --git a/docs/cli/index.md b/docs/cli/index.md
index 12523c95ed2..ee120e5dd6e 100644
--- a/docs/cli/index.md
+++ b/docs/cli/index.md
@@ -46,6 +46,7 @@ This page describes the current CLI behavior. If commands change, update this do
 - [`browser`](/cli/browser)
 - [`cron`](/cli/cron)
 - [`tasks`](/cli/index#tasks)
+- [`flows`](/cli/flows)
 - [`dns`](/cli/dns)
 - [`docs`](/cli/docs)
 - [`hooks`](/cli/hooks)
@@ -105,6 +106,7 @@ openclaw [--dev] [--profile <name>] <command>
     set
     unset
     file
+    schema
     validate
   completion
   doctor
@@ -122,6 +124,8 @@ openclaw [--dev] [--profile <name>] <command>
   reset
   uninstall
   update
+    wizard
+    status
   channels
     list
     status
@@ -133,6 +137,9 @@ openclaw [--dev] [--profile <name>] <command>
     login
     logout
   directory
+    self
+    peers list
+    groups list|members
   skills
     search
     install
@@ -157,6 +164,28 @@ openclaw [--dev] [--profile <name>] <command>
   message
     send
     broadcast
+    poll
+    react
+    reactions
+    read
+    edit
+    delete
+    pin
+    unpin
+    pins
+    permissions
+    search
+    thread create|list|reply
+    emoji list|upload
+    sticker send|upload
+    role info|add|remove
+    channel info|list
+    member info
+    voice status
+    event list|create
+    timeout
+    kick
+    ban
   agent
   agents
     list
@@ -168,18 +197,26 @@ openclaw [--dev] [--profile <name>] <command>
     set-identity
   acp
   mcp
+    serve
+    list
+    show
+    set
+    unset
   status
   health
   sessions
     cleanup
   tasks
     list
+    audit
+    maintenance
     show
     notify
     cancel
     flow list|show|cancel
   gateway
     call
+    usage-cost
     health
     status
     probe
@@ -228,13 +265,34 @@ openclaw [--dev] [--profile <name>] <command>
     runs
     run
   nodes
+    status
+    describe
+    list
+    pending
+    approve
+    reject
+    rename
+    invoke
+    notify
+    push
+    canvas snapshot|present|hide|navigate|eval
+    canvas a2ui push|reset
+    camera list|snap|clip
+    screen record
+    location get
   devices
+    list
+    remove
+    clear
+    approve
+    reject
+    rotate
+    revoke
   node
     run
     status
     install
     uninstall
-    start
     stop
     restart
   approvals
diff --git a/docs/cli/nodes.md b/docs/cli/nodes.md
index 84a581a56bf..796b0a297c5 100644
--- a/docs/cli/nodes.md
+++ b/docs/cli/nodes.md
@@ -1,5 +1,5 @@
 ---
-summary: "CLI reference for `openclaw nodes` (list/status/approve/invoke, camera/canvas/screen)"
+summary: "CLI reference for `openclaw nodes` (status, pairing, invoke, camera/canvas/screen)"
 read_when:
   - You’re managing paired nodes (cameras, screen, canvas)
   - You need to approve requests or invoke node commands
@@ -28,6 +28,8 @@ openclaw nodes list --connected
 openclaw nodes list --last-connected 24h
 openclaw nodes pending
 openclaw nodes approve <requestId>
+openclaw nodes reject <requestId>
+openclaw nodes rename --node <id|name|ip> --name <displayName>
 openclaw nodes status
 openclaw nodes status --connected
 openclaw nodes status --last-connected 24h
diff --git a/docs/nodes/index.md b/docs/nodes/index.md
index c2d1e5c13dd..07001967680 100644
--- a/docs/nodes/index.md
+++ b/docs/nodes/index.md
@@ -43,7 +43,7 @@ pending request is superseded and a new `requestId` is created. Re-run
 Notes:
 
 - `nodes status` marks a node as **paired** when its device pairing role includes `node`.
-- `node.pair.*` (CLI: `openclaw nodes pending/approve/reject`) is a separate gateway-owned
+- `node.pair.*` (CLI: `openclaw nodes pending/approve/reject/rename`) is a separate gateway-owned
   node pairing store; it does **not** gate the WS `connect` handshake.
 
 ## Remote node host (system.run)