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