[{"data":1,"prerenderedAt":1854},["ShallowReactive",2],{"help-category-\u002Ftroubleshooting":3,"help-article-\u002Ftroubleshooting":1853},[4,159,402,585,764,894,1019,1189,1290,1386,1488,1738],{"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.",{"id":160,"title":161,"body":162,"category":144,"description":393,"draft":146,"extension":147,"meta":394,"navigation":149,"order":135,"path":395,"relatedArticles":396,"seo":397,"slug":398,"stem":399,"updatedAt":156,"__hash__":400,"excerpt":393,"searchText":401},"help\u002Fhelp\u002Ftroubleshooting\u002F02.gateway-fails-to-start.md","Gateway fails to start",{"type":8,"value":163,"toc":385},[164,193,197,203,208,244,248,251,255,273,277,280,284,309,313,316,320,345,349,352,356,375,379],[11,165,166,167,170,171,174,175,177,178,181,182,185,186,189,190,192],{},"If your gateway shows a red ",[15,168,169],{},"Error"," or ",[15,172,173],{},"Stopped"," status in ",[15,176,21],{}," and won't start, a port conflict is the most common cause. The gateway port is configured in your OpenClaw configuration file (",[93,179,180],{},"~\u002F.openclaw\u002Fopenclaw.json",") — if port ",[93,183,184],{},"18789"," is taken, update the ",[93,187,188],{},"port"," value there, then click ",[15,191,120],{},". If that doesn't help, work through the causes below.",[28,194,196],{"id":195},"port-conflict","Port conflict",[11,198,199,200,202],{},"Another process on your machine is already using port ",[93,201,184],{}," (the default gateway port). The gateway cannot bind to a port that's taken.",[11,204,205],{},[15,206,207],{},"To fix:",[209,210,211,218,229,237],"ol",{},[212,213,214,215,217],"li",{},"Open ",[93,216,180],{}," in a text editor.",[212,219,220,221,224,225,228],{},"Change the ",[93,222,223],{},"\"port\""," value to an unused port (e.g. ",[93,226,227],{},"18790",").",[212,230,231,232,234,235,96],{},"Save the file and click ",[15,233,120],{}," in ",[15,236,21],{},[212,238,239,240,243],{},"If you're on macOS or Linux and want to identify the conflicting process first, run ",[93,241,242],{},"lsof -i :18789"," in your terminal.",[28,245,247],{"id":246},"missing-or-corrupt-openclaw-binary","Missing or corrupt OpenClaw binary",[11,249,250],{},"The OpenClaw binary was deleted, moved, or never fully downloaded. Without it, the gateway cannot run.",[11,252,253],{},[15,254,207],{},[209,256,257,266],{},[212,258,259,260,265],{},"Reinstall the MultiClaw desktop app from ",[56,261,264],{"href":262,"rel":263},"https:\u002F\u002Fmulticlaw.io\u002Fdownload",[60],"multiclaw.io\u002Fdownload"," — this restores the OpenClaw binary.",[212,267,268,269,234,271,96],{},"Once reinstalled, click ",[15,270,120],{},[15,272,21],{},[28,274,276],{"id":275},"empty-or-invalid-workspace-token","Empty or invalid workspace token",[11,278,279],{},"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,281,282],{},[15,283,207],{},[209,285,286,294,300,303],{},[212,287,214,288,290,291,293],{},[15,289,71],{}," and scroll to the ",[15,292,75],{}," card.",[212,295,296,297,96],{},"Click ",[15,298,299],{},"Log out",[212,301,302],{},"Sign back in with your account credentials.",[212,304,305,306,308],{},"Your token is regenerated automatically. Click ",[15,307,120],{}," once signed in.",[28,310,312],{"id":311},"binary-not-executable-macos-and-linux","Binary not executable (macOS and Linux)",[11,314,315],{},"The OpenClaw binary exists but does not have execute permissions. This often happens after a manual file move or a filesystem restore.",[11,317,318],{},[15,319,207],{},[209,321,322,333,339],{},[212,323,324,325,328,329,332],{},"The OpenClaw binary is located at ",[93,326,327],{},"~\u002F.openclaw\u002Fbin\u002Fopenclaw"," on macOS and Linux (or ",[93,330,331],{},"%APPDATA%\\OpenClaw\\bin\\openclaw.exe"," on Windows).",[212,334,335,336,96],{},"In your terminal, run ",[93,337,338],{},"chmod +x ~\u002F.openclaw\u002Fbin\u002Fopenclaw",[212,340,296,341,234,343,96],{},[15,342,120],{},[15,344,21],{},[28,346,348],{"id":347},"data-directory-inaccessible","Data directory inaccessible",[11,350,351],{},"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,353,354],{},[15,355,207],{},[209,357,358,362,369],{},[212,359,214,360,217],{},[93,361,180],{},[212,363,364,365,368],{},"Update the ",[93,366,367],{},"\"data_dir\""," value to a folder that exists and that you have write access to.",[212,370,296,371,234,373,96],{},[15,372,120],{},[15,374,21],{},[28,376,378],{"id":377},"still-not-working","Still not working?",[11,380,381,382,384],{},"Check the gateway log at ",[93,383,131],{}," — it will usually identify the exact failure line.",{"title":134,"searchDepth":135,"depth":135,"links":386},[387,388,389,390,391,392],{"id":195,"depth":135,"text":196},{"id":246,"depth":135,"text":247},{"id":275,"depth":135,"text":276},{"id":311,"depth":135,"text":312},{"id":347,"depth":135,"text":348},{"id":377,"depth":135,"text":378},"Diagnose and fix port conflicts, missing binaries, token errors, and permission problems.",{},"\u002Ftroubleshooting\u002Fgateway-fails-to-start",[],{"title":161,"description":393},"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":403,"title":404,"body":405,"category":144,"description":575,"draft":146,"extension":147,"meta":576,"navigation":149,"order":577,"path":578,"relatedArticles":579,"seo":580,"slug":581,"stem":582,"updatedAt":156,"__hash__":583,"excerpt":575,"searchText":584},"help\u002Fhelp\u002Ftroubleshooting\u002F03.cannot-sign-in.md","Cannot sign in",{"type":8,"value":406,"toc":567},[407,410,414,425,440,444,447,452,463,468,484,488,495,509,513,516,530,534,537,548,552,555],[11,408,409],{},"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,411,413],{"id":412},"wrong-workspace-url","Wrong workspace URL",[11,415,416,417,420,421,424],{},"Your workspace has a unique subdomain. ",[93,418,419],{},"acme.multiclaw.io"," and ",[93,422,423],{},"acme.app.multiclaw.io"," are different addresses — only one is yours.",[209,426,427,430,433],{},[212,428,429],{},"Open your original invite email.",[212,431,432],{},"Copy the workspace URL exactly as written.",[212,434,435,436,439],{},"Paste it into your browser or the Desktop app's ",[15,437,438],{},"Workspace URL"," field.",[28,441,443],{"id":442},"expired-or-invalid-session","Expired or invalid session",[11,445,446],{},"Your session token may have expired, especially after a long period of inactivity.",[11,448,449],{},[15,450,451],{},"On the web dashboard:",[209,453,454,460],{},[212,455,456,457,96],{},"Open your browser's cookie settings and clear all cookies for ",[93,458,459],{},"multiclaw.io",[212,461,462],{},"Return to your workspace URL and sign in again.",[11,464,465],{},[15,466,467],{},"On the Desktop app:",[209,469,470,477,481],{},[212,471,472,473,290,475,293],{},"Go to ",[15,474,71],{},[15,476,75],{},[212,478,296,479,96],{},[15,480,299],{},[212,482,483],{},"Sign back in with your credentials.",[28,485,487],{"id":486},"sign-in-with-multiplai-error","Sign in with Multiplai error",[11,489,490,491,494],{},"If you use ",[15,492,493],{},"Sign in with Multiplai"," and see an error, the issue is usually a session mismatch between Multiplai and MultiClaw.",[209,496,497,500,506],{},[212,498,499],{},"Sign out of both Multiplai and MultiClaw completely.",[212,501,502,503,505],{},"Return to the MultiClaw sign-in screen and click ",[15,504,493],{}," again.",[212,507,508],{},"If the error persists, try signing in with email and password instead, or contact support.",[28,510,512],{"id":511},"email-not-confirmed","Email not confirmed",[11,514,515],{},"If you signed up recently and have never signed in before, your email address may not be confirmed yet.",[209,517,518,521,524],{},[212,519,520],{},"Check your inbox and spam\u002Fjunk folder for a confirmation email from MultiClaw.",[212,522,523],{},"Click the link inside that email.",[212,525,526,527,96],{},"If the email has expired or you cannot find it, return to the sign-in screen and click ",[15,528,529],{},"Resend confirmation",[28,531,533],{"id":532},"account-locked","Account locked",[11,535,536],{},"After repeated failed sign-in attempts, access may be temporarily restricted.",[209,538,539,542],{},[212,540,541],{},"Wait a few minutes, then try again.",[212,543,544,545,96],{},"If you still cannot sign in, ask your workspace admin to check your account status in MultiClaw Cloud under ",[15,546,547],{},"Settings → Members",[28,549,551],{"id":550},"multiclaw-cloud-is-down","MultiClaw Cloud is down",[11,553,554],{},"Occasionally, sign-in fails because the service itself is unavailable.",[209,556,557,564],{},[212,558,559,560,563],{},"Visit ",[56,561,58],{"href":58,"rel":562},[60]," to check for active incidents.",[212,565,566],{},"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":568},[569,570,571,572,573,574],{"id":412,"depth":135,"text":413},{"id":442,"depth":135,"text":443},{"id":486,"depth":135,"text":487},{"id":511,"depth":135,"text":512},{"id":532,"depth":135,"text":533},{"id":550,"depth":135,"text":551},"Resolve sign-in failures caused by wrong workspace URL, expired sessions, SSO errors, or unconfirmed email.",{},3,"\u002Ftroubleshooting\u002Fcannot-sign-in",[],{"title":404,"description":575},"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":586,"title":587,"body":588,"category":144,"description":753,"draft":146,"extension":147,"meta":754,"navigation":149,"order":755,"path":756,"relatedArticles":757,"seo":758,"slug":759,"stem":760,"updatedAt":761,"__hash__":762,"excerpt":753,"searchText":763},"help\u002Fhelp\u002Ftroubleshooting\u002F04.desktop-app-wont-update.md","Desktop app won't update",{"type":8,"value":589,"toc":743},[590,601,605,619,623,630,641,645,650,662,666,669,678,682,689,698,702,705,716,720,723,732,736],[11,591,592,593,596,597,600],{},"MultiClaw checks for updates automatically and shows progress in ",[15,594,595],{},"Settings > About",". If an update fails, the fastest fix is to check your internet connection and click ",[15,598,599],{},"Check for Updates"," in Settings > About. If it still fails, one of the causes below matches your situation.",[28,602,604],{"id":603},"check-your-app-version","Check your app version",[11,606,607,608,610,611,614,615,618],{},"Before troubleshooting, confirm which version you're running. Open ",[15,609,595],{}," — the ",[15,612,613],{},"Version"," row shows the currently installed version, and the ",[15,616,617],{},"Edition"," row shows whether you're running MultiClaw Companion or Enterprise.",[28,620,622],{"id":621},"no-internet-connection","No internet connection",[11,624,625,626,629],{},"The updater contacts ",[93,627,628],{},"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,631,632,635,636,22,638,640],{},[15,633,634],{},"Fix:"," Verify you have internet access, then go to ",[15,637,595],{},[15,639,599],{}," to retry.",[28,642,644],{"id":643},"firewall-blocking-the-update-url","Firewall blocking the update URL",[11,646,647,648,96],{},"Corporate firewalls sometimes block HTTPS downloads from unfamiliar domains, including ",[93,649,628],{},[11,651,652,654,655,657,658,22,660,640],{},[15,653,634],{}," Ask your IT team to allow outbound HTTPS traffic to ",[93,656,628],{},". Once allowed, go to ",[15,659,595],{},[15,661,599],{},[28,663,665],{"id":664},"not-enough-disk-space","Not enough disk space",[11,667,668],{},"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,670,671,673,674,22,676,640],{},[15,672,634],{}," Free up at least 200 MB of disk space, then go to ",[15,675,595],{},[15,677,599],{},[28,679,681],{"id":680},"update-downloads-but-restart-fails","Update downloads but restart fails",[11,683,684,685,688],{},"If Settings > About shows ",[15,686,687],{},"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,690,691,693,694,96],{},[15,692,634],{}," Close MultiClaw completely and reopen it. The update applies on next launch. If the problem persists, download the full installer from ",[56,695,696],{"href":696,"rel":697},"https:\u002F\u002Fdownload.multiclaw.io",[60],[28,699,701],{"id":700},"update-signature-verification-failed","Update signature verification failed",[11,703,704],{},"The updater verifies every download before installing. If the verification fails — usually because of a corrupted download — Settings > About shows a signature error.",[11,706,707,709,710,712,713,96],{},[15,708,634],{}," Click ",[15,711,599],{}," to retry the download. If the error persists, download the full installer directly from ",[56,714,696],{"href":696,"rel":715},[60],[28,717,719],{"id":718},"macos-gatekeeper-or-windows-smartscreen-blocked-the-installer","macOS Gatekeeper or Windows SmartScreen blocked the installer",[11,721,722],{},"Occasionally the OS blocks the installer because a network interruption corrupted the signature check during download. This is rare.",[11,724,725,727,728,731],{},[15,726,634],{}," Download the full installer directly from ",[56,729,696],{"href":696,"rel":730},[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,733,735],{"id":734},"still-stuck","Still stuck?",[11,737,738,739,742],{},"Manual download is always available at ",[56,740,696],{"href":696,"rel":741},[60]," as a reliable fallback.",{"title":134,"searchDepth":135,"depth":135,"links":744},[745,746,747,748,749,750,751,752],{"id":603,"depth":135,"text":604},{"id":621,"depth":135,"text":622},{"id":643,"depth":135,"text":644},{"id":664,"depth":135,"text":665},{"id":680,"depth":135,"text":681},{"id":700,"depth":135,"text":701},{"id":718,"depth":135,"text":719},{"id":734,"depth":135,"text":735},"Fix a stuck or failing auto-updater by clearing cache or downloading the installer manually.",{},4,"\u002Ftroubleshooting\u002Fdesktop-app-wont-update",[],{"title":587,"description":753},"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.",{"id":765,"title":766,"body":767,"category":144,"description":884,"draft":146,"extension":147,"meta":885,"navigation":149,"order":886,"path":887,"relatedArticles":888,"seo":889,"slug":890,"stem":891,"updatedAt":156,"__hash__":892,"excerpt":884,"searchText":893},"help\u002Fhelp\u002Ftroubleshooting\u002F05.cloud-desktop-not-connecting.md","Cloud desktop not connecting",{"type":8,"value":768,"toc":876},[769,772,776,790,794,803,809,813,837,841,855,859,865,869],[11,770,771],{},"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.",[28,773,775],{"id":774},"instance-is-stopped","Instance is stopped",[11,777,778,779,781,782,785,786,789],{},"If the status shows ",[15,780,173],{},", the instance hasn't booted yet. Start it from MultiClaw Cloud, then wait for it to reach ",[15,783,784],{},"Online"," status before clicking ",[15,787,788],{},"Connect"," in the desktop app.",[28,791,793],{"id":792},"instance-is-in-error-state","Instance is in Error state",[11,795,796,797,799,800,802],{},"An ",[15,798,169],{}," status usually means something went wrong during provisioning. Try restarting the instance from MultiClaw Cloud. If the instance returns to ",[15,801,169],{}," after two restart attempts, you may need to delete it and create a new one.",[123,804,806],{"type":805},"warning",[11,807,808],{},"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.",[28,810,812],{"id":811},"viewer-cant-establish-a-connection","Viewer can't establish a connection",[11,814,815,816,818,819,821,822,825,826,829,830,833,834,836],{},"If the instance shows ",[15,817,784],{}," but the viewer fails to load, the problem is likely WebRTC connectivity. Go to ",[15,820,21],{},", scroll down to the ",[15,823,824],{},"Browser Automation"," section, and switch ",[15,827,828],{},"WebRTC connection mode"," to ",[15,831,832],{},"TURN relay",". Click ",[15,835,788],{}," again — the relay routes traffic through MultiClaw's servers instead of a direct peer-to-peer connection.",[28,838,840],{"id":839},"corporate-firewall-blocking-traffic","Corporate firewall blocking traffic",[11,842,843,844,420,847,850,851,854],{},"Some networks block the UDP traffic or TURN server access that WebRTC requires. Ask your IT team to allow outbound UDP on ports ",[15,845,846],{},"3478",[15,848,849],{},"5349",", and HTTPS access to ",[15,852,853],{},"turn.multiclaw.io",". Once the firewall rules are in place, reconnect using the standard connection mode.",[28,856,858],{"id":857},"session-token-expired","Session token expired",[11,860,861,862,864],{},"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 ",[15,863,788],{}," to start a fresh session.",[28,866,868],{"id":867},"cloud-region-temporarily-unavailable","Cloud region temporarily unavailable",[11,870,871,872,875],{},"If none of the above apply, the region your instance runs in may be degraded. Check ",[56,873,58],{"href":58,"rel":874},[60]," for active incidents. If your region is affected, wait for the incident to resolve before reconnecting.",{"title":134,"searchDepth":135,"depth":135,"links":877},[878,879,880,881,882,883],{"id":774,"depth":135,"text":775},{"id":792,"depth":135,"text":793},{"id":811,"depth":135,"text":812},{"id":839,"depth":135,"text":840},{"id":857,"depth":135,"text":858},{"id":867,"depth":135,"text":868},"Fix connection errors for cloud desktops caused by instance state, WebRTC, or firewall issues.",{},5,"\u002Ftroubleshooting\u002Fcloud-desktop-not-connecting",[],{"title":766,"description":884},"cloud-desktop-not-connecting","help\u002Ftroubleshooting\u002F05.cloud-desktop-not-connecting","brh5QGKfjUBSJCslWTSdB1C3_Toj2kPURKvaFi_Rj-M","Cloud desktop not connecting Fix connection errors for cloud desktops caused by instance state, WebRTC, or firewall issues.",{"id":895,"title":896,"body":897,"category":144,"description":1009,"draft":146,"extension":147,"meta":1010,"navigation":149,"order":1011,"path":1012,"relatedArticles":1013,"seo":1014,"slug":1015,"stem":1016,"updatedAt":156,"__hash__":1017,"excerpt":1009,"searchText":1018},"help\u002Fhelp\u002Ftroubleshooting\u002F06.companion-extension-not-detected.md","MultiClaw Chrome Extension not detected",{"type":8,"value":898,"toc":1000},[899,902,906,917,921,935,939,942,946,949,953,974,978,981,985,995],[11,900,901],{},"If you see \"Companion not detected\" or the recording button is greyed out, start with two quick checks: is the MultiClaw Chrome Extension installed in Chrome, and is it toggled on? Those two issues account for most cases.",[28,903,905],{"id":904},"extension-not-installed","Extension not installed",[11,907,908,909,912,913,916],{},"Open the Chrome Web Store and search for ",[15,910,911],{},"MultiClaw Chrome Extension",", then click ",[15,914,915],{},"Add to Chrome",". Once it installs, reload your browser tab and try again.",[28,918,920],{"id":919},"extension-installed-but-disabled","Extension installed but disabled",[11,922,923,924,927,928,931,932,934],{},"Open Chrome and go to ",[15,925,926],{},"Extensions"," (the puzzle-piece icon in the toolbar, or navigate to ",[93,929,930],{},"chrome:\u002F\u002Fextensions","). Find the ",[15,933,911],{}," entry and make sure the toggle is turned on.",[28,936,938],{"id":937},"native-messaging-host-not-registered","Native messaging host not registered",[11,940,941],{},"This happens most often after reinstalling the Desktop app. Quit MultiClaw Desktop completely, then reopen it — the app re-registers the native messaging host on startup. After it reopens, refresh the browser tab.",[28,943,945],{"id":944},"extension-installed-in-the-wrong-chrome-profile","Extension installed in the wrong Chrome profile",[11,947,948],{},"The extension must be installed in the Chrome profile you are currently using. Click your profile avatar in the top-right corner of Chrome to see which profile is active. Either switch to the profile that has the extension installed, or reinstall the extension in the current profile.",[28,950,952],{"id":951},"browser-not-supported","Browser not supported",[11,954,955,956,959,960,959,963,959,966,969,970,973],{},"The MultiClaw Chrome Extension uses native messaging, which only works in ",[15,957,958],{},"Chrome",", ",[15,961,962],{},"Chromium",[15,964,965],{},"Edge",[15,967,968],{},"Brave",", and ",[15,971,972],{},"Arc",". Safari and Firefox are not supported. Switch to a supported browser to use browser automation.",[28,975,977],{"id":976},"desktop-app-not-running","Desktop app not running",[11,979,980],{},"The extension requires MultiClaw Desktop to be open. If the Desktop app is closed, the extension has nothing to connect to. Open MultiClaw Desktop first, then reload the browser tab.",[28,982,984],{"id":983},"macos-permission-issue","macOS permission issue",[11,986,987,988,991,992,994],{},"On macOS, if you moved the MultiClaw Desktop app out of ",[15,989,990],{},"\u002FApplications"," after installing it, macOS may block the native messaging host. Move the app back to ",[15,993,990],{},", then reopen it.",[123,996,997],{"type":125},[11,998,999],{},"If none of the steps above work, quit both the Desktop app and Chrome completely, reopen the Desktop app first, then reopen Chrome. A full restart of both clears most stubborn detection failures.",{"title":134,"searchDepth":135,"depth":135,"links":1001},[1002,1003,1004,1005,1006,1007,1008],{"id":904,"depth":135,"text":905},{"id":919,"depth":135,"text":920},{"id":937,"depth":135,"text":938},{"id":944,"depth":135,"text":945},{"id":951,"depth":135,"text":952},{"id":976,"depth":135,"text":977},{"id":983,"depth":135,"text":984},"Fix detection issues between the Desktop app and the MultiClaw Chrome Extension.",{},6,"\u002Ftroubleshooting\u002Fcompanion-extension-not-detected",[],{"title":896,"description":1009},"companion-extension-not-detected","help\u002Ftroubleshooting\u002F06.companion-extension-not-detected","QXKLlH7K2Jl3t1ucZarrUmi9PGyAMm0w_bM3LSzsKeo","MultiClaw Chrome Extension not detected Fix detection issues between the Desktop app and the MultiClaw Chrome Extension.",{"id":1020,"title":1021,"body":1022,"category":144,"description":1179,"draft":146,"extension":147,"meta":1180,"navigation":149,"order":1181,"path":1182,"relatedArticles":1183,"seo":1184,"slug":1185,"stem":1186,"updatedAt":156,"__hash__":1187,"excerpt":1179,"searchText":1188},"help\u002Fhelp\u002Ftroubleshooting\u002F07.chat-messages-not-sending.md","Chat messages not sending",{"type":8,"value":1023,"toc":1171},[1024,1034,1037,1041,1044,1065,1069,1075,1083,1087,1090,1112,1116,1119,1140,1144,1147,1150,1154,1157],[11,1025,1026,1027,1030,1031,1033],{},"If your message appears stuck or no response arrives after pressing ",[15,1028,1029],{},"Send",", the most common cause is a stopped gateway. Go to ",[15,1032,21],{}," and start the gateway, then resend your message.",[11,1035,1036],{},"If the gateway is already running, work through the causes below in order.",[28,1038,1040],{"id":1039},"gateway-is-offline","Gateway is offline",[11,1042,1043],{},"The local gateway must be running to relay messages to the agent. Without it, nothing you type can reach the agent.",[209,1045,1046,1050,1058],{},[212,1047,214,1048,96],{},[15,1049,21],{},[212,1051,778,1052,1054,1055,96],{},[15,1053,173],{},", click ",[15,1056,1057],{},"Start",[212,1059,1060,1061,1064],{},"Wait for the status to change to ",[15,1062,1063],{},"Running",", then resend your message.",[28,1066,1068],{"id":1067},"agent-is-not-connected","Agent is not connected",[11,1070,1071,1072,1074],{},"If the agent status shows ",[15,1073,17],{},", messages cannot be delivered even when the gateway is running.",[11,1076,1077,1078,1082],{},"Follow the steps in ",[56,1079,1081],{"href":1080},"\u002Fhelp\u002Ftroubleshooting\u002Fagent-shows-disconnected","Agent shows Disconnected"," to restore the connection, then retry.",[28,1084,1086],{"id":1085},"no-ai-model-configured","No AI model configured",[11,1088,1089],{},"An agent with no model assigned cannot process messages.",[209,1091,1092,1098,1105],{},[212,1093,1094,1095,96],{},"Open the agent in ",[15,1096,1097],{},"My Agents",[212,1099,1100,1101,1104],{},"Go to the ",[15,1102,1103],{},"Profile"," tab and verify a model is selected.",[212,1106,1107,1108,1111],{},"If no model is set, click ",[15,1109,1110],{},"Edit"," and choose a model from the dropdown.",[28,1113,1115],{"id":1114},"api-key-invalid-or-out-of-credits","API key invalid or out of credits",[11,1117,1118],{},"The LLM provider rejected the request. The chat input area usually shows the provider's own error code.",[209,1120,1121,1131,1137],{},[212,1122,1123,1124,170,1127,1130],{},"Look for an error like ",[15,1125,1126],{},"\"Invalid API key\"",[15,1128,1129],{},"\"Insufficient quota\""," in the chat.",[212,1132,1133,1134,1136],{},"Open the agent's profile, click ",[15,1135,1110],{},", and verify the API key for the selected provider is correct and active.",[212,1138,1139],{},"Check your account balance or usage limits on the provider's dashboard.",[28,1141,1143],{"id":1142},"rate-limit-hit","Rate limit hit",[11,1145,1146],{},"If you have sent many messages in a short period, the provider may have throttled your requests temporarily.",[11,1148,1149],{},"Wait a few minutes, then resend your message. You can also open the agent's profile and switch to a different configured model to continue immediately.",[28,1151,1153],{"id":1152},"network-issue-reaching-the-provider","Network issue reaching the provider",[11,1155,1156],{},"Your machine must be able to reach the LLM provider's API over the internet. A VPN, firewall, or dropped connection can silently block requests.",[209,1158,1159,1162,1168],{},[212,1160,1161],{},"Confirm you have a working internet connection.",[212,1163,1164,1165,228],{},"Check whether a VPN or firewall policy might be blocking the provider's domain (for example, ",[93,1166,1167],{},"api.openai.com",[212,1169,1170],{},"Disable the VPN temporarily to test, then re-enable it and add an exception if needed.",{"title":134,"searchDepth":135,"depth":135,"links":1172},[1173,1174,1175,1176,1177,1178],{"id":1039,"depth":135,"text":1040},{"id":1067,"depth":135,"text":1068},{"id":1085,"depth":135,"text":1086},{"id":1114,"depth":135,"text":1115},{"id":1142,"depth":135,"text":1143},{"id":1152,"depth":135,"text":1153},"Fix a stuck message input caused by a stopped gateway, missing model, or invalid API key.",{},7,"\u002Ftroubleshooting\u002Fchat-messages-not-sending",[],{"title":1021,"description":1179},"chat-messages-not-sending","help\u002Ftroubleshooting\u002F07.chat-messages-not-sending","cJ0dT9iC1YK-GiUnNYnQqmn8barU2Ews9JstnYgv2t8","Chat messages not sending Fix a stuck message input caused by a stopped gateway, missing model, or invalid API key.",{"id":1190,"title":1191,"body":1192,"category":144,"description":1280,"draft":146,"extension":147,"meta":1281,"navigation":149,"order":1282,"path":1283,"relatedArticles":1284,"seo":1285,"slug":1286,"stem":1287,"updatedAt":156,"__hash__":1288,"excerpt":1280,"searchText":1289},"help\u002Fhelp\u002Ftroubleshooting\u002F08.slow-agent-responses.md","Slow agent responses",{"type":8,"value":1193,"toc":1273},[1194,1197,1201,1204,1223,1227,1230,1235,1239,1242,1245,1249,1252,1257,1261,1264],[11,1195,1196],{},"If your agent is taking longer than usual to reply, the most likely cause is slowness on the LLM provider's side — not MultiClaw itself. Check your provider's status page (OpenAI, Anthropic, etc.) first. If they're reporting an incident, you'll need to wait it out or switch models.",[28,1198,1200],{"id":1199},"llm-provider-latency","LLM provider latency",[11,1202,1203],{},"The underlying language model is hosted by a third-party provider. Their server load directly affects how fast your agent responds. MultiClaw has no control over this.",[11,1205,1206,1209,1210,170,1214,1218,1219,1222],{},[15,1207,1208],{},"What to do:"," Visit your provider's status page — ",[56,1211,1212],{"href":1212,"rel":1213},"https:\u002F\u002Fstatus.openai.com",[60],[56,1215,1216],{"href":1216,"rel":1217},"https:\u002F\u002Fstatus.anthropic.com",[60],". If the provider is healthy, try switching to a faster or lighter model in the agent's ",[15,1220,1221],{},"Model"," settings.",[28,1224,1226],{"id":1225},"large-context-window","Large context window",[11,1228,1229],{},"Every message you send includes the full conversation history. As a conversation grows, the payload sent to the model grows too — and processing time increases with it.",[11,1231,1232,1234],{},[15,1233,1208],{}," Start a new conversation to reset the context. This is the most reliable way to reduce latency caused by accumulated history.",[28,1236,1238],{"id":1237},"complex-multi-step-task","Complex multi-step task",[11,1240,1241],{},"Agents working through a multi-step plan take longer by design. Each step requires the model to reason, act, and check results before moving on. This is expected behaviour, not a bug.",[11,1243,1244],{},"You'll see the agent's progress in the chat. If it appears completely stuck — no activity for several minutes — that's a different issue from general slowness.",[28,1246,1248],{"id":1247},"slow-internet-connection","Slow internet connection",[11,1250,1251],{},"A weak connection between your machine and the LLM provider's API adds latency to every request. Even a small amount of packet loss compounds across a long conversation.",[11,1253,1254,1256],{},[15,1255,1208],{}," Switch to a faster network if possible. You can use a speed test to confirm local bandwidth isn't the bottleneck.",[28,1258,1260],{"id":1259},"too-many-mcp-tools-enabled","Too many MCP tools enabled",[11,1262,1263],{},"At the start of every turn, the agent sends the schemas for all enabled MCP tools to the model. More tools means a larger payload, which slows down the first token of each response.",[11,1265,1266,1268,1269,1272],{},[15,1267,1208],{}," Disable any MCP servers you're not actively using. Open ",[15,1270,1271],{},"MCP Servers"," from the sidebar and toggle off unused servers.",{"title":134,"searchDepth":135,"depth":135,"links":1274},[1275,1276,1277,1278,1279],{"id":1199,"depth":135,"text":1200},{"id":1225,"depth":135,"text":1226},{"id":1237,"depth":135,"text":1238},{"id":1247,"depth":135,"text":1248},{"id":1259,"depth":135,"text":1260},"Understand and reduce latency caused by LLM load, large context, high token limits, or MCP tools.",{},8,"\u002Ftroubleshooting\u002Fslow-agent-responses",[],{"title":1191,"description":1280},"slow-agent-responses","help\u002Ftroubleshooting\u002F08.slow-agent-responses","M7cSrdB_9HUH8aVk-QAclXO-lCwznINr1-NhLEMWav8","Slow agent responses Understand and reduce latency caused by LLM load, large context, high token limits, or MCP tools.",{"id":1291,"title":1292,"body":1293,"category":144,"description":1376,"draft":146,"extension":147,"meta":1377,"navigation":149,"order":1378,"path":1379,"relatedArticles":1380,"seo":1381,"slug":1382,"stem":1383,"updatedAt":156,"__hash__":1384,"excerpt":1376,"searchText":1385},"help\u002Fhelp\u002Ftroubleshooting\u002F09.data-not-syncing-between-desktop-and-cloud.md","Data not syncing between desktop and cloud",{"type":8,"value":1294,"toc":1370},[1295,1308,1310,1313,1326,1330,1333,1342,1346,1349,1354,1358,1361],[11,1296,1297,1298,1300,1301,420,1304,1307],{},"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,1299,1063],{}," and you're signed in to a workspace. Confirm both in ",[15,1302,1303],{},"Settings → Gateway",[15,1305,1306],{},"Settings → General"," before investigating further.",[28,1309,1040],{"id":1039},[11,1311,1312],{},"Sync pauses completely when the gateway is stopped. No data moves between your desktop and MultiClaw Cloud until the gateway is back online.",[11,1314,1315,1317,1318,1320,1321,1054,1323,1325],{},[15,1316,1208],{}," Open ",[15,1319,1303],{}," and check the status. If it shows ",[15,1322,173],{},[15,1324,25],{},". Sync will resume automatically once it's running.",[28,1327,1329],{"id":1328},"not-signed-in-to-a-workspace","Not signed in to a workspace",[11,1331,1332],{},"Local data — agents, skills, settings — stays on your machine unless you're connected to a workspace.",[11,1334,1335,1317,1337,290,1339,1341],{},[15,1336,1208],{},[15,1338,1306],{},[15,1340,75],{}," card. If you're not connected, sign in to your workspace. Local changes sync once the connection is established.",[28,1343,1345],{"id":1344},"new-items-take-a-moment-to-appear","New items take a moment to appear",[11,1347,1348],{},"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,1350,1351,1353],{},[15,1352,1208],{}," Wait 10 seconds and refresh the dashboard. If the item still doesn't appear after a minute, check whether the gateway is running.",[28,1355,1357],{"id":1356},"multiclaw-cloud-is-unreachable","MultiClaw Cloud is unreachable",[11,1359,1360],{},"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,1362,1363,1365,1366,1369],{},[15,1364,1208],{}," Visit ",[56,1367,58],{"href":58,"rel":1368},[60]," to check for any ongoing issues. If an incident is reported, sync will resume automatically once it's resolved.",{"title":134,"searchDepth":135,"depth":135,"links":1371},[1372,1373,1374,1375],{"id":1039,"depth":135,"text":1040},{"id":1328,"depth":135,"text":1329},{"id":1344,"depth":135,"text":1345},{"id":1356,"depth":135,"text":1357},"Fix sync issues caused by a stopped gateway, missing workspace connection, or sync conflicts.",{},9,"\u002Ftroubleshooting\u002Fdata-not-syncing-between-desktop-and-cloud",[],{"title":1292,"description":1376},"data-not-syncing-between-desktop-and-cloud","help\u002Ftroubleshooting\u002F09.data-not-syncing-between-desktop-and-cloud","3uHT6Z0wKkIftQbvqAPAKefWnneAR31e_C8yslkEZBk","Data not syncing between desktop and cloud Fix sync issues caused by a stopped gateway, missing workspace connection, or sync conflicts.",{"id":1387,"title":1388,"body":1389,"category":144,"description":1478,"draft":146,"extension":147,"meta":1479,"navigation":149,"order":1480,"path":1481,"relatedArticles":1482,"seo":1483,"slug":1484,"stem":1485,"updatedAt":156,"__hash__":1486,"excerpt":1478,"searchText":1487},"help\u002Fhelp\u002Ftroubleshooting\u002F10.how-to-reset-local-data.md","How to reset local data",{"type":8,"value":1390,"toc":1474},[1391,1394,1400,1404,1407,1419,1422,1426,1431,1434],[11,1392,1393],{},"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.",[123,1395,1397],{"type":1396},"note",[11,1398,1399],{},"These steps affect only local data stored on your device. Any data already synced to your workspace in MultiClaw Cloud is not affected.",[28,1401,1403],{"id":1402},"level-1-reset-window-state","Level 1 — Reset window state",[11,1405,1406],{},"Use this when the app window is mispositioned, too small, or stuck off-screen after connecting an external monitor.",[209,1408,1409,1414],{},[212,1410,214,1411,96],{},[15,1412,1413],{},"Settings > Advanced",[212,1415,296,1416,96],{},[15,1417,1418],{},"Reset window state",[11,1420,1421],{},"The app restores its window to the default size and position. Your agents, conversations, skills, and settings are unchanged.",[28,1423,1425],{"id":1424},"level-2-delete-the-data-directory","Level 2 — Delete the data directory",[123,1427,1428],{"type":805},[11,1429,1430],{},"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,1432,1433],{},"Use this only when Level 1 and other troubleshooting steps have not resolved the issue.",[209,1435,1436,1459,1462,1465,1468],{},[212,1437,1438,1439],{},"Confirm the default data directory path:\n",[1440,1441,1442,1451],"ul",{},[212,1443,1444,1447,1448],{},[15,1445,1446],{},"macOS \u002F Linux:"," ",[93,1449,1450],{},"~\u002F.openclaw\u002F",[212,1452,1453,1447,1456],{},[15,1454,1455],{},"Windows:",[93,1457,1458],{},"%APPDATA%\\OpenClaw\\",[212,1460,1461],{},"Quit the MultiClaw desktop app completely.",[212,1463,1464],{},"Delete the data directory at that path.",[212,1466,1467],{},"Reopen the desktop app. It will recreate the directory with defaults.",[212,1469,1470,1471,1473],{},"Sign in to your workspace from ",[15,1472,71],{}," to restore your synced data.",{"title":134,"searchDepth":135,"depth":135,"links":1475},[1476,1477],{"id":1402,"depth":135,"text":1403},{"id":1424,"depth":135,"text":1425},"Safely reset the app window state or remove the local data directory.",{},10,"\u002Ftroubleshooting\u002Fhow-to-reset-local-data",[],{"title":1388,"description":1478},"how-to-reset-local-data","help\u002Ftroubleshooting\u002F10.how-to-reset-local-data","3ox2fqKROY_GlBBGsiLReFD7MV6yO6WbzPU3eSXwpiI","How to reset local data Safely reset the app window state or remove the local data directory.",{"id":1489,"title":1490,"body":1491,"category":144,"description":1728,"draft":146,"extension":147,"meta":1729,"navigation":149,"order":1730,"path":1731,"relatedArticles":1732,"seo":1733,"slug":1734,"stem":1735,"updatedAt":156,"__hash__":1736,"excerpt":1728,"searchText":1737},"help\u002Fhelp\u002Ftroubleshooting\u002F11.connections-blocked-by-a-firewall-or-proxy.md","Connections blocked by a firewall or proxy",{"type":8,"value":1492,"toc":1721},[1493,1496,1499,1503,1655,1658,1662,1681,1685,1695,1699,1707,1711],[11,1494,1495],{},"Share this article with your IT team. The table below lists every host and port MultiClaw needs — allowlisting them is the fastest way to resolve connection issues on managed networks.",[11,1497,1498],{},"The most common symptoms of a blocked connection are: the gateway starts but agents stay disconnected, cloud desktops won't connect, or auto-updates fail silently.",[28,1500,1502],{"id":1501},"allowlist","Allowlist",[1504,1505,1506,1525],"table",{},[1507,1508,1509],"thead",{},[1510,1511,1512,1516,1519,1522],"tr",{},[1513,1514,1515],"th",{},"Service",[1513,1517,1518],{},"Host",[1513,1520,1521],{},"Protocol",[1513,1523,1524],{},"Port",[1526,1527,1528,1545,1560,1575,1591,1607,1623,1640],"tbody",{},[1510,1529,1530,1534,1538,1541],{},[1531,1532,1533],"td",{},"MultiClaw Cloud",[1531,1535,1536],{},[93,1537,95],{},[1531,1539,1540],{},"HTTPS",[1531,1542,1543],{},[93,1544,86],{},[1510,1546,1547,1549,1553,1556],{},[1531,1548,1533],{},[1531,1550,1551],{},[93,1552,95],{},[1531,1554,1555],{},"WSS (WebSocket)",[1531,1557,1558],{},[93,1559,86],{},[1510,1561,1562,1565,1569,1571],{},[1531,1563,1564],{},"OpenAI",[1531,1566,1567],{},[93,1568,1167],{},[1531,1570,1540],{},[1531,1572,1573],{},[93,1574,86],{},[1510,1576,1577,1580,1585,1587],{},[1531,1578,1579],{},"Anthropic",[1531,1581,1582],{},[93,1583,1584],{},"api.anthropic.com",[1531,1586,1540],{},[1531,1588,1589],{},[93,1590,86],{},[1510,1592,1593,1596,1601,1603],{},[1531,1594,1595],{},"Google Gemini",[1531,1597,1598],{},[93,1599,1600],{},"generativelanguage.googleapis.com",[1531,1602,1540],{},[1531,1604,1605],{},[93,1606,86],{},[1510,1608,1609,1612,1616,1619],{},[1531,1610,1611],{},"Cloud desktop relay",[1531,1613,1614],{},[93,1615,853],{},[1531,1617,1618],{},"HTTPS (TURN signalling)",[1531,1620,1621],{},[93,1622,86],{},[1510,1624,1625,1627,1631,1634],{},[1531,1626,1611],{},[1531,1628,1629],{},[93,1630,853],{},[1531,1632,1633],{},"UDP (TURN relay)",[1531,1635,1636,959,1638],{},[93,1637,846],{},[93,1639,849],{},[1510,1641,1642,1645,1649,1651],{},[1531,1643,1644],{},"Auto-updater",[1531,1646,1647],{},[93,1648,628],{},[1531,1650,1540],{},[1531,1652,1653],{},[93,1654,86],{},[11,1656,1657],{},"You only need to allowlist the LLM provider APIs for the models you have configured. If you haven't connected a Google Gemini model, for example, you can skip that row.",[28,1659,1661],{"id":1660},"if-udp-is-blocked","If UDP is blocked",[11,1663,1664,1665,1667,1668,72,1670,1672,1673,829,1675,1677,1678,1680],{},"Some networks block outbound UDP entirely. If cloud desktops won't connect after allowlisting ",[93,1666,853],{},", go to ",[15,1669,21],{},[15,1671,824],{}," section, and set ",[15,1674,828],{},[15,1676,832],{},". This routes all traffic over TCP port ",[93,1679,86],{}," instead of UDP.",[28,1682,1684],{"id":1683},"configuring-a-proxy","Configuring a proxy",[11,1686,1687,1688,420,1691,1694],{},"MultiClaw respects the system ",[93,1689,1690],{},"HTTP_PROXY",[93,1692,1693],{},"HTTPS_PROXY"," environment variables automatically. Set these in your shell profile or system environment settings before launching the app.",[28,1696,1698],{"id":1697},"deep-packet-inspection-dpi","Deep packet inspection (DPI)",[11,1700,1701,1702,420,1704,1706],{},"All MultiClaw connections use TLS. If your network uses DPI that intercepts and re-signs TLS traffic, WebSocket and WebRTC connections may break even when the domain is allowlisted. Ask your IT team to exclude ",[93,1703,95],{},[93,1705,853],{}," from DPI inspection.",[28,1708,1710],{"id":1709},"still-not-connecting","Still not connecting?",[11,1712,1713,1714,1717,1718,1720],{},"If agents remain disconnected after your IT team has applied the allowlist rules, check ",[56,1715,58],{"href":58,"rel":1716},[60]," for active incidents. If there's no incident, review the gateway log at ",[93,1719,131],{}," for error details.",{"title":134,"searchDepth":135,"depth":135,"links":1722},[1723,1724,1725,1726,1727],{"id":1501,"depth":135,"text":1502},{"id":1660,"depth":135,"text":1661},{"id":1683,"depth":135,"text":1684},{"id":1697,"depth":135,"text":1698},{"id":1709,"depth":135,"text":1710},"Allowlist the hosts and ports MultiClaw needs so it works behind corporate firewalls and proxies.",{},11,"\u002Ftroubleshooting\u002Fconnections-blocked-by-a-firewall-or-proxy",[],{"title":1490,"description":1728},"connections-blocked-by-a-firewall-or-proxy","help\u002Ftroubleshooting\u002F11.connections-blocked-by-a-firewall-or-proxy","NYS1jmUvwwz9iryLWmuqVTvDNf_RZdGDeAe-dIySRdA","Connections blocked by a firewall or proxy Allowlist the hosts and ports MultiClaw needs so it works behind corporate firewalls and proxies.",{"id":1739,"title":1740,"body":1741,"category":144,"description":1843,"draft":146,"extension":147,"meta":1844,"navigation":149,"order":1845,"path":1846,"relatedArticles":1847,"seo":1848,"slug":1849,"stem":1850,"updatedAt":156,"__hash__":1851,"excerpt":1843,"searchText":1852},"help\u002Fhelp\u002Ftroubleshooting\u002F12.find-and-share-diagnostic-logs.md","Find and share diagnostic logs",{"type":8,"value":1742,"toc":1838},[1743,1746,1750,1762,1765,1790,1794,1800,1803,1807,1812,1815,1818,1835],[11,1744,1745],{},"When you need to diagnose a problem or send logs to support, MultiClaw stores them in two places: the desktop app log and the gateway log.",[28,1747,1749],{"id":1748},"desktop-app-log","Desktop app log",[11,1751,472,1752,72,1754,1757,1758,1761],{},[15,1753,71],{},[15,1755,1756],{},"App Logs"," card, and click ",[15,1759,1760],{},"Open Logs"," to open the log folder.",[11,1763,1764],{},"The log file records app startup, IPC calls, update events, and gateway connection events. If you need to find it manually, the default paths are:",[1440,1766,1767,1775,1782],{},[212,1768,1769,1447,1772],{},[15,1770,1771],{},"macOS:",[93,1773,1774],{},"~\u002FLibrary\u002FLogs\u002FMultiClaw\u002Fmulticlaw.log",[212,1776,1777,1447,1779],{},[15,1778,1455],{},[93,1780,1781],{},"%APPDATA%\\MultiClaw\\logs\\multiclaw.log",[212,1783,1784,1447,1787],{},[15,1785,1786],{},"Linux:",[93,1788,1789],{},"~\u002F.config\u002FMultiClaw\u002Flogs\u002Fmulticlaw.log",[28,1791,1793],{"id":1792},"gateway-log","Gateway log",[11,1795,1796,1797,1799],{},"The gateway log is located at ",[93,1798,131],{},", or inside whichever data directory you configured for OpenClaw.",[11,1801,1802],{},"This log records agent task execution, model API calls, WebSocket events, and file-watch events.",[28,1804,1806],{"id":1805},"share-logs-with-support","Share logs with support",[123,1808,1809],{"type":805},[11,1810,1811],{},"Log files may contain conversation context, task inputs, file paths, and other information related to your agents' activities. Open the log file and review its contents before sharing. Do not share logs that contain information you are not comfortable disclosing.",[11,1813,1814],{},"The desktop app attempts to redact API keys from logs, but you should still scan the file before sending.",[11,1816,1817],{},"Before attaching logs to a support ticket:",[209,1819,1820,1823,1829,1832],{},[212,1821,1822],{},"Compress the log folder as a ZIP file.",[212,1824,1825,1826,96],{},"Note your MultiClaw version from ",[15,1827,1828],{},"Help > About",[212,1830,1831],{},"Note your OS version.",[212,1833,1834],{},"Write a short description of what you were doing when the problem occurred.",[11,1836,1837],{},"Having these four items ready makes it easier to diagnose most issues when a support channel becomes available.",{"title":134,"searchDepth":135,"depth":135,"links":1839},[1840,1841,1842],{"id":1748,"depth":135,"text":1749},{"id":1792,"depth":135,"text":1793},{"id":1805,"depth":135,"text":1806},"Locate the desktop app and gateway logs and share them safely with support.",{},12,"\u002Ftroubleshooting\u002Ffind-and-share-diagnostic-logs",[],{"title":1740,"description":1843},"find-and-share-diagnostic-logs","help\u002Ftroubleshooting\u002F12.find-and-share-diagnostic-logs","1-9-d0pY85gt2n8lO6GVgHIqGXDwsRhPx0cjpiGrAa0","Find and share diagnostic logs Locate the desktop app and gateway logs and share them safely with support.",null,1778463883204]