[{"data":1,"prerenderedAt":765},["ShallowReactive",2],{"help-category-\u002Ftroubleshooting\u002Fdesktop-app-wont-update":3,"help-article-\u002Ftroubleshooting\u002Fdesktop-app-wont-update":4,"related-articles-\u002Ftroubleshooting\u002Fdesktop-app-wont-update":198},[],{"id":5,"title":6,"body":7,"category":183,"description":184,"draft":185,"extension":186,"meta":187,"navigation":188,"order":189,"path":190,"relatedArticles":191,"seo":192,"slug":193,"stem":194,"updatedAt":195,"__hash__":196,"excerpt":184,"searchText":197},"help\u002Fhelp\u002Ftroubleshooting\u002F04.desktop-app-wont-update.md","Desktop app won't update",{"type":8,"value":9,"toc":171},"minimark",[10,23,28,42,46,54,66,70,76,88,92,95,104,108,115,126,130,133,144,148,151,160,164],[11,12,13,14,18,19,22],"p",{},"MultiClaw checks for updates automatically and shows progress in ",[15,16,17],"strong",{},"Settings > About",". If an update fails, the fastest fix is to check your internet connection and click ",[15,20,21],{},"Check for Updates"," in Settings > About. If it still fails, one of the causes below matches your situation.",[24,25,27],"h2",{"id":26},"check-your-app-version","Check your app version",[11,29,30,31,33,34,37,38,41],{},"Before troubleshooting, confirm which version you're running. Open ",[15,32,17],{}," — the ",[15,35,36],{},"Version"," row shows the currently installed version, and the ",[15,39,40],{},"Edition"," row shows whether you're running MultiClaw Companion or Enterprise.",[24,43,45],{"id":44},"no-internet-connection","No internet connection",[11,47,48,49,53],{},"The updater contacts ",[50,51,52],"code",{},"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.",[11,55,56,59,60,62,63,65],{},[15,57,58],{},"Fix:"," Verify you have internet access, then go to ",[15,61,17],{}," and click ",[15,64,21],{}," to retry.",[24,67,69],{"id":68},"firewall-blocking-the-update-url","Firewall blocking the update URL",[11,71,72,73,75],{},"Corporate firewalls sometimes block HTTPS downloads from unfamiliar domains, including ",[50,74,52],{},".",[11,77,78,80,81,83,84,62,86,65],{},[15,79,58],{}," Ask your IT team to allow outbound HTTPS traffic to ",[50,82,52],{},". Once allowed, go to ",[15,85,17],{},[15,87,21],{},[24,89,91],{"id":90},"not-enough-disk-space","Not enough disk space",[11,93,94],{},"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.",[11,96,97,99,100,62,102,65],{},[15,98,58],{}," Free up at least 200 MB of disk space, then go to ",[15,101,17],{},[15,103,21],{},[24,105,107],{"id":106},"update-downloads-but-restart-fails","Update downloads but restart fails",[11,109,110,111,114],{},"If Settings > About shows ",[15,112,113],{},"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.",[11,116,117,119,120,75],{},[15,118,58],{}," Close MultiClaw completely and reopen it. The update applies on next launch. If the problem persists, download the full installer from ",[121,122,123],"a",{"href":123,"rel":124},"https:\u002F\u002Fdownload.multiclaw.io",[125],"nofollow",[24,127,129],{"id":128},"update-signature-verification-failed","Update signature verification failed",[11,131,132],{},"The updater verifies every download before installing. If the verification fails — usually because of a corrupted download — Settings > About shows a signature error.",[11,134,135,137,138,140,141,75],{},[15,136,58],{}," Click ",[15,139,21],{}," to retry the download. If the error persists, download the full installer directly from ",[121,142,123],{"href":123,"rel":143},[125],[24,145,147],{"id":146},"macos-gatekeeper-or-windows-smartscreen-blocked-the-installer","macOS Gatekeeper or Windows SmartScreen blocked the installer",[11,149,150],{},"Occasionally the OS blocks the installer because a network interruption corrupted the signature check during download. This is rare.",[11,152,153,155,156,159],{},[15,154,58],{}," Download the full installer directly from ",[121,157,123],{"href":123,"rel":158},[125]," 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.",[24,161,163],{"id":162},"still-stuck","Still stuck?",[11,165,166,167,170],{},"Manual download is always available at ",[121,168,123],{"href":123,"rel":169},[125]," as a reliable fallback.",{"title":172,"searchDepth":173,"depth":173,"links":174},"",2,[175,176,177,178,179,180,181,182],{"id":26,"depth":173,"text":27},{"id":44,"depth":173,"text":45},{"id":68,"depth":173,"text":69},{"id":90,"depth":173,"text":91},{"id":106,"depth":173,"text":107},{"id":128,"depth":173,"text":129},{"id":146,"depth":173,"text":147},{"id":162,"depth":173,"text":163},"troubleshooting","Fix a stuck or failing auto-updater by clearing cache or downloading the installer manually.",false,"md",{},true,4,"\u002Ftroubleshooting\u002Fdesktop-app-wont-update",[],{"title":6,"description":184},"desktop-app-wont-update","help\u002Ftroubleshooting\u002F04.desktop-app-wont-update","2026-04-06","DK6AhqHSWcPMAQv_qOMZfrLCK_01B-3SCRaMZXdYf_4","Desktop app won't update Fix a stuck or failing auto-updater by clearing cache or downloading the installer manually.",[199,339,582],{"id":200,"title":201,"body":202,"category":183,"description":328,"draft":185,"extension":186,"meta":329,"navigation":188,"order":330,"path":331,"relatedArticles":332,"seo":333,"slug":334,"stem":335,"updatedAt":336,"__hash__":337,"excerpt":328,"searchText":338},"help\u002Fhelp\u002Ftroubleshooting\u002F01.agent-shows-disconnected.md","Agent shows 'Disconnected'",{"type":8,"value":203,"toc":319},[204,218,222,231,235,238,242,250,254,265,269,283,287,295,299,308],[11,205,206,207,210,211,62,214,217],{},"The ",[15,208,209],{},"Disconnected"," badge appears when the local OpenClaw gateway cannot reach MultiClaw Cloud. In most cases, the gateway has stopped — open ",[15,212,213],{},"Settings > Gateway",[15,215,216],{},"Start gateway"," to fix it.",[24,219,221],{"id":220},"gateway-is-not-running","Gateway is not running",[11,223,224,225,227,228,230],{},"This is the most common cause. Go to ",[15,226,213],{}," and check the gateway status. If it shows as stopped, click ",[15,229,216],{}," and wait a few seconds for the agent status to update.",[24,232,234],{"id":233},"internet-connection-is-unavailable","Internet connection is unavailable",[11,236,237],{},"The gateway requires internet access to reach MultiClaw Cloud. Verify your machine can load a webpage. If your network is down, the agent will reconnect automatically once connectivity is restored.",[24,239,241],{"id":240},"multiclaw-cloud-is-experiencing-an-outage","MultiClaw Cloud is experiencing an outage",[11,243,244,245,249],{},"If your gateway is running and you have internet access, check ",[121,246,247],{"href":247,"rel":248},"https:\u002F\u002Fstatus.multiclaw.io",[125]," for any active incidents. No action is needed on your end — the gateway will reconnect once the service recovers.",[24,251,253],{"id":252},"workspace-session-has-expired","Workspace session has expired",[11,255,256,257,260,261,264],{},"Your session can expire after a period of inactivity. Go to ",[15,258,259],{},"Settings > General",", scroll to the ",[15,262,263],{},"Account"," card, and sign in again. The gateway will re-authenticate and the agent should show as connected within a few seconds.",[24,266,268],{"id":267},"firewall-or-proxy-blocking-the-connection","Firewall or proxy blocking the connection",[11,270,271,272,275,276,279,280,75],{},"Some corporate firewalls block outbound WebSocket connections. The gateway connects to MultiClaw Cloud over port ",[15,273,274],{},"443"," using the ",[15,277,278],{},"WSS"," protocol. Ask your IT administrator to allow outbound WSS traffic on port 443 to ",[50,281,282],{},"*.multiclaw.io",[24,284,286],{"id":285},"auth-token-has-expired-or-been-revoked","Auth token has expired or been revoked",[11,288,289,290,260,292,294],{},"If signing in again does not help, your local auth token may be corrupted or revoked. Go to ",[15,291,259],{},[15,293,263],{}," card, sign out completely, then sign back in. This replaces the stored token and typically resolves the issue.",[24,296,298],{"id":297},"gateway-is-running-but-agent-stays-disconnected","Gateway is running but agent stays disconnected",[11,300,301,302,62,304,307],{},"Transient WebSocket errors can leave the gateway in a stuck state. Go to ",[15,303,213],{},[15,305,306],{},"Restart gateway",". The gateway reconnects with exponential back-off — waiting 30–60 seconds after a brief network interruption often resolves it without a manual restart.",[309,310,312],"callout",{"type":311},"tip",[11,313,314,315,318],{},"If none of the steps above work, check the gateway log at ",[50,316,317],{},"~\u002F.openclaw\u002Flogs\u002Fgateway.log"," for error messages that may point to the cause.",{"title":172,"searchDepth":173,"depth":173,"links":320},[321,322,323,324,325,326,327],{"id":220,"depth":173,"text":221},{"id":233,"depth":173,"text":234},{"id":240,"depth":173,"text":241},{"id":252,"depth":173,"text":253},{"id":267,"depth":173,"text":268},{"id":285,"depth":173,"text":286},{"id":297,"depth":173,"text":298},"Fix a disconnected agent status caused by gateway, network, session, or firewall issues.",{},1,"\u002Ftroubleshooting\u002Fagent-shows-disconnected",[],{"title":201,"description":328},"agent-shows-disconnected","help\u002Ftroubleshooting\u002F01.agent-shows-disconnected","2026-03-30","9zuPiU2Ea9ivpf9-W_pFwN6PdgHplZxnykc7tldh_5k","Agent shows 'Disconnected' Fix a disconnected agent status caused by gateway, network, session, or firewall issues.",{"id":340,"title":341,"body":342,"category":183,"description":573,"draft":185,"extension":186,"meta":574,"navigation":188,"order":173,"path":575,"relatedArticles":576,"seo":577,"slug":578,"stem":579,"updatedAt":336,"__hash__":580,"excerpt":573,"searchText":581},"help\u002Fhelp\u002Ftroubleshooting\u002F02.gateway-fails-to-start.md","Gateway fails to start",{"type":8,"value":343,"toc":565},[344,373,377,383,388,424,428,431,435,453,457,460,464,489,493,496,500,525,529,532,536,555,559],[11,345,346,347,350,351,354,355,357,358,361,362,365,366,369,370,372],{},"If your gateway shows a red ",[15,348,349],{},"Error"," or ",[15,352,353],{},"Stopped"," status in ",[15,356,213],{}," and won't start, a port conflict is the most common cause. The gateway port is configured in your OpenClaw configuration file (",[50,359,360],{},"~\u002F.openclaw\u002Fopenclaw.json",") — if port ",[50,363,364],{},"18789"," is taken, update the ",[50,367,368],{},"port"," value there, then click ",[15,371,306],{},". If that doesn't help, work through the causes below.",[24,374,376],{"id":375},"port-conflict","Port conflict",[11,378,379,380,382],{},"Another process on your machine is already using port ",[50,381,364],{}," (the default gateway port). The gateway cannot bind to a port that's taken.",[11,384,385],{},[15,386,387],{},"To fix:",[389,390,391,398,409,417],"ol",{},[392,393,394,395,397],"li",{},"Open ",[50,396,360],{}," in a text editor.",[392,399,400,401,404,405,408],{},"Change the ",[50,402,403],{},"\"port\""," value to an unused port (e.g. ",[50,406,407],{},"18790",").",[392,410,411,412,414,415,75],{},"Save the file and click ",[15,413,306],{}," in ",[15,416,213],{},[392,418,419,420,423],{},"If you're on macOS or Linux and want to identify the conflicting process first, run ",[50,421,422],{},"lsof -i :18789"," in your terminal.",[24,425,427],{"id":426},"missing-or-corrupt-openclaw-binary","Missing or corrupt OpenClaw binary",[11,429,430],{},"The OpenClaw binary was deleted, moved, or never fully downloaded. Without it, the gateway cannot run.",[11,432,433],{},[15,434,387],{},[389,436,437,446],{},[392,438,439,440,445],{},"Reinstall the MultiClaw desktop app from ",[121,441,444],{"href":442,"rel":443},"https:\u002F\u002Fmulticlaw.io\u002Fdownload",[125],"multiclaw.io\u002Fdownload"," — this restores the OpenClaw binary.",[392,447,448,449,414,451,75],{},"Once reinstalled, click ",[15,450,306],{},[15,452,213],{},[24,454,456],{"id":455},"empty-or-invalid-workspace-token","Empty or invalid workspace token",[11,458,459],{},"Your gateway token was cleared — this can happen after a failed sign-in or an app reset. The gateway won't start without a valid token.",[11,461,462],{},[15,463,387],{},[389,465,466,474,480,483],{},[392,467,394,468,470,471,473],{},[15,469,259],{}," and scroll to the ",[15,472,263],{}," card.",[392,475,476,477,75],{},"Click ",[15,478,479],{},"Log out",[392,481,482],{},"Sign back in with your account credentials.",[392,484,485,486,488],{},"Your token is regenerated automatically. Click ",[15,487,306],{}," once signed in.",[24,490,492],{"id":491},"binary-not-executable-macos-and-linux","Binary not executable (macOS and Linux)",[11,494,495],{},"The OpenClaw binary exists but does not have execute permissions. This often happens after a manual file move or a filesystem restore.",[11,497,498],{},[15,499,387],{},[389,501,502,513,519],{},[392,503,504,505,508,509,512],{},"The OpenClaw binary is located at ",[50,506,507],{},"~\u002F.openclaw\u002Fbin\u002Fopenclaw"," on macOS and Linux (or ",[50,510,511],{},"%APPDATA%\\OpenClaw\\bin\\openclaw.exe"," on Windows).",[392,514,515,516,75],{},"In your terminal, run ",[50,517,518],{},"chmod +x ~\u002F.openclaw\u002Fbin\u002Fopenclaw",[392,520,476,521,414,523,75],{},[15,522,306],{},[15,524,213],{},[24,526,528],{"id":527},"data-directory-inaccessible","Data directory inaccessible",[11,530,531],{},"The OpenClaw data directory no longer exists or your user account cannot write to it. The gateway needs a writable directory to store its data.",[11,533,534],{},[15,535,387],{},[389,537,538,542,549],{},[392,539,394,540,397],{},[50,541,360],{},[392,543,544,545,548],{},"Update the ",[50,546,547],{},"\"data_dir\""," value to a folder that exists and that you have write access to.",[392,550,476,551,414,553,75],{},[15,552,306],{},[15,554,213],{},[24,556,558],{"id":557},"still-not-working","Still not working?",[11,560,561,562,564],{},"Check the gateway log at ",[50,563,317],{}," — it will usually identify the exact failure line.",{"title":172,"searchDepth":173,"depth":173,"links":566},[567,568,569,570,571,572],{"id":375,"depth":173,"text":376},{"id":426,"depth":173,"text":427},{"id":455,"depth":173,"text":456},{"id":491,"depth":173,"text":492},{"id":527,"depth":173,"text":528},{"id":557,"depth":173,"text":558},"Diagnose and fix port conflicts, missing binaries, token errors, and permission problems.",{},"\u002Ftroubleshooting\u002Fgateway-fails-to-start",[],{"title":341,"description":573},"gateway-fails-to-start","help\u002Ftroubleshooting\u002F02.gateway-fails-to-start","_0wciXQlb9TxhMmXBMEySTf8zKPz2-_ue4yZEGoHNvI","Gateway fails to start Diagnose and fix port conflicts, missing binaries, token errors, and permission problems.",{"id":583,"title":584,"body":585,"category":183,"description":755,"draft":185,"extension":186,"meta":756,"navigation":188,"order":757,"path":758,"relatedArticles":759,"seo":760,"slug":761,"stem":762,"updatedAt":336,"__hash__":763,"excerpt":755,"searchText":764},"help\u002Fhelp\u002Ftroubleshooting\u002F03.cannot-sign-in.md","Cannot sign in",{"type":8,"value":586,"toc":747},[587,590,594,605,620,624,627,632,643,648,664,668,675,689,693,696,710,714,717,728,732,735],[11,588,589],{},"If you cannot sign in, start by checking your workspace URL — most sign-in failures are caused by using the wrong subdomain. Open your invite email and copy the URL directly from it.",[24,591,593],{"id":592},"wrong-workspace-url","Wrong workspace URL",[11,595,596,597,600,601,604],{},"Your workspace has a unique subdomain. ",[50,598,599],{},"acme.multiclaw.io"," and ",[50,602,603],{},"acme.app.multiclaw.io"," are different addresses — only one is yours.",[389,606,607,610,613],{},[392,608,609],{},"Open your original invite email.",[392,611,612],{},"Copy the workspace URL exactly as written.",[392,614,615,616,619],{},"Paste it into your browser or the Desktop app's ",[15,617,618],{},"Workspace URL"," field.",[24,621,623],{"id":622},"expired-or-invalid-session","Expired or invalid session",[11,625,626],{},"Your session token may have expired, especially after a long period of inactivity.",[11,628,629],{},[15,630,631],{},"On the web dashboard:",[389,633,634,640],{},[392,635,636,637,75],{},"Open your browser's cookie settings and clear all cookies for ",[50,638,639],{},"multiclaw.io",[392,641,642],{},"Return to your workspace URL and sign in again.",[11,644,645],{},[15,646,647],{},"On the Desktop app:",[389,649,650,657,661],{},[392,651,652,653,470,655,473],{},"Go to ",[15,654,259],{},[15,656,263],{},[392,658,476,659,75],{},[15,660,479],{},[392,662,663],{},"Sign back in with your credentials.",[24,665,667],{"id":666},"sign-in-with-multiplai-error","Sign in with Multiplai error",[11,669,670,671,674],{},"If you use ",[15,672,673],{},"Sign in with Multiplai"," and see an error, the issue is usually a session mismatch between Multiplai and MultiClaw.",[389,676,677,680,686],{},[392,678,679],{},"Sign out of both Multiplai and MultiClaw completely.",[392,681,682,683,685],{},"Return to the MultiClaw sign-in screen and click ",[15,684,673],{}," again.",[392,687,688],{},"If the error persists, try signing in with email and password instead, or contact support.",[24,690,692],{"id":691},"email-not-confirmed","Email not confirmed",[11,694,695],{},"If you signed up recently and have never signed in before, your email address may not be confirmed yet.",[389,697,698,701,704],{},[392,699,700],{},"Check your inbox and spam\u002Fjunk folder for a confirmation email from MultiClaw.",[392,702,703],{},"Click the link inside that email.",[392,705,706,707,75],{},"If the email has expired or you cannot find it, return to the sign-in screen and click ",[15,708,709],{},"Resend confirmation",[24,711,713],{"id":712},"account-locked","Account locked",[11,715,716],{},"After repeated failed sign-in attempts, access may be temporarily restricted.",[389,718,719,722],{},[392,720,721],{},"Wait a few minutes, then try again.",[392,723,724,725,75],{},"If you still cannot sign in, ask your workspace admin to check your account status in MultiClaw Cloud under ",[15,726,727],{},"Settings → Members",[24,729,731],{"id":730},"multiclaw-cloud-is-down","MultiClaw Cloud is down",[11,733,734],{},"Occasionally, sign-in fails because the service itself is unavailable.",[389,736,737,744],{},[392,738,739,740,743],{},"Visit ",[121,741,247],{"href":247,"rel":742},[125]," to check for active incidents.",[392,745,746],{},"If an incident is reported, wait for it to be resolved — no action is needed on your end.",{"title":172,"searchDepth":173,"depth":173,"links":748},[749,750,751,752,753,754],{"id":592,"depth":173,"text":593},{"id":622,"depth":173,"text":623},{"id":666,"depth":173,"text":667},{"id":691,"depth":173,"text":692},{"id":712,"depth":173,"text":713},{"id":730,"depth":173,"text":731},"Resolve sign-in failures caused by wrong workspace URL, expired sessions, SSO errors, or unconfirmed email.",{},3,"\u002Ftroubleshooting\u002Fcannot-sign-in",[],{"title":584,"description":755},"cannot-sign-in","help\u002Ftroubleshooting\u002F03.cannot-sign-in","59H6ZnK81o4O-gYFOFiVOMekfEPx496CxJfHU7S5Myw","Cannot sign in Resolve sign-in failures caused by wrong workspace URL, expired sessions, SSO errors, or unconfirmed email.",1778463886906]