docs: add macOS launchd instructions for stopping gateway

Unify the "Processes keep restarting" FAQ section to cover both macOS
(launchd) and Linux (systemd). Previously only covered Linux.

Also update the "Clean uninstall" section with macOS commands.
This commit is contained in:
Onur Solmaz
2026-01-04 20:10:20 +03:00
committed by Peter Steinberger
parent 2110cac5d6
commit 7dc8ea815e

View File

@@ -446,31 +446,54 @@ cd ~/path/to/clawdbot
codex --full-auto "debug why clawdbot gateway won't start" codex --full-auto "debug why clawdbot gateway won't start"
``` ```
### Processes keep restarting after I kill them (Linux) ### Processes keep restarting after I kill them
Something is supervising them. Check: The gateway runs under a supervisor that auto-restarts it. You need to stop the supervisor, not just kill the process.
**macOS (launchd)**
```bash ```bash
# systemd? # Check if running
systemctl list-units | grep -i clawdbot launchctl list | grep clawdbot
sudo systemctl stop clawdbot
# pm2? # Stop and disable
pm2 list launchctl disable gui/$UID/com.clawdbot.gateway
pm2 delete all launchctl bootout gui/$UID/com.clawdbot.gateway
# Re-enable later
launchctl enable gui/$UID/com.clawdbot.gateway
launchctl bootstrap gui/$UID ~/Library/LaunchAgents/com.clawdbot.gateway.plist
``` ```
Stop the supervisor first, then the processes. **Linux (systemd)**
```bash
# Check if running
systemctl list-units | grep -i clawdbot
# Stop and disable
sudo systemctl disable --now clawdbot
```
**pm2 (if used)**
```bash
pm2 list
pm2 delete clawdbot
```
### Clean uninstall (start fresh) ### Clean uninstall (start fresh)
```bash ```bash
# Stop processes # macOS: stop launchd service
pkill -f "clawdbot" launchctl disable gui/$UID/com.clawdbot.gateway
launchctl bootout gui/$UID/com.clawdbot.gateway 2>/dev/null
# If using systemd # Linux: stop systemd service
sudo systemctl stop clawdbot sudo systemctl disable --now clawdbot
sudo systemctl disable clawdbot
# Kill any remaining processes
pkill -f "clawdbot"
# Remove data # Remove data
rm -rf ~/.clawdbot rm -rf ~/.clawdbot