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