diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json
index 82cd206d1..c6024ee0f 100644
--- a/.openclaw-sync/source.json
+++ b/.openclaw-sync/source.json
@@ -1,5 +1,5 @@
 {
   "repository": "openclaw/openclaw",
-  "sha": "624eaf5d4a7939c7b565257ecc379cdba1114d4b",
-  "syncedAt": "2026-05-02T21:45:07.132Z"
+  "sha": "9f8744b140445e29e83e5ff24b650301e5fe206b",
+  "syncedAt": "2026-05-02T21:46:50.415Z"
 }
diff --git a/docs/cli/daemon.md b/docs/cli/daemon.md
index ecad50e07..4581398c4 100644
--- a/docs/cli/daemon.md
+++ b/docs/cli/daemon.md
@@ -36,7 +36,8 @@ openclaw daemon uninstall
 
 - `status`: `--url`, `--token`, `--password`, `--timeout`, `--no-probe`, `--require-rpc`, `--deep`, `--json`
 - `install`: `--port`, `--runtime <node|bun>`, `--token`, `--force`, `--json`
-- lifecycle (`uninstall|start|stop|restart`): `--json`
+- `restart`: `--force`, `--wait <duration>`, `--json`
+- lifecycle (`uninstall|start|stop`): `--json`
 
 Notes:
 
diff --git a/docs/cli/gateway.md b/docs/cli/gateway.md
index ac329760f..af8a34cf7 100644
--- a/docs/cli/gateway.md
+++ b/docs/cli/gateway.md
@@ -471,11 +471,14 @@ openclaw gateway restart
   <Accordion title="Command options">
     - `gateway status`: `--url`, `--token`, `--password`, `--timeout`, `--no-probe`, `--require-rpc`, `--deep`, `--json`
     - `gateway install`: `--port`, `--runtime <node|bun>`, `--token`, `--wrapper <path>`, `--force`, `--json`
-    - `gateway uninstall|start|stop|restart`: `--json`
+    - `gateway restart`: `--force`, `--wait <duration>`, `--json`
+    - `gateway uninstall|start|stop`: `--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.
+    - `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.
     - Lifecycle commands accept `--json` for scripting.
 
   </Accordion>