From 393c2339d13fbdb1edd5260e0693462557588b89 Mon Sep 17 00:00:00 2001
From: "openclaw-docs-sync[bot]"
 <openclaw-docs-sync[bot]@users.noreply.github.com>
Date: Fri, 10 Apr 2026 06:29:29 +0000
Subject: [PATCH] chore(sync): mirror docs from
 openclaw/openclaw@723dec0432145e6d63d333755cb7bca0557ce9b3

---
 .openclaw-sync/source.json |  4 ++--
 docs/gateway/protocol.md   | 14 +++++++++++++-
 2 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json
index 121ab6a15..3ce29f2eb 100644
--- a/.openclaw-sync/source.json
+++ b/.openclaw-sync/source.json
@@ -1,5 +1,5 @@
 {
   "repository": "openclaw/openclaw",
-  "sha": "4bf94aa0d6699b7cbb9ffdf5f3f8413b598b5715",
-  "syncedAt": "2026-04-10T06:16:44.477Z"
+  "sha": "723dec0432145e6d63d333755cb7bca0557ce9b3",
+  "syncedAt": "2026-04-10T06:29:29.333Z"
 }
diff --git a/docs/gateway/protocol.md b/docs/gateway/protocol.md
index a13f91171..319b6448b 100644
--- a/docs/gateway/protocol.md
+++ b/docs/gateway/protocol.md
@@ -400,7 +400,7 @@ implemented in `src/gateway/server-methods/*.ts`.
   - `wake` schedules an immediate or next-heartbeat wake text injection
   - `cron.list`, `cron.status`, `cron.add`, `cron.update`, `cron.remove`,
     `cron.run`, `cron.runs`
-- skills/tools: `skills.*`, `tools.catalog`, `tools.effective`
+- skills/tools: `commands.list`, `skills.*`, `tools.catalog`, `tools.effective`
 
 ### Common event families
 
@@ -431,6 +431,18 @@ implemented in `src/gateway/server-methods/*.ts`.
 
 ### Operator helper methods
 
+- Operators may call `commands.list` (`operator.read`) to fetch the runtime
+  command inventory for an agent.
+  - `agentId` is optional; omit it to read the default agent workspace.
+  - `scope` controls which surface the primary `name` targets:
+    - `text` returns the primary text command token without the leading `/`
+    - `native` and the default `both` path return provider-aware native names
+      when available
+  - `textAliases` carries exact slash aliases such as `/model` and `/m`.
+  - `nativeName` carries the provider-aware native command name when one exists.
+  - `provider` is optional and only affects native naming plus native plugin
+    command availability.
+  - `includeArgs=false` omits serialized argument metadata from the response.
 - Operators may call `tools.catalog` (`operator.read`) to fetch the runtime tool catalog for an
   agent. The response includes grouped tools and provenance metadata:
   - `source`: `core` or `plugin`