docs: add gateway stop/start detail

This commit is contained in:
Peter Steinberger
2026-01-24 23:37:13 +00:00
parent 8e159ab0b7
commit 913d2f4b3e

View File

@@ -139,6 +139,7 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
- [Logging and debugging](#logging-and-debugging)
- [Where are logs?](#where-are-logs)
- [How do I start/stop/restart the Gateway service?](#how-do-i-startstoprestart-the-gateway-service)
- [How do I completely stop then start the Gateway?](#how-do-i-completely-stop-then-start-the-gateway)
- [ELI5: `clawdbot gateway restart` vs `clawdbot gateway`](#eli5-clawdbot-gateway-restart-vs-clawdbot-gateway)
- [Whats the fastest way to get more details when something fails?](#whats-the-fastest-way-to-get-more-details-when-something-fails)
- [Media & attachments](#media-attachments)
@@ -1915,6 +1916,26 @@ clawdbot gateway restart
If you run the gateway manually, `clawdbot gateway --force` can reclaim the port. See [Gateway](/gateway).
### How do I completely stop then start the Gateway?
If you installed the service:
```bash
clawdbot gateway stop
clawdbot gateway start
```
This stops/starts the **supervised service** (launchd on macOS, systemd on Linux).
Use this when the Gateway runs in the background as a daemon.
If youre running in the foreground, stop with CtrlC, then:
```bash
clawdbot gateway run
```
Docs: [Gateway service runbook](/gateway).
### ELI5: `clawdbot gateway restart` vs `clawdbot gateway`
- `clawdbot gateway restart`: restarts the **background service** (launchd/systemd).