Skip to main content

​
clawdbot update

Safely update a source checkout (git install) of Clawdbot. If you installed via npm/pnpm/bun (global install, no git metadata), use the package manager flow in Updating.

​
Usage

clawdbot update
clawdbot update --restart
clawdbot update --json
clawdbot --update

​
Options

  • --restart: restart the Gateway daemon after a successful update.
  • --json: print machine-readable UpdateRunResult JSON.
  • --timeout <seconds>: per-step timeout (default is 1200s).

​
What it does (git checkout)

High-level:
  1. Requires a clean worktree (no uncommitted changes).
  2. Fetches and rebases against @{upstream}.
  3. Installs deps (pnpm/bun/npm depending on the checkout).
  4. Builds + builds the Control UI.
  5. Runs clawdbot doctor as the final “safe update” check.

​
--update shorthand

clawdbot --update rewrites to clawdbot update (useful for shells and launcher scripts).

​
See also