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