[{"data":1,"prerenderedAt":774},["ShallowReactive",2],{"help-category-\u002Fcloud-desktops\u002Fconnect-to-a-cloud-desktop":3,"help-article-\u002Fcloud-desktops\u002Fconnect-to-a-cloud-desktop":4,"related-articles-\u002Fcloud-desktops\u002Fconnect-to-a-cloud-desktop":129},[],{"id":5,"title":6,"body":7,"category":112,"description":113,"draft":114,"extension":115,"meta":116,"navigation":117,"order":118,"path":119,"relatedArticles":120,"seo":124,"slug":29,"stem":125,"updatedAt":126,"__hash__":127,"excerpt":113,"searchText":128},"help\u002Fhelp\u002Fcloud-desktops\u002F03.connect-to-a-cloud-desktop.md","Connect to a cloud desktop",{"type":8,"value":9,"toc":104},"minimark",[10,14,19,27,30,54,64,67,74,78,94,97,101],[11,12,13],"p",{},"Connecting the desktop app to a cloud desktop switches your agent backend from your local machine to the remote instance. Once connected, any agents you see, tasks you create, and conversations you have are all running on that cloud desktop.",[15,16,18],"h2",{"id":17},"before-you-start","Before you start",[11,20,21,22,26],{},"The cloud desktop must be in ",[23,24,25],"strong",{},"Online"," status before you can connect. If it shows a different status, wait for it to reach Online or manage its lifecycle from MultiClaw Cloud.",[15,28,6],{"id":29},"connect-to-a-cloud-desktop",[31,32,33,37,44,47],"ol",{},[34,35,36],"li",{},"Open the MultiClaw desktop app.",[34,38,39,40,43],{},"Click ",[23,41,42],{},"Instances"," in the sidebar.",[34,45,46],{},"Click the cloud desktop you want to connect to.",[34,48,49,50,53],{},"On the detail page, click ",[23,51,52],{},"Connect",".",[11,55,56,57,59,60,63],{},"The app authenticates automatically using a secure instance token — you don't need to enter any credentials. When the ",[23,58,52],{}," button changes to ",[23,61,62],{},"Disconnect",", the link is established.",[11,65,66],{},"Your agents, tasks, and conversation history now reflect what's on the cloud desktop.",[68,69,71],"callout",{"type":70},"note",[11,72,73],{},"If the cloud desktop you want isn't showing Online status, it may still be starting up. Wait a moment and refresh the Instances screen.",[15,75,77],{"id":76},"switch-back-to-local-mode","Switch back to local mode",[31,79,80,86,89],{},[34,81,82,83,85],{},"Open the ",[23,84,42],{}," screen from the sidebar.",[34,87,88],{},"Click the cloud desktop you are connected to.",[34,90,39,91,93],{},[23,92,62],{}," on the detail page.",[11,95,96],{},"The app reconnects to the OpenClaw gateway running on your local machine. Switching modes does not delete any data — your cloud desktop and local setup each keep their own agents and history.",[15,98,100],{"id":99},"automatic-reconnection","Automatic reconnection",[11,102,103],{},"The desktop app remembers which cloud desktop you last connected to. The next time you open the app, it reconnects automatically if that cloud desktop is running. If it's stopped, the app waits on the connection screen until the instance is available.",{"title":105,"searchDepth":106,"depth":106,"links":107},"",2,[108,109,110,111],{"id":17,"depth":106,"text":18},{"id":29,"depth":106,"text":6},{"id":76,"depth":106,"text":77},{"id":99,"depth":106,"text":100},"cloud-desktops","Link the MultiClaw desktop app to a running cloud desktop so your agents and tasks run in the cloud.",false,"md",{},true,3,"\u002Fcloud-desktops\u002Fconnect-to-a-cloud-desktop",[121,122,123],"cloud-desktops\u002Fwhat-are-cloud-desktops","cloud-desktops\u002Fmonitor-your-cloud-desktops","getting-started\u002Fconnect-to-your-workspace",{"title":6,"description":113},"help\u002Fcloud-desktops\u002F03.connect-to-a-cloud-desktop",null,"BebfIbURno7L91_g0xmZHMaz90eXhSquSbbM1jLebXw","Connect to a cloud desktop Link the MultiClaw desktop app to a running cloud desktop so your agents and tasks run in the cloud.",[130,303,524],{"id":131,"title":132,"body":133,"category":112,"description":292,"draft":114,"extension":115,"meta":293,"navigation":117,"order":294,"path":295,"relatedArticles":296,"seo":298,"slug":299,"stem":300,"updatedAt":126,"__hash__":301,"excerpt":292,"searchText":302},"help\u002Fhelp\u002Fcloud-desktops\u002F01.what-are-cloud-desktops.md","What are cloud desktops?",{"type":8,"value":134,"toc":286},[135,142,146,173,177,238,242,249,253,262,277],[11,136,137,138,141],{},"A ",[23,139,140],{},"cloud desktop"," is a remote virtual machine that MultiClaw provisions and manages for you. Your agents run on it independently of your local machine — you can close your laptop and agents continue operating.",[15,143,145],{"id":144},"why-use-a-cloud-desktop","Why use a cloud desktop",[147,148,149,155,161,167],"ul",{},[34,150,151,154],{},[23,152,153],{},"Run agents continuously."," Tasks that take hours finish in the background while you do other things.",[34,156,157,160],{},[23,158,159],{},"No \"works on my machine\" issues."," Every agent runs in the same consistent environment.",[34,162,163,166],{},[23,164,165],{},"Share access with your team."," Multiple team members can connect to the same cloud desktop and see the same agents, tasks, and history.",[34,168,169,172],{},[23,170,171],{},"Keep long-running automations running."," Closing your laptop won't interrupt an agent mid-task.",[15,174,176],{"id":175},"cloud-desktops-vs-running-locally","Cloud desktops vs running locally",[178,179,180,195],"table",{},[181,182,183],"thead",{},[184,185,186,189,192],"tr",{},[187,188],"th",{},[187,190,191],{},"Cloud desktop",[187,193,194],{},"Local machine",[196,197,198,212,225],"tbody",{},[184,199,200,206,209],{},[201,202,203],"td",{},[23,204,205],{},"Runs independently",[201,207,208],{},"Yes — runs without your laptop",[201,210,211],{},"No — stops when your machine sleeps",[184,213,214,219,222],{},[201,215,216],{},[23,217,218],{},"Team access",[201,220,221],{},"Yes — any workspace member can connect",[201,223,224],{},"No — only accessible on your device",[184,226,227,232,235],{},[201,228,229],{},[23,230,231],{},"Data storage",[201,233,234],{},"Stored on the cloud desktop's disk",[201,236,237],{},"Stored on your local disk",[15,239,241],{"id":240},"whats-running-on-a-cloud-desktop","What's running on a cloud desktop",[11,243,244,245,248],{},"Each cloud desktop runs ",[23,246,247],{},"OpenClaw"," — the same open-source agent engine you'd run locally. The experience inside MultiClaw is identical whether you're connected to a cloud desktop or a local setup. You'll see the same agents, tasks, and conversation history either way.",[15,250,252],{"id":251},"oversight-and-control","Oversight and control",[11,254,255,256,261],{},"Even when running in the background, you remain in control. Agents execute plans you've approved, and you can connect to your cloud desktop at any time from the Instances screen. See ",[257,258,260],"a",{"href":259},"\u002Fhelp\u002Fteam-governance\u002Fset-up-agent-guardrails","Set up agent guardrails"," for how to set boundaries on what agents can and cannot do.",[68,263,264],{"type":70},[11,265,266,267,271,272,276],{},"Cloud desktops run on Amazon Web Services (AWS) infrastructure. See our ",[257,268,270],{"href":269},"\u002Fhelp\u002Flegal-compliance\u002Fprivacy-policy","Privacy Policy"," and ",[257,273,275],{"href":274},"\u002Fhelp\u002Fsecurity-privacy\u002Fshared-responsibility-model","Shared Responsibility Model"," for information on how data is stored, processed, and protected.",[68,278,279],{"type":70},[11,280,281,282,285],{},"You may see cloud desktops referred to as ",[23,283,284],{},"instances"," in some parts of the interface. They are the same thing.",{"title":105,"searchDepth":106,"depth":106,"links":287},[288,289,290,291],{"id":144,"depth":106,"text":145},{"id":175,"depth":106,"text":176},{"id":240,"depth":106,"text":241},{"id":251,"depth":106,"text":252},"A cloud desktop is a remote virtual machine that can run your agents in the background while your laptop is off.",{},1,"\u002Fcloud-desktops\u002Fwhat-are-cloud-desktops",[122,297,123],"cloud-desktops\u002Fconnect-to-a-cloud-desktop",{"title":132,"description":292},"what-are-cloud-desktops","help\u002Fcloud-desktops\u002F01.what-are-cloud-desktops","uGLXdsS47lVZjqJRIwIKx0wqM7iVzuJIAbcfhGh3bNc","What are cloud desktops? A cloud desktop is a remote virtual machine that can run your agents in the background while your laptop is off.",{"id":304,"title":305,"body":306,"category":112,"description":515,"draft":114,"extension":115,"meta":516,"navigation":117,"order":106,"path":517,"relatedArticles":518,"seo":519,"slug":520,"stem":521,"updatedAt":126,"__hash__":522,"excerpt":515,"searchText":523},"help\u002Fhelp\u002Fcloud-desktops\u002F02.monitor-your-cloud-desktops.md","Monitor your cloud desktops",{"type":8,"value":307,"toc":510},[308,314,318,326,329,333,480,486,490,493,507],[11,309,310,311,313],{},"The ",[23,312,42],{}," screen gives you a live view of all cloud desktops in your workspace. You can see what's running, spot problems early, and connect without leaving the desktop app.",[15,315,317],{"id":316},"view-your-cloud-desktops","View your cloud desktops",[31,319,320,322],{},[34,321,36],{},[34,323,39,324,43],{},[23,325,42],{},[11,327,328],{},"You'll see a list of all cloud desktops in your workspace. Each entry shows the name, current status, region, and resource metrics (CPU, memory, disk) when the instance is online.",[15,330,332],{"id":331},"status-indicators","Status indicators",[178,334,335,348],{},[181,336,337],{},[184,338,339,342,345],{},[187,340,341],{},"Status",[187,343,344],{},"What it means",[187,346,347],{},"What to do",[196,349,350,364,377,390,403,416,429,441,454,467],{},[184,351,352,356,359],{},[201,353,354],{},[23,355,25],{},[201,357,358],{},"The cloud desktop is active and connectable.",[201,360,39,361,363],{},[23,362,52],{}," to link the app to this instance.",[184,365,366,371,374],{},[201,367,368],{},[23,369,370],{},"Running",[201,372,373],{},"The agent daemon is active.",[201,375,376],{},"Nothing — agents are operational.",[184,378,379,384,387],{},[201,380,381],{},[23,382,383],{},"Stopped",[201,385,386],{},"The cloud desktop is off. Your data is preserved on disk — nothing is deleted by MultiClaw.",[201,388,389],{},"Start it from MultiClaw Cloud when you're ready.",[184,391,392,397,400],{},[201,393,394],{},[23,395,396],{},"Starting",[201,398,399],{},"The cloud desktop is booting up.",[201,401,402],{},"Wait — the status updates automatically.",[184,404,405,410,413],{},[201,406,407],{},[23,408,409],{},"Stopping",[201,411,412],{},"The cloud desktop is shutting down.",[201,414,415],{},"Wait for it to reach Stopped.",[184,417,418,423,426],{},[201,419,420],{},[23,421,422],{},"Provisioning",[201,424,425],{},"A new instance is being set up.",[201,427,428],{},"Wait — provisioning typically takes a few minutes.",[184,430,431,436,439],{},[201,432,433],{},[23,434,435],{},"Configuring",[201,437,438],{},"The instance is applying configuration.",[201,440,402],{},[184,442,443,448,451],{},[201,444,445],{},[23,446,447],{},"Degraded",[201,449,450],{},"The instance is reachable but has a partial failure.",[201,452,453],{},"Check the detail page and contact support if it persists.",[184,455,456,461,464],{},[201,457,458],{},[23,459,460],{},"Error",[201,462,463],{},"Something went wrong.",[201,465,466],{},"Contact support if the error persists.",[184,468,469,474,477],{},[201,470,471],{},[23,472,473],{},"Terminated",[201,475,476],{},"The instance has been permanently deleted.",[201,478,479],{},"This entry is shown for record-keeping only.",[68,481,483],{"type":482},"tip",[11,484,485],{},"Each cloud desktop shows the timestamp of its last heartbeat — the last time its agent daemon checked in. A heartbeat that's more than a few minutes old may mean the cloud desktop is unreachable, even if its status shows a healthy state.",[15,487,489],{"id":488},"instance-detail","Instance detail",[11,491,492],{},"Click any cloud desktop in the list to open its detail page. From there you can:",[147,494,495,498,501,504],{},[34,496,497],{},"See the current status and last heartbeat timestamp",[34,499,500],{},"View resource metrics (CPU, memory, disk)",[34,502,503],{},"Connect to the instance",[34,505,506],{},"View deployed agents, skills, and MCP servers",[11,508,509],{},"The detail page is your first stop when a cloud desktop is behaving unexpectedly.",{"title":105,"searchDepth":106,"depth":106,"links":511},[512,513,514],{"id":316,"depth":106,"text":317},{"id":331,"depth":106,"text":332},{"id":488,"depth":106,"text":489},"Check the status and health of your cloud desktops from the Instances screen in the desktop app.",{},"\u002Fcloud-desktops\u002Fmonitor-your-cloud-desktops",[121,297],{"title":305,"description":515},"monitor-your-cloud-desktops","help\u002Fcloud-desktops\u002F02.monitor-your-cloud-desktops","cQbWdrD7ym71J3-pt4wWZ3t7PWHGGdErdT4dVV71bNo","Monitor your cloud desktops Check the status and health of your cloud desktops from the Instances screen in the desktop app.",{"id":525,"title":526,"body":527,"category":760,"description":761,"draft":114,"extension":115,"meta":762,"navigation":117,"order":763,"path":764,"relatedArticles":765,"seo":769,"slug":770,"stem":771,"updatedAt":126,"__hash__":772,"excerpt":761,"searchText":773},"help\u002Fhelp\u002Fgetting-started\u002F09.connect-to-your-workspace.md","Connect to your workspace",{"type":8,"value":528,"toc":754},[529,532,536,539,611,614,618,658,663,665,673,700,704,710,751],[11,530,531],{},"When you first open MultiClaw, a short setup flow guides you through connecting to your workspace. You choose whether to run agents on your own machine or on a cloud desktop.",[15,533,535],{"id":534},"local-mode-vs-cloud-mode","Local mode vs cloud mode",[11,537,538],{},"Choose the mode that fits how you work before you begin:",[178,540,541,553],{},[181,542,543],{},[184,544,545,547,550],{},[187,546],{},[187,548,549],{},"Local mode",[187,551,552],{},"Cloud mode",[196,554,555,566,579,590,601],{},[184,556,557,560,563],{},[201,558,559],{},"Where agents run",[201,561,562],{},"Your machine",[201,564,565],{},"A cloud desktop",[184,567,568,570,573],{},[201,569,231],{},[201,571,572],{},"Your machine only",[201,574,575,576],{},"AWS cloud infrastructure; conversation content processed by your AI model provider — see ",[257,577,270],{"href":578},"\u002Flegal-compliance\u002Fprivacy-policy",[184,580,581,584,587],{},[201,582,583],{},"Best for",[201,585,586],{},"Individuals, testing, privacy-first setups",[201,588,589],{},"Teams, continuous background automation",[184,591,592,595,598],{},[201,593,594],{},"Requires internet",[201,596,597],{},"Only to sign in",[201,599,600],{},"Yes, always",[184,602,603,606,609],{},[201,604,605],{},"Can switch later",[201,607,608],{},"Yes",[201,610,608],{},[11,612,613],{},"Most customers start in local mode and switch to cloud mode later when they need agents running 24\u002F7.",[15,615,617],{"id":616},"connect-in-local-mode","Connect in local mode",[31,619,620,626,632,638,644,651],{},[34,621,82,622,625],{},[23,623,624],{},"MultiClaw desktop app",". The welcome screen appears on first launch.",[34,627,628,629,53],{},"Choose ",[23,630,631],{},"Run locally",[34,633,634,635,53],{},"Sign in with your email and password — or click ",[23,636,637],{},"Continue with Multiplai",[34,639,640,641,643],{},"MultiClaw installs and starts ",[23,642,247],{}," in the background. This takes about 30 seconds on first launch.",[34,645,646,647,650],{},"If you have multiple workspaces, a ",[23,648,649],{},"workspace selector"," appears. Click the workspace you want to open.",[34,652,653,654,657],{},"The status bar at the bottom shows ",[23,655,656],{},"Connected",". You're ready.",[68,659,660],{"type":482},[11,661,662],{},"The setup flow only runs once. On subsequent launches, MultiClaw connects automatically and takes you straight to your workspace.",[15,664,6],{"id":29},[68,666,667],{"type":70},[11,668,669,670,672],{},"You need a cloud desktop set up in MultiClaw Cloud before completing these steps. See ",[257,671,132],{"href":295}," to get started.",[31,674,675,684,687,694],{},[34,676,82,677,679,680,683],{},[23,678,624],{}," and choose ",[23,681,682],{},"Use cloud desktop"," on the welcome screen.",[34,685,686],{},"Sign in with your credentials.",[34,688,689,690,693],{},"MultiClaw connects to your cloud desktop and starts the ",[23,691,692],{},"gateway"," remotely. This can take up to 60 seconds.",[34,695,696,697,699],{},"The status bar shows ",[23,698,656],{}," once the link is established.",[15,701,703],{"id":702},"check-your-connection-status","Check your connection status",[11,705,310,706,709],{},[23,707,708],{},"status bar"," at the bottom of the desktop app always shows your current state:",[178,711,712,720],{},[181,713,714],{},[184,715,716,718],{},[187,717,341],{},[187,719,344],{},[196,721,722,731,741],{},[184,723,724,728],{},[201,725,726],{},[23,727,656],{},[201,729,730],{},"Signed in and gateway running — agents can run tasks",[184,732,733,738],{},[201,734,735],{},[23,736,737],{},"Disconnected",[201,739,740],{},"Not signed in, or the gateway stopped — agents cannot run",[184,742,743,748],{},[201,744,745],{},[23,746,747],{},"Connecting",[201,749,750],{},"The app is establishing the connection — wait a moment",[11,752,753],{},"If you stay disconnected after completing setup, restart the desktop app. Most first-launch issues resolve on the second start.",{"title":105,"searchDepth":106,"depth":106,"links":755},[756,757,758,759],{"id":534,"depth":106,"text":535},{"id":616,"depth":106,"text":617},{"id":29,"depth":106,"text":6},{"id":702,"depth":106,"text":703},"getting-started","How to connect the MultiClaw desktop app to your workspace in local or cloud mode, and how to check your connection status.",{},9,"\u002Fgetting-started\u002Fconnect-to-your-workspace",[766,767,768],"getting-started\u002Fwhat-is-openclaw","getting-started\u002Fsign-in-to-multiclaw","getting-started\u002Fstart-your-first-conversation",{"title":526,"description":761},"connect-to-your-workspace","help\u002Fgetting-started\u002F09.connect-to-your-workspace","SWImBYeG1I2hgXiPAuxQve4qQHR3Z7x0bLOn4eQYFX8","Connect to your workspace How to connect the MultiClaw desktop app to your workspace in local or cloud mode, and how to check your connection status.",1778463886663]