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