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