Updating

Updating

Keep RemoteClaw up to date.

Recommended: remoteclaw update

The fastest way to update. It detects your install type (npm or git), fetches the latest version, runs remoteclaw doctor, and restarts the gateway.

remoteclaw update

To switch channels or target a specific version:

remoteclaw update --channel beta
remoteclaw update --tag main
remoteclaw update --dry-run   # preview without applying

See Development channels for channel semantics.

Alternative: re-run the installer

curl -fsSL https://remoteclaw.org/install.sh | bash

Add --no-onboard to skip onboarding. For source installs, pass --install-method git --no-onboard.

Alternative: manual npm or pnpm

npm i -g remoteclaw@latest

pnpm add -g remoteclaw@latest

Auto-updater

The auto-updater is off by default. Enable it in ~/.remoteclaw/remoteclaw.json:

{
  update: {
    channel: "stable",
    auto: {
      enabled: true,
      stableDelayHours: 6,
      stableJitterHours: 12,
      betaCheckIntervalHours: 1,
    },
  },
}

Channel	Behavior
stable	Waits stableDelayHours, then applies with deterministic jitter across stableJitterHours (spread rollout).
beta	Checks every betaCheckIntervalHours (default: hourly) and applies immediately.
dev	No automatic apply. Use remoteclaw update manually.

The gateway also logs an update hint on startup (disable with update.checkOnStart: false).

After updating

Run doctor

remoteclaw doctor

Migrates config, audits DM policies, and checks gateway health. Details: Doctor

Restart the gateway

remoteclaw gateway restart

Verify

remoteclaw health

Rollback

Pin a version (npm)

npm i -g remoteclaw@<version>
remoteclaw doctor
remoteclaw gateway restart

Tip: npm view remoteclaw version shows the current published version.

Pin a commit (source)

git fetch origin
git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"
pnpm install && pnpm build
remoteclaw gateway restart

To return to latest: git checkout main && git pull.

If you are stuck

• Run remoteclaw doctor again and read the output carefully.
• Check: Troubleshooting
• Ask in Discord: https://discord.gg/clawd