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