If you have installed Clawdbot as a daemon on macOS, you might find that simply killing the process doesn't work—it just keeps coming back. This is by design, as daemons are meant to be persistent services managed by the system.

Why 'Kill' Doesn't Work

When Clawdbot runs as a daemon, it is managed by launchd, the macOS service management framework. If you manually kill the process (using Activity Monitor or the kill command), launchd detects the crash and immediately restarts the service to ensure uptime.

The Proper Way: launchctl

To stop the daemon permanently, you must instruct launchd to unload the service configuration. This stops the current process and disables the automatic restart.

1. Stop and Disable the Daemon

Run the following command in your terminal:

launchctl unload ~/Library/LaunchAgents/com.clawdbot.gateway.plist

2. Verify It Is Stopped

You can check if the service is still running with:

launchctl list | grep clawdbot

If this command returns no output, the daemon has been successfully stopped.

How to Start It Again

If you later decide you want the daemon running again, use the load command:

launchctl load ~/Library/LaunchAgents/com.clawdbot.gateway.plist