docs: clarify plugin gateway auto-restart

This commit is contained in:
Peter Steinberger
2026-05-16 17:11:44 +01:00
parent 777d289979
commit 15b0d43412
3 changed files with 24 additions and 15 deletions
+15 -9
View File
@@ -27,7 +27,7 @@ Before installing a plugin, make sure you have:
- network access to the selected source, such as ClawHub, npm, or a git host
- any plugin-specific credentials, config keys, or operating-system tools named
by that plugin's setup docs
- permission to restart the Gateway that serves your channels
- permission for the Gateway that serves your channels to reload or restart
## Quick start
@@ -82,15 +82,20 @@ Before installing a plugin, make sure you have:
</Step>
<Step title="Restart the Gateway">
<Step title="Let the Gateway reload">
Installing, updating, or uninstalling plugin code requires a Gateway
restart. When a managed Gateway is already running with config reload
enabled, OpenClaw detects the changed plugin install record and restarts the
Gateway automatically. If the Gateway is not managed or reload is disabled,
restart it yourself:
```bash
openclaw gateway restart
```
Installing, updating, or uninstalling plugin code requires a Gateway
restart. Enable and disable operations update config and refresh the cold
registry, but a restart is still the clearest verification path for live
runtime surfaces.
Enable and disable operations update config and refresh the cold registry.
A runtime inspect is still the clearest verification path for live runtime
surfaces.
</Step>
@@ -204,9 +209,10 @@ openclaw plugins inspect <plugin-id> --runtime --json
openclaw gateway restart
```
On VPS or container installs, make sure the process you restart is the actual
`openclaw gateway run` child that serves your channels, not only a wrapper or
supervisor.
Managed Gateways restart automatically after plugin install, update, and
uninstall changes that alter plugin source. On VPS or container installs, make
sure any manual restart targets the actual `openclaw gateway run` child that
serves your channels, not only a wrapper or supervisor.
## Troubleshooting