openclaw
diff --git a/‎docs/concepts/openclaw-sdk.md‎
Lines changed: 367 additions & 0 deletions b/‎docs/concepts/openclaw-sdk.md‎
Lines changed: 367 additions & 0 deletions
diff --git a/‎docs/docs.json‎
Lines changed: 6 additions & 1 deletion b/‎docs/docs.json‎
Lines changed: 6 additions & 1 deletion
diff --git a/‎docs/gateway/protocol.md‎
Lines changed: 1 addition & 1 deletion b/‎docs/gateway/protocol.md‎
Lines changed: 1 addition & 1 deletion
@@ -1114,6 +1114,7 @@
                   "concepts/agent",
                   "concepts/agent-loop",
                   "concepts/agent-runtimes",
+                  "concepts/openclaw-sdk",
                   "concepts/system-prompt",
                   "concepts/context",
                   "concepts/context-engine",
@@ -1651,7 +1652,11 @@
               },
               {
                 "group": "RPC and API",
-                "pages": ["reference/rpc", "reference/device-models"]
+                "pages": [
+                  "reference/rpc",
+                  "reference/openclaw-sdk-api-design",
+                  "reference/device-models"
+                ]
               },
               {
                 "group": "Templates",
 
@@ -402,7 +402,7 @@ enumeration of `src/gateway/server-methods/*.ts`.
     - `sessions.create` creates a new session entry.
     - `sessions.send` sends a message into an existing session.
     - `sessions.steer` is the interrupt-and-steer variant for an active session.
-    - `sessions.abort` aborts active work for a session.
+    - `sessions.abort` aborts active work for a session. A caller may pass `key` plus optional `runId`, or pass `runId` alone for active runs the Gateway can resolve to a session.
     - `sessions.patch` updates session metadata/overrides and reports the resolved canonical model plus effective `agentRuntime`.
     - `sessions.reset`, `sessions.delete`, and `sessions.compact` perform session maintenance.
     - `sessions.get` returns the full stored session row.