How to upgrade, start, and reconfigure Clawdbot on MacOS?

[dusty grove]

How to upgrade, start, and reconfigure Clawdbot on MacOS?

[paper pendant]

Based on the docs, here's how to upgrade, start, and reconfigure Clawdbot on macOS:

🚀 Upgrade Clawdbot (macOS)

Recommended (website installer):

curl -fsSL https://clawd.bot/install.sh | bash

• Detects existing installs, upgrades in place, runs clawdbot doctor
• Add --no-onboard to skip the onboarding wizard

Or via npm/pnpm:

# Global install
npm i -g clawdbot@latest
# or

pnpm add -g clawdbot@latest

Then always run:

clawdbot doctor
clawdbot gateway restart
clawdbot health

▶️ Start/Stop/Restart Gateway

CLI commands:

clawdbot gateway status

clawdbot gateway stop
clawdbot gateway restart
clawdbot gateway --port 18789 --verbose
clawdbot logs --follow

If running via macOS LaunchAgent:

# Start the service
launchctl kickstart -k gui/$UID/com.clawdbot.gateway

# Or via the app - the macOS menu bar app manages launchd automatically

Install the daemon if not already installed:

clawdbot gateway install

⚙️ Reconfigure Clawdbot

Edit your config file:

nano ~/.clawdbot/clawdbot.json

Common reconfiguration options:

{
  "agent": {
    "model": "anthropic/claude-opus-4-5"

  },
  "channels": {
    "discord": {
      "token": "your-bot-token"
    }
  }
}

Re-run onboarding to reconfigure channels:

clawdbot onboard --install-daemon

For macOS-specific settings (Canvas, Camera, etc.), the macOS app handles permissions automatically when you launch Clawdbot.app from your menu bar.