From 8b4abd794dc97a31158ece4246d83890de0ccb99 Mon Sep 17 00:00:00 2001
From: "openclaw-docs-sync[bot]"
 <openclaw-docs-sync[bot]@users.noreply.github.com>
Date: Fri, 8 May 2026 04:38:23 +0000
Subject: [PATCH] chore(sync): mirror docs from
 openclaw/openclaw@1f88cb2ce5dd02757e9aba4b1751014c25134e6f

---
 .openclaw-sync/source.json | 6 +++---
 docs/cli/gateway.md        | 6 ++++--
 docs/gateway/index.md      | 4 +++-
 3 files changed, 10 insertions(+), 6 deletions(-)

diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json
index 4335068a5..363efa6cc 100644
--- a/.openclaw-sync/source.json
+++ b/.openclaw-sync/source.json
@@ -1,15 +1,15 @@
 {
   "repository": "openclaw/openclaw",
-  "sha": "f62618f805fcae22693d2590e42460fb6958b3da",
+  "sha": "1f88cb2ce5dd02757e9aba4b1751014c25134e6f",
   "sources": {
     "openclaw": {
       "repository": "openclaw/openclaw",
-      "sha": "f62618f805fcae22693d2590e42460fb6958b3da"
+      "sha": "1f88cb2ce5dd02757e9aba4b1751014c25134e6f"
     },
     "clawhub": {
       "repository": "openclaw/clawhub",
       "sha": "38c21345906ab1f107a91b33bb86b63667d96643"
     }
   },
-  "syncedAt": "2026-05-08T04:17:33.650Z"
+  "syncedAt": "2026-05-08T04:36:54.365Z"
 }
diff --git a/docs/cli/gateway.md b/docs/cli/gateway.md
index e2896d3a2..0d3bf5280 100644
--- a/docs/cli/gateway.md
+++ b/docs/cli/gateway.md
@@ -483,11 +483,13 @@ openclaw gateway restart
     - `gateway status`: `--url`, `--token`, `--password`, `--timeout`, `--no-probe`, `--require-rpc`, `--deep`, `--json`
     - `gateway install`: `--port`, `--runtime <node|bun>`, `--token`, `--wrapper <path>`, `--force`, `--json`
     - `gateway restart`: `--safe`, `--force`, `--wait <duration>`, `--json`
-    - `gateway uninstall|start|stop`: `--json`
+    - `gateway uninstall|start`: `--json`
+    - `gateway stop`: `--disable`, `--json`
 
   </Accordion>
   <Accordion title="Lifecycle behavior">
-    - Use `gateway restart` to restart a managed service. Do not chain `gateway stop` and `gateway start` as a restart substitute; on macOS, `gateway stop` intentionally disables the LaunchAgent before stopping it.
+    - Use `gateway restart` to restart a managed service. Do not chain `gateway stop` and `gateway start` as a restart substitute.
+    - On macOS, `gateway stop` uses `launchctl bootout` by default, which removes the LaunchAgent from the current boot session without persisting a disable — KeepAlive auto-recovery remains active for future crashes and `gateway start` re-enables cleanly without a manual `launchctl enable`. Pass `--disable` to persistently suppress KeepAlive and RunAtLoad so the gateway does not respawn until the next explicit `gateway start`; use this when a manual stop should survive reboots or system restarts.
     - `gateway restart --safe` asks the running Gateway to preflight active OpenClaw work and defer the restart until reply delivery, embedded runs, and task runs drain. `--safe` cannot be combined with `--force` or `--wait`.
     - `gateway restart --wait 30s` overrides the configured restart drain budget for that restart. Bare numbers are milliseconds; units such as `s`, `m`, and `h` are accepted. `--wait 0` waits indefinitely.
     - `gateway restart --force` skips the active-work drain and restarts immediately. Use it when an operator has already inspected the listed task blockers and wants the gateway back now.
diff --git a/docs/gateway/index.md b/docs/gateway/index.md
index b76a1b0f8..9894d3b93 100644
--- a/docs/gateway/index.md
+++ b/docs/gateway/index.md
@@ -217,7 +217,9 @@ openclaw gateway restart
 openclaw gateway stop
 ```
 
-Use `openclaw gateway restart` for restarts. Do not chain `openclaw gateway stop` and `openclaw gateway start`; on macOS, `gateway stop` intentionally disables the LaunchAgent before stopping it.
+Use `openclaw gateway restart` for restarts. Do not chain `openclaw gateway stop` and `openclaw gateway start` as a restart substitute.
+
+On macOS, `gateway stop` uses `launchctl bootout` by default — this removes the LaunchAgent from the current boot session without persisting a disable, so KeepAlive auto-recovery still works after unexpected crashes and `gateway start` re-enables cleanly. To persistently suppress auto-respawn across reboots, pass `--disable`: `openclaw gateway stop --disable`.
 
 LaunchAgent labels are `ai.openclaw.gateway` (default) or `ai.openclaw.<profile>` (named profile). `openclaw doctor` audits and repairs service config drift.