[{"data":1,"prerenderedAt":908},["ShallowReactive",2],{"help-category-\u002Fagents":3,"help-article-\u002Fagents":178},[4,181,294,425,559,737],{"id":5,"title":6,"body":7,"category":163,"description":164,"draft":165,"extension":166,"meta":167,"navigation":168,"order":169,"path":170,"relatedArticles":171,"seo":175,"slug":176,"stem":177,"updatedAt":178,"__hash__":179,"excerpt":164,"searchText":180},"help\u002Fhelp\u002Fagents\u002F01.what-are-agents.md","What are agents?",{"type":8,"value":9,"toc":156},"minimark",[10,14,17,22,49,56,60,139,142,146,153],[11,12,13],"p",{},"An agent is an AI assistant you configure to work for you. You give it a name, a personality, an AI model, and tools — then it can chat with you, draft plans, execute tasks, and repeat workflows automatically.",[11,15,16],{},"Before executing a task, an agent proposes a step-by-step plan for your review. You approve or reject the plan before any action is taken.",[18,19,21],"h2",{"id":20},"what-agents-can-do","What agents can do",[23,24,25,29,32,35,38,41],"ul",{},[26,27,28],"li",{},"Answer questions and hold conversations",[26,30,31],{},"Draft step-by-step plans for tasks and wait for your approval",[26,33,34],{},"Execute tasks on a cloud desktop — browsing the web, filling forms, editing files",[26,36,37],{},"Use MCP tools to connect to apps like GitHub, Slack, Google Drive, and others",[26,39,40],{},"Run recorded browser workflows and reusable skills — each run is subject to your approval before execution",[26,42,43,44,48],{},"Delegate subtasks to other agents (",[45,46,47],"strong",{},"subagents",") — delegation is included in the plan you approve before execution begins",[50,51,53],"callout",{"type":52},"note",[11,54,55],{},"If you configure agents to communicate with third parties — for example, sending emails or submitting forms on your behalf — you are responsible for ensuring those parties are informed they may be interacting with an automated AI system, as required by applicable law in your jurisdiction.",[18,57,59],{"id":58},"local-agents-vs-cloud-agents","Local agents vs cloud agents",[61,62,63,78],"table",{},[64,65,66],"thead",{},[67,68,69,72,75],"tr",{},[70,71],"th",{},[70,73,74],{},"Local agent",[70,76,77],{},"Cloud agent",[79,80,81,100,113,126],"tbody",{},[67,82,83,89,97],{},[84,85,86],"td",{},[45,87,88],{},"Where stored",[84,90,91,92,96],{},"Your machine (",[93,94,95],"code",{},"~\u002F.openclaw\u002F",")",[84,98,99],{},"MultiClaw Cloud",[67,101,102,107,110],{},[84,103,104],{},[45,105,106],{},"Who can access it",[84,108,109],{},"Only you, on that device",[84,111,112],{},"Any workspace member with permission",[67,114,115,120,123],{},[84,116,117],{},[45,118,119],{},"Syncs across devices",[84,121,122],{},"No",[84,124,125],{},"Yes",[67,127,128,133,136],{},[84,129,130],{},[45,131,132],{},"Runs 24\u002F7",[84,134,135],{},"Only while your machine is on",[84,137,138],{},"Yes, on a cloud desktop",[11,140,141],{},"Use local agents for personal work you want to keep private. Use cloud agents when your team needs shared access or you want agents running continuously.",[18,143,145],{"id":144},"agent-personalities","Agent personalities",[11,147,148,149,152],{},"Every agent has a ",[45,150,151],{},"personality"," — a system prompt that controls how it thinks, responds, and behaves. A personality might say: \"You are a senior software engineer who reviews pull requests with a focus on security and clarity.\"",[11,154,155],{},"The personality is optional, but it makes a significant difference. An agent without a personality will be generic. One with a well-written personality will feel purpose-built for your workflow.",{"title":157,"searchDepth":158,"depth":158,"links":159},"",2,[160,161,162],{"id":20,"depth":158,"text":21},{"id":58,"depth":158,"text":59},{"id":144,"depth":158,"text":145},"agents","Agents are AI assistants that plan, act, and complete tasks on your behalf — here's what they can do and how they work.",false,"md",{},true,1,"\u002Fagents\u002Fwhat-are-agents",[172,173,174],"agents\u002Fcreate-an-agent","agents\u002Fset-up-an-agent-profile","conversations\u002Freview-plans-and-approvals",{"title":6,"description":164},"what-are-agents","help\u002Fagents\u002F01.what-are-agents",null,"fQhtPN58rCzs7yUj7Wctzo3MqDyxvNS6F340jCdn6C8","What are agents? Agents are AI assistants that plan, act, and complete tasks on your behalf — here's what they can do and how they work.",{"id":182,"title":183,"body":184,"category":163,"description":284,"draft":165,"extension":166,"meta":285,"navigation":168,"order":158,"path":286,"relatedArticles":287,"seo":290,"slug":199,"stem":291,"updatedAt":178,"__hash__":292,"excerpt":284,"searchText":293},"help\u002Fhelp\u002Fagents\u002F02.create-an-agent.md","Create an agent",{"type":8,"value":185,"toc":280},[186,197,200,241,244,248,251],[11,187,188,189,192,193,196],{},"Creating an agent takes about two minutes. Open ",[45,190,191],{},"My Agents",", click ",[45,194,195],{},"Create Agent",", and the wizard walks you through four steps. Your agent is available to chat the moment you finish.",[18,198,183],{"id":199},"create-an-agent",[201,202,203,209,215,227,233],"ol",{},[26,204,205,206,208],{},"Open ",[45,207,191],{}," from the left navigation.",[26,210,211,212,214],{},"Click ",[45,213,195],{},".",[26,216,217,220,221,226],{},[45,218,219],{},"Name & model"," — enter a name that describes what the agent does and choose an AI model. The model list shows only providers you've already configured. If you don't see any, ",[222,223,225],"a",{"href":224},"\u002Fhelp\u002Ftools-integrations\u002Fset-up-your-ai-model","add an LLM provider"," first.",[26,228,229,232],{},[45,230,231],{},"Personality"," — type a system prompt that describes how the agent should behave. This step is optional but recommended.",[26,234,235,238,239,214],{},[45,236,237],{},"Review"," — confirm your settings, then click ",[45,240,195],{},[11,242,243],{},"Your new agent appears in the list immediately.",[18,245,247],{"id":246},"write-an-effective-personality","Write an effective personality",[11,249,250],{},"The personality is a free-text system prompt — plain English instructions that shape how the agent thinks and responds.",[23,252,253,259,264,269,275],{},[26,254,255,258],{},[45,256,257],{},"Do"," be specific about role and expertise: \"You are a senior financial analyst who writes concise reports.\"",[26,260,261,263],{},[45,262,257],{}," include output preferences: \"Always structure answers with a summary first, then detail.\"",[26,265,266,268],{},[45,267,257],{}," set constraints: \"Never make assumptions about deadlines — always ask if the timeline isn't clear.\"",[26,270,271,274],{},[45,272,273],{},"Don't"," write a wall of instructions. Three to six focused sentences outperform twenty vague ones.",[26,276,277,279],{},[45,278,273],{}," include task-specific content — personalities set behavior, not individual job instructions.",{"title":157,"searchDepth":158,"depth":158,"links":281},[282,283],{"id":199,"depth":158,"text":183},{"id":246,"depth":158,"text":247},"Build a new agent in minutes using the creation wizard — choose a name, model, personality, and tools.",{},"\u002Fagents\u002Fcreate-an-agent",[288,173,289],"agents\u002Fwhat-are-agents","agents\u002Fexport-and-import-agents",{"title":183,"description":284},"help\u002Fagents\u002F02.create-an-agent","y9_RcQyVan-LGI2yPSffMeOc9M7VTtdOd_mPw9YF_pU","Create an agent Build a new agent in minutes using the creation wizard — choose a name, model, personality, and tools.",{"id":295,"title":296,"body":297,"category":163,"description":414,"draft":165,"extension":166,"meta":415,"navigation":168,"order":416,"path":417,"relatedArticles":418,"seo":420,"slug":421,"stem":422,"updatedAt":178,"__hash__":423,"excerpt":414,"searchText":424},"help\u002Fhelp\u002Fagents\u002F03.set-up-an-agent-profile.md","Set up an agent profile",{"type":8,"value":298,"toc":408},[299,305,327,331,341,345,350,353,367,370,374,379,386,391,395,400],[11,300,301,302,304],{},"The agent profile page is where you configure everything about an agent after it's created. Open it by going to ",[45,303,191],{}," and selecting any agent from the list.",[11,306,307,308,311,312,311,314,311,317,311,320,323,324,214],{},"The profile is organized into tabs: ",[45,309,310],{},"Profile",", ",[45,313,231],{},[45,315,316],{},"Your Human",[45,318,319],{},"Subagents",[45,321,322],{},"Conversations",", and ",[45,325,326],{},"Danger",[18,328,330],{"id":329},"profile-tab","Profile tab",[11,332,333,334,336,337,340],{},"The ",[45,335,310],{}," tab contains the agent's identity — its display name, emoji, role, and vibe. Edit any of these fields and click ",[45,338,339],{},"Save"," to apply changes. The description is optional but helps you and your teammates understand what the agent is for.",[18,342,344],{"id":343},"personality-tab","Personality tab",[11,346,333,347,349],{},[45,348,231],{}," tab holds the agent's system prompt — the instructions that define how it thinks and behaves.",[11,351,352],{},"Write the personality in plain English. A few tips:",[23,354,355,358,361,364],{},[26,356,357],{},"Start with a role: \"You are a customer support specialist for a SaaS company.\"",[26,359,360],{},"Add behavioral rules: \"Always confirm what the user wants before taking any action.\"",[26,362,363],{},"Keep it focused. Six sharp sentences are more effective than thirty vague ones.",[26,365,366],{},"Avoid putting task-specific content here — personalities define behavior, not individual jobs.",[11,368,369],{},"Changes to personality apply to new conversations immediately. Existing conversations retain the personality they started with.",[18,371,373],{"id":372},"subagents-tab","Subagents tab",[11,375,333,376,378],{},[45,377,319],{}," tab lets you define which other agents this agent can delegate work to. When an agent has subagents, it can break a large task into pieces and propose which subtasks to delegate. Subagent delegation is included in the plan you approve before execution begins.",[11,380,381,382,385],{},"Add a subagent by clicking ",[45,383,384],{},"Add subagent"," and selecting from the list. Remove one by clicking the remove icon next to its name.",[50,387,388],{"type":52},[11,389,390],{},"Delegation is initiated by the agent's AI model based on the task. You can make other agents available as options, but you cannot force delegation to a specific subagent. Review plans carefully before approval when subagents are involved — subagent steps execute within the scope of the parent plan you approved.",[18,392,394],{"id":393},"delete-an-agent","Delete an agent",[11,396,333,397,399],{},[45,398,326],{}," tab contains the option to delete the agent. The agent is permanently removed from your workspace and cannot be recovered through the app.",[11,401,402,403,407],{},"Before deleting, consider ",[222,404,406],{"href":405},"\u002Fhelp\u002Fagents\u002Fexport-and-import-agents","exporting the agent"," as a backup.",{"title":157,"searchDepth":158,"depth":158,"links":409},[410,411,412,413],{"id":329,"depth":158,"text":330},{"id":343,"depth":158,"text":344},{"id":372,"depth":158,"text":373},{"id":393,"depth":158,"text":394},"Edit an agent's name, personality, tools, and subagents from the profile page — and delete the agent when you no longer need it.",{},3,"\u002Fagents\u002Fset-up-an-agent-profile",[288,172,419],"agents\u002Fcontrol-who-can-use-your-agents",{"title":296,"description":414},"set-up-an-agent-profile","help\u002Fagents\u002F03.set-up-an-agent-profile","EtfuagBlVVBQ-iMinvabDzOHLvJf3qOtCwhOV9zDEvw","Set up an agent profile Edit an agent's name, personality, tools, and subagents from the profile page — and delete the agent when you no longer need it.",{"id":426,"title":59,"body":427,"category":163,"description":550,"draft":165,"extension":166,"meta":551,"navigation":168,"order":552,"path":553,"relatedArticles":554,"seo":555,"slug":58,"stem":556,"updatedAt":178,"__hash__":557,"excerpt":550,"searchText":558},"help\u002Fhelp\u002Fagents\u002F04.local-agents-vs-cloud-agents.md",{"type":8,"value":428,"toc":545},[429,440,442,507,511,514,523,526,531,535,538],[11,430,431,432,435,436,439],{},"MultiClaw supports two kinds of agents: ",[45,433,434],{},"local agents"," that live on your machine, and ",[45,437,438],{},"cloud agents"," that live in MultiClaw Cloud and run on a cloud desktop. Which kind you see depends on how your app is connected.",[18,441,59],{"id":58},[61,443,444,456],{},[64,445,446],{},[67,447,448,450,453],{},[70,449],{},[70,451,452],{},"Local agents",[70,454,455],{},"Cloud agents",[79,457,458,470,482,494],{},[67,459,460,464,468],{},[84,461,462],{},[45,463,88],{},[84,465,91,466,96],{},[93,467,95],{},[84,469,99],{},[67,471,472,477,480],{},[84,473,474],{},[45,475,476],{},"Who can access them",[84,478,479],{},"Only you, on the machine where they were created",[84,481,112],{},[67,483,484,489,491],{},[84,485,486],{},[45,487,488],{},"When they run",[84,490,135],{},[84,492,493],{},"Continuously on a cloud desktop (subject to platform availability)",[67,495,496,501,504],{},[84,497,498],{},[45,499,500],{},"Best for",[84,502,503],{},"Personal use, privacy-sensitive work, testing",[84,505,506],{},"Teams, automation that runs continuously",[18,508,510],{"id":509},"why-your-agent-list-may-look-different","Why your agent list may look different",[11,512,513],{},"The desktop app shows a different list depending on your connection state.",[11,515,516,517,519,520,522],{},"When you're connected to a cloud desktop, you see your ",[45,518,438],{},". When you're running in local mode — no cloud desktop connected — you see your ",[45,521,434],{},". Switching modes changes the list entirely.",[11,524,525],{},"If your agent list suddenly looks empty or unfamiliar, check the status bar at the bottom of the app. It shows whether you're connected to a cloud desktop or running locally.",[50,527,528],{"type":52},[11,529,530],{},"Local and cloud agents don't automatically sync. An agent you created locally won't appear in the cloud until you export and import it.",[18,532,534],{"id":533},"moving-agents-between-local-and-cloud","Moving agents between local and cloud",[11,536,537],{},"To use a local agent on a cloud desktop — or bring a cloud agent to your local machine — export it from the source and import it at the destination.",[11,539,540,541,544],{},"See ",[222,542,543],{"href":405},"Export and import agents"," for step-by-step instructions.",{"title":157,"searchDepth":158,"depth":158,"links":546},[547,548,549],{"id":58,"depth":158,"text":59},{"id":509,"depth":158,"text":510},{"id":533,"depth":158,"text":534},"Understand the difference between local and cloud agents, when to use each, and why your agent list sometimes looks different.",{},4,"\u002Fagents\u002Flocal-agents-vs-cloud-agents",[288,172,289],{"title":59,"description":550},"help\u002Fagents\u002F04.local-agents-vs-cloud-agents","Be-4vHk5EfqKg7bbsFgtIXKdQQP5r0K2nE2eMkpGgNs","Local agents vs cloud agents Understand the difference between local and cloud agents, when to use each, and why your agent list sometimes looks different.",{"id":560,"title":543,"body":561,"category":163,"description":726,"draft":165,"extension":166,"meta":727,"navigation":168,"order":728,"path":729,"relatedArticles":730,"seo":732,"slug":733,"stem":734,"updatedAt":178,"__hash__":735,"excerpt":726,"searchText":736},"help\u002Fhelp\u002Fagents\u002F05.export-and-import-agents.md",{"type":8,"value":562,"toc":719},[563,566,570,586,590,622,626,672,677,681,695,699,708],[11,564,565],{},"You can export any agent as a file and import it on another machine or share it with a teammate. The exported file captures the agent's configuration — not its conversation history.",[18,567,569],{"id":568},"export-an-agent","Export an agent",[201,571,572,577,583],{},[26,573,205,574,576],{},[45,575,191],{}," and select the agent you want to export.",[26,578,211,579,582],{},[45,580,581],{},"Export"," in the agent detail view.",[26,584,585],{},"Choose a location to save the file.",[18,587,589],{"id":588},"import-an-agent","Import an agent",[201,591,592,596,602,605,616],{},[26,593,205,594,214],{},[45,595,191],{},[26,597,211,598,601],{},[45,599,600],{},"Import Agent"," at the top of the screen.",[26,603,604],{},"Select the exported file using the file picker.",[26,606,607,608,611,612,615],{},"If an agent with the same name already exists, a dialog appears. Either edit the pre-filled name in the ",[45,609,610],{},"New name"," field to keep both agents, or check ",[45,613,614],{},"Overwrite existing agent"," to replace it.",[26,617,211,618,621],{},[45,619,620],{},"Import"," to confirm. The agent appears in your list immediately.",[18,623,625],{"id":624},"what-the-file-contains","What the file contains",[61,627,628,638],{},[64,629,630],{},[67,631,632,635],{},[70,633,634],{},"Included",[70,636,637],{},"Not included",[79,639,640,648,656,664],{},[67,641,642,645],{},[84,643,644],{},"Agent name",[84,646,647],{},"Conversation history",[67,649,650,653],{},[84,651,652],{},"Description",[84,654,655],{},"Approval records",[67,657,658,661],{},[84,659,660],{},"Personality (system prompt)",[84,662,663],{},"Audit trail",[67,665,666,669],{},[84,667,668],{},"AI model selection",[84,670,671],{},"Usage statistics",[50,673,674],{"type":52},[11,675,676],{},"Approval records and audit logs are stored in MultiClaw Cloud and are not included in the exported file. They remain accessible in your workspace regardless of agent exports.",[18,678,680],{"id":679},"common-use-cases","Common use cases",[23,682,683,686,689,692],{},[26,684,685],{},"Moving an agent from your work machine to another device",[26,687,688],{},"Sharing a well-configured agent with a teammate",[26,690,691],{},"Backing up an agent before making significant changes to its personality or tools",[26,693,694],{},"Exporting as a starting point — import, then modify for a different use case",[18,696,698],{"id":697},"known-limitations","Known limitations",[50,700,702],{"type":701},"warning",[11,703,704,707],{},[45,705,706],{},"Subagent references may break."," If the agent delegates to subagents, those references use agent IDs. If those agents don't exist on the target machine, the subagent links will not work. Re-link them after importing.",[50,709,710],{"type":52},[11,711,712,715,716,718],{},[45,713,714],{},"Model may fall back to default."," If the AI model used by the exported agent isn't configured on the target machine, MultiClaw falls back to the default model. Check the ",[45,717,310],{}," tab after importing.",{"title":157,"searchDepth":158,"depth":158,"links":720},[721,722,723,724,725],{"id":568,"depth":158,"text":569},{"id":588,"depth":158,"text":589},{"id":624,"depth":158,"text":625},{"id":679,"depth":158,"text":680},{"id":697,"depth":158,"text":698},"Save an agent to a file and load it on another machine or share it with a teammate — takes about a minute.",{},5,"\u002Fagents\u002Fexport-and-import-agents",[172,173,731],"agents\u002Flocal-agents-vs-cloud-agents",{"title":543,"description":726},"export-and-import-agents","help\u002Fagents\u002F05.export-and-import-agents","lmGRhTMB2C3q3aIuw0yLuhKWaApryrf-zoeKaR2KKuk","Export and import agents Save an agent to a file and load it on another machine or share it with a teammate — takes about a minute.",{"id":738,"title":739,"body":740,"category":163,"description":897,"draft":165,"extension":166,"meta":898,"navigation":168,"order":899,"path":900,"relatedArticles":901,"seo":903,"slug":904,"stem":905,"updatedAt":178,"__hash__":906,"excerpt":897,"searchText":907},"help\u002Fhelp\u002Fagents\u002F06.control-who-can-use-your-agents.md","Control who can use your agents",{"type":8,"value":741,"toc":892},[742,745,748,751,754,757,760,844,854,861,865,871,878,889],[11,743,744],{},"Who can use an agent depends on where the agent lives. Local agents are private to the machine they're on. Cloud agents belong to a workspace and follow workspace roles.",[18,746,452],{"id":747},"local-agents",[11,749,750],{},"A local agent is only accessible on the machine where it was created. If you log in from a different device, your local agents won't appear there. No other workspace member can access a local agent through MultiClaw. To protect local agent data at the OS level, secure your device with a strong login password and full-disk encryption.",[11,752,753],{},"Use local agents for personal tasks you don't need to share.",[18,755,455],{"id":756},"cloud-agents",[11,758,759],{},"Cloud agents are shared across your workspace and synced to all devices. Access is controlled by workspace roles, not by individual agent settings.",[61,761,762,782],{},[64,763,764],{},[67,765,766,769,773,776,779],{},[70,767,768],{},"Role",[70,770,772],{"align":771},"center","Create agents",[70,774,775],{"align":771},"Edit agents",[70,777,778],{"align":771},"Delete agents",[70,780,781],{"align":771},"Chat with agents",[79,783,784,799,814,829],{},[67,785,786,791,793,795,797],{},[84,787,788],{},[45,789,790],{},"Owner",[84,792,125],{"align":771},[84,794,125],{"align":771},[84,796,125],{"align":771},[84,798,125],{"align":771},[67,800,801,806,808,810,812],{},[84,802,803],{},[45,804,805],{},"Admin",[84,807,125],{"align":771},[84,809,125],{"align":771},[84,811,125],{"align":771},[84,813,125],{"align":771},[67,815,816,821,823,825,827],{},[84,817,818],{},[45,819,820],{},"Member",[84,822,122],{"align":771},[84,824,122],{"align":771},[84,826,122],{"align":771},[84,828,125],{"align":771},[67,830,831,836,838,840,842],{},[84,832,833],{},[45,834,835],{},"Viewer",[84,837,122],{"align":771},[84,839,122],{"align":771},[84,841,122],{"align":771},[84,843,122],{"align":771},[11,845,846,847,849,850,853],{},"Workspace owners and admins manage roles in ",[45,848,99],{}," under ",[45,851,852],{},"Settings → Members",". There is no per-agent permission system — access is workspace-role-based.",[50,855,856],{"type":52},[11,857,858,859,214],{},"To allow a member to create or edit agents, promote them to ",[45,860,805],{},[18,862,864],{"id":863},"set-guardrails-for-everyone","Set guardrails for everyone",[11,866,867,870],{},[45,868,869],{},"Guardrails"," are restrictions that apply to all agents in your workspace, regardless of who runs them. They are the workspace owner's mechanism for enforcing policy at the organization level.",[11,872,873,874,877],{},"Configure guardrails in ",[45,875,876],{},"MultiClaw Cloud → Settings → Guardrails",". Examples of what guardrails can enforce:",[23,879,880,883,886],{},[26,881,882],{},"Require approval before an agent sends any external message",[26,884,885],{},"Block agents from accessing specific domains or file paths",[26,887,888],{},"Limit agents to read-only actions in certain tools",[11,890,891],{},"Guardrails cannot be overridden by individual agents or by members. If an agent's plan is blocked by a guardrail, the agent will note this in the conversation and will typically identify which rule applied. For a full audit of guardrail enforcement, review activity logs in MultiClaw Cloud.",{"title":157,"searchDepth":158,"depth":158,"links":893},[894,895,896],{"id":747,"depth":158,"text":452},{"id":756,"depth":158,"text":455},{"id":863,"depth":158,"text":864},"Understand how agent access works for local and cloud agents, and how workspace guardrails limit what all agents can do.",{},6,"\u002Fagents\u002Fcontrol-who-can-use-your-agents",[288,731,902],"team-governance\u002Fset-up-agent-guardrails",{"title":739,"description":897},"control-who-can-use-your-agents","help\u002Fagents\u002F06.control-who-can-use-your-agents","mkGaOI3456cX-1X23sTfiLlL5PtELomLKIcdA7u1X3s","Control who can use your agents Understand how agent access works for local and cloud agents, and how workspace guardrails limit what all agents can do.",1778463882978]