From 069c495df630b49ad8e690da7b2ab3c6c6874706 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Wed, 25 Feb 2026 02:50:14 +0000
Subject: [PATCH] docs: clarify pairing commands in faq and troubleshooting

---
 docs/gateway/troubleshooting.md | 6 +++---
 docs/help/faq.md                | 4 ++--
 docs/help/troubleshooting.md    | 2 +-
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/gateway/troubleshooting.md b/docs/gateway/troubleshooting.md
index 69bf0c450d7..23483076102 100644
--- a/docs/gateway/troubleshooting.md
+++ b/docs/gateway/troubleshooting.md
@@ -36,7 +36,7 @@ If channels are up but nothing answers, check routing and policy before reconnec
 ```bash
 openclaw status
 openclaw channels status --probe
-openclaw pairing list <channel>
+openclaw pairing list --channel <channel> [--account <id>]
 openclaw config get channels
 openclaw logs --follow
 ```
@@ -125,7 +125,7 @@ If channel state is connected but message flow is dead, focus on policy, permiss
 
 ```bash
 openclaw channels status --probe
-openclaw pairing list <channel>
+openclaw pairing list --channel <channel> [--account <id>]
 openclaw status --deep
 openclaw logs --follow
 openclaw config get channels
@@ -290,7 +290,7 @@ Common signatures:
 
 ```bash
 openclaw devices list
-openclaw pairing list <channel>
+openclaw pairing list --channel <channel> [--account <id>]
 openclaw logs --follow
 openclaw doctor
 ```
diff --git a/docs/help/faq.md b/docs/help/faq.md
index 4cf1c7447ed..a16dba1a7dc 100644
--- a/docs/help/faq.md
+++ b/docs/help/faq.md
@@ -2705,8 +2705,8 @@ Treat inbound DMs as untrusted input. Defaults are designed to reduce risk:
 
 - Default behavior on DM-capable channels is **pairing**:
   - Unknown senders receive a pairing code; the bot does not process their message.
-  - Approve with: `openclaw pairing approve <channel> <code>`
-  - Pending requests are capped at **3 per channel**; check `openclaw pairing list <channel>` if a code didn't arrive.
+  - Approve with: `openclaw pairing approve --channel <channel> [--account <id>] <code>`
+  - Pending requests are capped at **3 per channel**; check `openclaw pairing list --channel <channel> [--account <id>]` if a code didn't arrive.
 - Opening DMs publicly requires explicit opt-in (`dmPolicy: "open"` and allowlist `"*"`).
 
 Run `openclaw doctor` to surface risky DM policies.
diff --git a/docs/help/troubleshooting.md b/docs/help/troubleshooting.md
index 83cad80ba32..c4754da1867 100644
--- a/docs/help/troubleshooting.md
+++ b/docs/help/troubleshooting.md
@@ -62,7 +62,7 @@ flowchart TD
     openclaw status
     openclaw gateway status
     openclaw channels status --probe
-    openclaw pairing list <channel>
+    openclaw pairing list --channel <channel> [--account <id>]
     openclaw logs --follow
     ```