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