Desktop app won't update
Last updated Apr 6, 2026
MultiClaw checks for updates automatically and shows progress in Settings > About. If an update fails, the fastest fix is to check your internet connection and click Check for Updates in Settings > About. If it still fails, one of the causes below matches your situation.
Check your app version
Before troubleshooting, confirm which version you're running. Open Settings > About — the Version row shows the currently installed version, and the Edition row shows whether you're running MultiClaw Companion or Enterprise.
No internet connection
The updater contacts cdn.multiclaw.io to download the latest release. If your internet is down or unstable, the update fails and the About section shows an error message.
Fix: Verify you have internet access, then go to Settings > About and click Check for Updates to retry.
Firewall blocking the update URL
Corporate firewalls sometimes block HTTPS downloads from unfamiliar domains, including cdn.multiclaw.io.
Fix: Ask your IT team to allow outbound HTTPS traffic to cdn.multiclaw.io. Once allowed, go to Settings > About and click Check for Updates to retry.
Not enough disk space
The updater needs roughly 200 MB of free space to download and unpack the installer. If your disk is full, the download fails and Settings > About shows a disk space error.
Fix: Free up at least 200 MB of disk space, then go to Settings > About and click Check for Updates to retry.
Update downloads but restart fails
If Settings > About shows Restart Now but clicking it doesn't complete the update, you can click it again — the app allows up to three restart attempts. After three failed attempts, the button is replaced with a message asking you to close and reopen MultiClaw manually.
Fix: Close MultiClaw completely and reopen it. The update applies on next launch. If the problem persists, download the full installer from https://download.multiclaw.io.
Update signature verification failed
The updater verifies every download before installing. If the verification fails — usually because of a corrupted download — Settings > About shows a signature error.
Fix: Click Check for Updates to retry the download. If the error persists, download the full installer directly from https://download.multiclaw.io.
macOS Gatekeeper or Windows SmartScreen blocked the installer
Occasionally the OS blocks the installer because a network interruption corrupted the signature check during download. This is rare.
Fix: Download the full installer directly from https://download.multiclaw.io and run it. In most cases, installing over your existing copy preserves your settings and local data. As a precaution, ensure your data is synced to a workspace before proceeding.
Still stuck?
Manual download is always available at https://download.multiclaw.io as a reliable fallback.
Related articles
Agent shows 'Disconnected'
Fix a disconnected agent status caused by gateway, network, session, or firewall issues.
Gateway fails to start
Diagnose and fix port conflicts, missing binaries, token errors, and permission problems.
Cannot sign in
Resolve sign-in failures caused by wrong workspace URL, expired sessions, SSO errors, or unconfirmed email.