Managing Bots

Listing bots

See all deployed bots across your servers:

getbot bots list

This shows every bot with its ID, team, org, host, and status. To filter by organization:

getbot bots list --org acme

For machine-readable output (useful for scripting):

getbot bots list --output json

Describing a bot

Get detailed information about a specific bot:

getbot bots describe BOT_ID

This shows the bot's full configuration including its URL, email, team, org, host, container, status, and creation time. The bot ID is shown in the getbot bots list output.

Upgrading bots

When a new version of OpenClaw is available, upgrade all bots in an organization:

getbot bots upgrade --org acme

This rebuilds the Docker image inside each org's container and restarts all bots. Your bot's data (conversations, workspace files) is preserved — only the runtime is updated.

The upgrade process:

1. Pulls the latest OpenClaw image
2. Stops running bots in the org
3. Rebuilds with the new image
4. Starts bots and waits for health checks

Uninstalling a bot

Remove a bot and clean up its resources:

getbot bots uninstall --email alice@acme.com --team marketing

This stops the bot's Docker containers, removes its auth configuration, and deregisters the Caddy route. If it's the last bot in the org, getbot also removes the org-level auth infrastructure.

The container itself is not deleted during uninstall — it may be shared with other bots in the same org. Use getbot infra containers delete if you want to remove the container entirely.

Bot install (low-level)

The getbot bots install command is a lower-level alternative to setup for adding a bot to an existing host:

getbot bots install --email alice@acme.com --team marketing --host my-server

This skips infrastructure setup (pre-flight checks, Incus installation) and goes straight to the deploy pipeline. It's useful when your server is already configured and you want to add another bot. See Multiple Bots for common patterns.