docs(cli): document gateway restart --safe in command options · openclaw/openclaw@b38e674
vincentkoc
·
2026-05-05
·
via Recent Commits to openclaw:main
| Original file line number | Diff line number | Diff line change |
|---|
@@ -481,12 +481,13 @@ openclaw gateway restart
|
481 | 481 | <Accordion title="Command options"> |
482 | 482 | - `gateway status`: `--url`, `--token`, `--password`, `--timeout`, `--no-probe`, `--require-rpc`, `--deep`, `--json` |
483 | 483 | - `gateway install`: `--port`, `--runtime <node|bun>`, `--token`, `--wrapper <path>`, `--force`, `--json` |
484 | | -- `gateway restart`: `--force`, `--wait <duration>`, `--json` |
| 484 | +- `gateway restart`: `--safe`, `--force`, `--wait <duration>`, `--json` |
485 | 485 | - `gateway uninstall|start|stop`: `--json` |
486 | 486 | |
487 | 487 | </Accordion> |
488 | 488 | <Accordion title="Lifecycle behavior"> |
489 | 489 | - 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. |
| 490 | +- `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`. |
490 | 491 | - `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. |
491 | 492 | - `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. |
492 | 493 | - Lifecycle commands accept `--json` for scripting. |
|
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。
