[{"data":1,"prerenderedAt":820},["ShallowReactive",2],{"help-category-\u002Fgetting-started\u002Fconnect-to-your-workspace":3,"help-article-\u002Fgetting-started\u002Fconnect-to-your-workspace":4,"related-articles-\u002Fgetting-started\u002Fconnect-to-your-workspace":288},[],{"id":5,"title":6,"body":7,"category":270,"description":271,"draft":272,"extension":273,"meta":274,"navigation":275,"order":276,"path":277,"relatedArticles":278,"seo":282,"slug":283,"stem":284,"updatedAt":285,"__hash__":286,"excerpt":271,"searchText":287},"help\u002Fhelp\u002Fgetting-started\u002F09.connect-to-your-workspace.md","Connect to your workspace",{"type":8,"value":9,"toc":262},"minimark",[10,14,19,22,103,106,110,156,163,167,178,205,209,216,259],[11,12,13],"p",{},"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,16,18],"h2",{"id":17},"local-mode-vs-cloud-mode","Local mode vs cloud mode",[11,20,21],{},"Choose the mode that fits how you work before you begin:",[23,24,25,40],"table",{},[26,27,28],"thead",{},[29,30,31,34,37],"tr",{},[32,33],"th",{},[32,35,36],{},"Local mode",[32,38,39],{},"Cloud mode",[41,42,43,55,71,82,93],"tbody",{},[29,44,45,49,52],{},[46,47,48],"td",{},"Where agents run",[46,50,51],{},"Your machine",[46,53,54],{},"A cloud desktop",[29,56,57,60,63],{},[46,58,59],{},"Data storage",[46,61,62],{},"Your machine only",[46,64,65,66],{},"AWS cloud infrastructure; conversation content processed by your AI model provider — see ",[67,68,70],"a",{"href":69},"\u002Flegal-compliance\u002Fprivacy-policy","Privacy Policy",[29,72,73,76,79],{},[46,74,75],{},"Best for",[46,77,78],{},"Individuals, testing, privacy-first setups",[46,80,81],{},"Teams, continuous background automation",[29,83,84,87,90],{},[46,85,86],{},"Requires internet",[46,88,89],{},"Only to sign in",[46,91,92],{},"Yes, always",[29,94,95,98,101],{},[46,96,97],{},"Can switch later",[46,99,100],{},"Yes",[46,102,100],{},[11,104,105],{},"Most customers start in local mode and switch to cloud mode later when they need agents running 24\u002F7.",[15,107,109],{"id":108},"connect-in-local-mode","Connect in local mode",[111,112,113,122,129,135,142,149],"ol",{},[114,115,116,117,121],"li",{},"Open the ",[118,119,120],"strong",{},"MultiClaw desktop app",". The welcome screen appears on first launch.",[114,123,124,125,128],{},"Choose ",[118,126,127],{},"Run locally",".",[114,130,131,132,128],{},"Sign in with your email and password — or click ",[118,133,134],{},"Continue with Multiplai",[114,136,137,138,141],{},"MultiClaw installs and starts ",[118,139,140],{},"OpenClaw"," in the background. This takes about 30 seconds on first launch.",[114,143,144,145,148],{},"If you have multiple workspaces, a ",[118,146,147],{},"workspace selector"," appears. Click the workspace you want to open.",[114,150,151,152,155],{},"The status bar at the bottom shows ",[118,153,154],{},"Connected",". You're ready.",[157,158,160],"callout",{"type":159},"tip",[11,161,162],{},"The setup flow only runs once. On subsequent launches, MultiClaw connects automatically and takes you straight to your workspace.",[15,164,166],{"id":165},"connect-to-a-cloud-desktop","Connect to a cloud desktop",[157,168,170],{"type":169},"note",[11,171,172,173,177],{},"You need a cloud desktop set up in MultiClaw Cloud before completing these steps. See ",[67,174,176],{"href":175},"\u002Fcloud-desktops\u002Fwhat-are-cloud-desktops","What are cloud desktops?"," to get started.",[111,179,180,189,192,199],{},[114,181,116,182,184,185,188],{},[118,183,120],{}," and choose ",[118,186,187],{},"Use cloud desktop"," on the welcome screen.",[114,190,191],{},"Sign in with your credentials.",[114,193,194,195,198],{},"MultiClaw connects to your cloud desktop and starts the ",[118,196,197],{},"gateway"," remotely. This can take up to 60 seconds.",[114,200,201,202,204],{},"The status bar shows ",[118,203,154],{}," once the link is established.",[15,206,208],{"id":207},"check-your-connection-status","Check your connection status",[11,210,211,212,215],{},"The ",[118,213,214],{},"status bar"," at the bottom of the desktop app always shows your current state:",[23,217,218,228],{},[26,219,220],{},[29,221,222,225],{},[32,223,224],{},"Status",[32,226,227],{},"What it means",[41,229,230,239,249],{},[29,231,232,236],{},[46,233,234],{},[118,235,154],{},[46,237,238],{},"Signed in and gateway running — agents can run tasks",[29,240,241,246],{},[46,242,243],{},[118,244,245],{},"Disconnected",[46,247,248],{},"Not signed in, or the gateway stopped — agents cannot run",[29,250,251,256],{},[46,252,253],{},[118,254,255],{},"Connecting",[46,257,258],{},"The app is establishing the connection — wait a moment",[11,260,261],{},"If you stay disconnected after completing setup, restart the desktop app. Most first-launch issues resolve on the second start.",{"title":263,"searchDepth":264,"depth":264,"links":265},"",2,[266,267,268,269],{"id":17,"depth":264,"text":18},{"id":108,"depth":264,"text":109},{"id":165,"depth":264,"text":166},{"id":207,"depth":264,"text":208},"getting-started","How to connect the MultiClaw desktop app to your workspace in local or cloud mode, and how to check your connection status.",false,"md",{},true,9,"\u002Fgetting-started\u002Fconnect-to-your-workspace",[279,280,281],"getting-started\u002Fwhat-is-openclaw","getting-started\u002Fsign-in-to-multiclaw","getting-started\u002Fstart-your-first-conversation",{"title":6,"description":271},"connect-to-your-workspace","help\u002Fgetting-started\u002F09.connect-to-your-workspace",null,"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.",[289,541,623],{"id":290,"title":291,"body":292,"category":270,"description":528,"draft":272,"extension":273,"meta":529,"navigation":275,"order":530,"path":531,"relatedArticles":532,"seo":536,"slug":537,"stem":538,"updatedAt":285,"__hash__":539,"excerpt":528,"searchText":540},"help\u002Fhelp\u002Fgetting-started\u002F04.what-is-openclaw.md","What is OpenClaw?",{"type":8,"value":293,"toc":517},[294,299,303,306,309,313,320,323,326,332,336,346,367,371,374,464,469,475,481,485,488,491,495,501,508],[11,295,296,298],{},[118,297,140],{}," is the open-source AI agent engine that MultiClaw runs on. It starts automatically when you open the desktop app, runs entirely on your machine, and stores everything as plain files. You don't install, configure, or manage it — MultiClaw handles all of that for you.",[15,300,302],{"id":301},"how-openclaw-and-multiclaw-work-together","How OpenClaw and MultiClaw work together",[11,304,305],{},"MultiClaw and OpenClaw are two separate layers of the same product. OpenClaw is the execution layer: it runs your agents, manages conversation history, and stores your data. MultiClaw is the control layer: it provides the interface, connects to MultiClaw Cloud for team features, and manages the OpenClaw process.",[11,307,308],{},"Keeping them separate means the engine running your agents can be open source, independently auditable, and not tied to any single company's cloud.",[15,310,312],{"id":311},"the-gateway","The Gateway",[11,314,315,316,319],{},"When you open the desktop app, MultiClaw starts OpenClaw in the background. OpenClaw runs a local web server called the ",[118,317,318],{},"Gateway",". The desktop app connects to the Gateway over WebSocket to send instructions and receive results.",[11,321,322],{},"Because the Gateway runs on your machine, agent execution doesn't require a cloud connection. Your agents can work even when MultiClaw Cloud is unreachable, as long as the desktop app is running.",[11,324,325],{},"When you see \"Connected\" in the status bar, the Gateway is up and the desktop app is communicating with it successfully.",[157,327,329],{"type":328},"warning",[11,330,331],{},"If the desktop app shows \"Offline\" after it was working, the Gateway may have stopped unexpectedly. Restart the desktop app to restart the Gateway.",[15,333,335],{"id":334},"what-the-open-source-engine-means-for-you","What the open-source engine means for you",[11,337,338,339,345],{},"OpenClaw is ",[67,340,344],{"href":341,"rel":342},"https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fopenclaw",[343],"nofollow","open source on GitHub",". This has three practical implications:",[347,348,349,355,361],"ul",{},[114,350,351,354],{},[118,352,353],{},"Transparency",": Every line of code that processes your conversations and executes your agent tasks is publicly readable.",[114,356,357,360],{},[118,358,359],{},"Portability",": Your data is stored in open, human-readable formats, and the engine that reads them is open source. You're never locked in.",[114,362,363,366],{},[118,364,365],{},"Independent auditability",": Security researchers, developers, and enterprise teams can audit, contribute to, and verify the engine without relying on MultiClaw's word.",[15,368,370],{"id":369},"where-your-data-lives","Where your data lives",[11,372,373],{},"OpenClaw stores everything as plain files on your machine.",[23,375,376,389],{},[26,377,378],{},[29,379,380,383,386],{},[32,381,382],{},"Data type",[32,384,385],{},"Mac \u002F Linux",[32,387,388],{},"Windows",[41,390,391,414,429,449],{},[29,392,393,396,407],{},[46,394,395],{},"Conversation history",[46,397,398,402,403,406],{},[399,400,401],"code",{},"~\u002F.openclaw\u002Fagents\u002F"," (",[399,404,405],{},".jsonl"," files)",[46,408,409,402,412,406],{},[399,410,411],{},"%USERPROFILE%\\.openclaw\\agents\\",[399,413,405],{},[29,415,416,419,424],{},[46,417,418],{},"Agent configuration",[46,420,421],{},[399,422,423],{},"~\u002F.openclaw\u002Fopenclaw.json",[46,425,426],{},[399,427,428],{},"%USERPROFILE%\\.openclaw\\openclaw.json",[29,430,431,434,442],{},[46,432,433],{},"Skills",[46,435,436,402,439,406],{},[399,437,438],{},"~\u002F.openclaw\u002Fworkspace\u002Fskills\u002F",[399,440,441],{},"SKILL.md",[46,443,444,402,447,406],{},[399,445,446],{},"%USERPROFILE%\\.openclaw\\workspace\\skills\\",[399,448,441],{},[29,450,451,454,459],{},[46,452,453],{},"Scheduled jobs",[46,455,456],{},[399,457,458],{},"~\u002F.openclaw\u002Fcron\u002Fjobs.json",[46,460,461],{},[399,462,463],{},"%USERPROFILE%\\.openclaw\\cron\\jobs.json",[465,466,468],"h3",{"id":467},"your-configuration-file","Your configuration file",[11,470,471,474],{},[399,472,473],{},"openclaw.json"," is OpenClaw's main configuration file. It stores agent definitions, runtime settings, and workspace preferences. MultiClaw reads and writes this file when you make changes through the desktop app.",[11,476,477,478,480],{},"You can open ",[399,479,473],{}," in any text editor to inspect or back up your settings. To change a setting not exposed in the desktop app, edit the file directly. The Gateway port is one example — restart the desktop app after any manual edits to apply the change.",[15,482,484],{"id":483},"your-data-stays-on-your-machine","Your data stays on your machine",[11,486,487],{},"All agent execution happens locally. Conversations, plans, and results are written to the files above, not sent to MultiClaw Cloud. Nothing from OpenClaw's runtime leaves your machine unless you explicitly share or sync it.",[11,489,490],{},"This matters if your work involves sensitive content: the agent runtime is local-only by design.",[15,492,494],{"id":493},"you-dont-need-to-manage-it","You don't need to manage it",[11,496,497,498,128],{},"MultiClaw installs OpenClaw automatically on first launch. When a new version is available, MultiClaw updates it the next time you open the desktop app — no action required. You can check the current OpenClaw version in ",[118,499,500],{},"Settings → About",[11,502,503,504,507],{},"If you see ",[399,505,506],{},"openclaw"," in your system's process list or a log file, that's expected. It's the engine running in the background.",[157,509,510],{"type":159},[11,511,512,513,516],{},"Your data is stored as standard files, so you can back it up at any time. Copy ",[399,514,515],{},"~\u002F.openclaw\u002F"," to another machine to transfer your conversation history, agents, and skills.",{"title":263,"searchDepth":264,"depth":264,"links":518},[519,520,521,522,526,527],{"id":301,"depth":264,"text":302},{"id":311,"depth":264,"text":312},{"id":334,"depth":264,"text":335},{"id":369,"depth":264,"text":370,"children":523},[524],{"id":467,"depth":525,"text":468},3,{"id":483,"depth":264,"text":484},{"id":493,"depth":264,"text":494},"OpenClaw is the open-source AI agent engine that powers MultiClaw — installed automatically, runs locally, and stores your data as plain files.",{},4,"\u002Fgetting-started\u002Fwhat-is-openclaw",[533,534,535],"getting-started\u002Fwhat-is-multiclaw","getting-started\u002Fconnect-to-your-workspace","getting-started\u002Finstall-multiclaw",{"title":291,"description":528},"what-is-openclaw","help\u002Fgetting-started\u002F04.what-is-openclaw","iMOixl89RFnoNe9D5BA7hdel5CMTsWBh8mecP4erkNU","What is OpenClaw? OpenClaw is the open-source AI agent engine that powers MultiClaw — installed automatically, runs locally, and stores your data as plain files.",{"id":542,"title":543,"body":544,"category":270,"description":612,"draft":272,"extension":273,"meta":613,"navigation":275,"order":614,"path":615,"relatedArticles":616,"seo":618,"slug":619,"stem":620,"updatedAt":285,"__hash__":621,"excerpt":612,"searchText":622},"help\u002Fhelp\u002Fgetting-started\u002F06.sign-in-to-multiclaw.md","Sign in to MultiClaw",{"type":8,"value":545,"toc":609},[546,549,553,576,579,586],[11,547,548],{},"You sign in to MultiClaw through the desktop app using your email address and password. Your session stays active across app restarts until it expires, so you won't need to sign in every time.",[15,550,552],{"id":551},"sign-in-on-the-desktop-app","Sign in on the desktop app",[111,554,555,560,570],{},[114,556,116,557,559],{},[118,558,120],{},". The sign-in screen appears if you're not already signed in.",[114,561,562,563,566,567,128],{},"Enter your ",[118,564,565],{},"email address"," and ",[118,568,569],{},"password",[114,571,572,573,128],{},"Click ",[118,574,575],{},"Sign in",[11,577,578],{},"You're signed in. If you have only one workspace, MultiClaw opens immediately.",[11,580,581,582,585],{},"If you have more than one workspace, a ",[118,583,584],{},"Select organization"," screen appears. Click the workspace you want to open.",[157,587,588],{"type":169},[11,589,590,591,594,595,597,598,602,603,606,607,128],{},"Signing in is not the same as being ",[118,592,593],{},"connected",". ",[118,596,154],{}," means you're signed in ",[599,600,601],"em",{},"and"," MultiClaw can reach your workspace. If ",[118,604,605],{},"Offline"," appears after signing in, see ",[67,608,6],{"href":277},{"title":263,"searchDepth":264,"depth":264,"links":610},[611],{"id":551,"depth":264,"text":552},"Sign in to MultiClaw on the desktop app using your email address and password. Your session stays active across app restarts.",{},6,"\u002Fgetting-started\u002Fsign-in-to-multiclaw",[534,617],"getting-started\u002Finstall-the-desktop-app",{"title":543,"description":612},"sign-in-to-multiclaw","help\u002Fgetting-started\u002F06.sign-in-to-multiclaw","aq77K2RiZTVuRIHsjJV63xb6N11fd7Fi66EWk8iknV8","Sign in to MultiClaw Sign in to MultiClaw on the desktop app using your email address and password. Your session stays active across app restarts.",{"id":624,"title":625,"body":626,"category":270,"description":807,"draft":272,"extension":273,"meta":808,"navigation":275,"order":809,"path":810,"relatedArticles":811,"seo":815,"slug":816,"stem":817,"updatedAt":285,"__hash__":818,"excerpt":807,"searchText":819},"help\u002Fhelp\u002Fgetting-started\u002F11.start-your-first-conversation.md","Start your first conversation",{"type":8,"value":627,"toc":800},[628,631,635,638,664,668,671,690,693,698,708,713,717,720,739,742,746,753,756,759,763],[11,629,630],{},"You've installed MultiClaw and connected your workspace. Now it's time to talk to your first agent. Open the app, pick an agent, and type your first message.",[15,632,634],{"id":633},"before-you-start","Before you start",[11,636,637],{},"Make sure two things are in place:",[347,639,640,654],{},[114,641,642,645,646,649,650,653],{},[118,643,644],{},"Active connection",": Check the ",[118,647,648],{},"gateway status indicator"," in the top-right corner. It should be green. If it shows red, ",[67,651,652],{"href":277},"connect to your workspace"," first.",[114,655,656,659,660,128],{},[118,657,658],{},"At least one agent",": If you haven't created one yet, see ",[67,661,663],{"href":662},"\u002Fagents\u002Fcreate-an-agent","Create an agent",[15,665,667],{"id":666},"start-a-conversation","Start a conversation",[11,669,670],{},"When no conversation is active, you'll see a welcome greeting — \"What can I help you build today?\" — with the composer centered below it.",[111,672,673,680,683],{},[114,674,675,676,679],{},"In the composer toolbar, click the ",[118,677,678],{},"agent name"," to open a searchable list, then select the agent you want to use.",[114,681,682],{},"Type your message in the composer.",[114,684,685,686,689],{},"Press ",[118,687,688],{},"Enter"," to send.",[11,691,692],{},"After you send your first message, the composer moves to the bottom of the screen. The agent's reply streams in real time, word by word. When the stream finishes, type a follow-up message to continue the conversation.",[157,694,695],{"type":159},[11,696,697],{},"Not sure what to type? Start with something specific: \"Create a Python script that lists all files in a folder\" or \"Draft an email introducing our new product.\" The more context you give, the better the response.",[157,699,700],{"type":169},[11,701,702,703,128],{},"When you send a message, its content is processed by the AI model provider you have configured (such as OpenAI, Anthropic, or Google). Those providers handle this data under their own privacy policies. For details on how MultiClaw handles your data, see the ",[67,704,707],{"href":705,"rel":706},"https:\u002F\u002Fmulticlaw.io\u002Fprivacy",[343],"MultiClaw Privacy Policy",[157,709,710],{"type":159},[11,711,712],{},"You can have multiple conversations with the same agent. Each conversation is a separate thread with its own history.",[15,714,716],{"id":715},"start-a-new-conversation","Start a new conversation",[11,718,719],{},"To open a fresh conversation at any time:",[347,721,722,729],{},[114,723,724,725,728],{},"Click the ",[118,726,727],{},"pencil icon"," in the top-left corner of the chat area, or",[114,730,685,731,734,735,738],{},[118,732,733],{},"Cmd+N"," (Mac) \u002F ",[118,736,737],{},"Ctrl+N"," (Windows\u002FLinux).",[11,740,741],{},"The agent selector locks after you send the first message. You'll see a lock icon next to the agent name. To use a different agent, start a new conversation.",[15,743,745],{"id":744},"when-the-agent-shows-a-plan","When the agent shows a plan",[11,747,748,749,752],{},"If your request requires action — using the browser, editing files, or sending a message — the agent drafts a ",[118,750,751],{},"plan"," before doing anything. The plan appears in the conversation as a list of steps the agent intends to take.",[11,754,755],{},"Review the steps, then approve the plan to let the agent proceed. The agent does not proceed until you approve.",[11,757,758],{},"For simple questions — like \"What does this error mean?\" — no plan appears. The agent answers directly in the conversation.",[15,760,762],{"id":761},"keyboard-shortcuts","Keyboard shortcuts",[23,764,765,775],{},[26,766,767],{},[29,768,769,772],{},[32,770,771],{},"Action",[32,773,774],{},"Shortcut",[41,776,777,784,792],{},[29,778,779,782],{},[46,780,781],{},"Send message",[46,783,688],{},[29,785,786,789],{},[46,787,788],{},"New line in message",[46,790,791],{},"Shift+Enter",[29,793,794,797],{},[46,795,796],{},"New conversation",[46,798,799],{},"Cmd+N (Mac) \u002F Ctrl+N (Windows\u002FLinux)",{"title":263,"searchDepth":264,"depth":264,"links":801},[802,803,804,805,806],{"id":633,"depth":264,"text":634},{"id":666,"depth":264,"text":667},{"id":715,"depth":264,"text":716},{"id":744,"depth":264,"text":745},{"id":761,"depth":264,"text":762},"Open MultiClaw, select an agent, type your message, and start working — your first conversation takes less than a minute.",{},11,"\u002Fgetting-started\u002Fstart-your-first-conversation",[812,813,814],"getting-started\u002Fexplore-the-interface","conversations\u002Fquick-chat-vs-tasks","agents\u002Fwhat-are-agents",{"title":625,"description":807},"start-your-first-conversation","help\u002Fgetting-started\u002F11.start-your-first-conversation","kwNrpiIErxvXfrlmdv1XwgtGp7vMGJ6CWe_mLrTurwU","Start your first conversation Open MultiClaw, select an agent, type your message, and start working — your first conversation takes less than a minute.",1778463886310]