[{"data":1,"prerenderedAt":605},["ShallowReactive",2],{"help-category-\u002Fagents\u002Fcreate-an-agent":3,"help-article-\u002Fagents\u002Fcreate-an-agent":4,"related-articles-\u002Fagents\u002Fcreate-an-agent":131},[],{"id":5,"title":6,"body":7,"category":115,"description":116,"draft":117,"extension":118,"meta":119,"navigation":120,"order":111,"path":121,"relatedArticles":122,"seo":126,"slug":26,"stem":127,"updatedAt":128,"__hash__":129,"excerpt":116,"searchText":130},"help\u002Fhelp\u002Fagents\u002F02.create-an-agent.md","Create an agent",{"type":8,"value":9,"toc":109},"minimark",[10,23,27,69,72,76,79],[11,12,13,14,18,19,22],"p",{},"Creating an agent takes about two minutes. Open ",[15,16,17],"strong",{},"My Agents",", click ",[15,20,21],{},"Create Agent",", and the wizard walks you through four steps. Your agent is available to chat the moment you finish.",[24,25,6],"h2",{"id":26},"create-an-agent",[28,29,30,37,43,55,61],"ol",{},[31,32,33,34,36],"li",{},"Open ",[15,35,17],{}," from the left navigation.",[31,38,39,40,42],{},"Click ",[15,41,21],{},".",[31,44,45,48,49,54],{},[15,46,47],{},"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, ",[50,51,53],"a",{"href":52},"\u002Fhelp\u002Ftools-integrations\u002Fset-up-your-ai-model","add an LLM provider"," first.",[31,56,57,60],{},[15,58,59],{},"Personality"," — type a system prompt that describes how the agent should behave. This step is optional but recommended.",[31,62,63,66,67,42],{},[15,64,65],{},"Review"," — confirm your settings, then click ",[15,68,21],{},[11,70,71],{},"Your new agent appears in the list immediately.",[24,73,75],{"id":74},"write-an-effective-personality","Write an effective personality",[11,77,78],{},"The personality is a free-text system prompt — plain English instructions that shape how the agent thinks and responds.",[80,81,82,88,93,98,104],"ul",{},[31,83,84,87],{},[15,85,86],{},"Do"," be specific about role and expertise: \"You are a senior financial analyst who writes concise reports.\"",[31,89,90,92],{},[15,91,86],{}," include output preferences: \"Always structure answers with a summary first, then detail.\"",[31,94,95,97],{},[15,96,86],{}," set constraints: \"Never make assumptions about deadlines — always ask if the timeline isn't clear.\"",[31,99,100,103],{},[15,101,102],{},"Don't"," write a wall of instructions. Three to six focused sentences outperform twenty vague ones.",[31,105,106,108],{},[15,107,102],{}," include task-specific content — personalities set behavior, not individual job instructions.",{"title":110,"searchDepth":111,"depth":111,"links":112},"",2,[113,114],{"id":26,"depth":111,"text":6},{"id":74,"depth":111,"text":75},"agents","Build a new agent in minutes using the creation wizard — choose a name, model, personality, and tools.",false,"md",{},true,"\u002Fagents\u002Fcreate-an-agent",[123,124,125],"agents\u002Fwhat-are-agents","agents\u002Fset-up-an-agent-profile","agents\u002Fexport-and-import-agents",{"title":6,"description":116},"help\u002Fagents\u002F02.create-an-agent",null,"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.",[132,295,426],{"id":133,"title":134,"body":135,"category":115,"description":283,"draft":117,"extension":118,"meta":284,"navigation":120,"order":285,"path":286,"relatedArticles":287,"seo":290,"slug":291,"stem":292,"updatedAt":128,"__hash__":293,"excerpt":283,"searchText":294},"help\u002Fhelp\u002Fagents\u002F01.what-are-agents.md","What are agents?",{"type":8,"value":136,"toc":278},[137,140,143,147,171,178,182,261,264,268,275],[11,138,139],{},"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,141,142],{},"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.",[24,144,146],{"id":145},"what-agents-can-do","What agents can do",[80,148,149,152,155,158,161,164],{},[31,150,151],{},"Answer questions and hold conversations",[31,153,154],{},"Draft step-by-step plans for tasks and wait for your approval",[31,156,157],{},"Execute tasks on a cloud desktop — browsing the web, filling forms, editing files",[31,159,160],{},"Use MCP tools to connect to apps like GitHub, Slack, Google Drive, and others",[31,162,163],{},"Run recorded browser workflows and reusable skills — each run is subject to your approval before execution",[31,165,166,167,170],{},"Delegate subtasks to other agents (",[15,168,169],{},"subagents",") — delegation is included in the plan you approve before execution begins",[172,173,175],"callout",{"type":174},"note",[11,176,177],{},"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.",[24,179,181],{"id":180},"local-agents-vs-cloud-agents","Local agents vs cloud agents",[183,184,185,200],"table",{},[186,187,188],"thead",{},[189,190,191,194,197],"tr",{},[192,193],"th",{},[192,195,196],{},"Local agent",[192,198,199],{},"Cloud agent",[201,202,203,222,235,248],"tbody",{},[189,204,205,211,219],{},[206,207,208],"td",{},[15,209,210],{},"Where stored",[206,212,213,214,218],{},"Your machine (",[215,216,217],"code",{},"~\u002F.openclaw\u002F",")",[206,220,221],{},"MultiClaw Cloud",[189,223,224,229,232],{},[206,225,226],{},[15,227,228],{},"Who can access it",[206,230,231],{},"Only you, on that device",[206,233,234],{},"Any workspace member with permission",[189,236,237,242,245],{},[206,238,239],{},[15,240,241],{},"Syncs across devices",[206,243,244],{},"No",[206,246,247],{},"Yes",[189,249,250,255,258],{},[206,251,252],{},[15,253,254],{},"Runs 24\u002F7",[206,256,257],{},"Only while your machine is on",[206,259,260],{},"Yes, on a cloud desktop",[11,262,263],{},"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.",[24,265,267],{"id":266},"agent-personalities","Agent personalities",[11,269,270,271,274],{},"Every agent has a ",[15,272,273],{},"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,276,277],{},"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":110,"searchDepth":111,"depth":111,"links":279},[280,281,282],{"id":145,"depth":111,"text":146},{"id":180,"depth":111,"text":181},{"id":266,"depth":111,"text":267},"Agents are AI assistants that plan, act, and complete tasks on your behalf — here's what they can do and how they work.",{},1,"\u002Fagents\u002Fwhat-are-agents",[288,124,289],"agents\u002Fcreate-an-agent","conversations\u002Freview-plans-and-approvals",{"title":134,"description":283},"what-are-agents","help\u002Fagents\u002F01.what-are-agents","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":296,"title":297,"body":298,"category":115,"description":415,"draft":117,"extension":118,"meta":416,"navigation":120,"order":417,"path":418,"relatedArticles":419,"seo":421,"slug":422,"stem":423,"updatedAt":128,"__hash__":424,"excerpt":415,"searchText":425},"help\u002Fhelp\u002Fagents\u002F03.set-up-an-agent-profile.md","Set up an agent profile",{"type":8,"value":299,"toc":409},[300,306,328,332,342,346,351,354,368,371,375,380,387,392,396,401],[11,301,302,303,305],{},"The agent profile page is where you configure everything about an agent after it's created. Open it by going to ",[15,304,17],{}," and selecting any agent from the list.",[11,307,308,309,312,313,312,315,312,318,312,321,324,325,42],{},"The profile is organized into tabs: ",[15,310,311],{},"Profile",", ",[15,314,59],{},[15,316,317],{},"Your Human",[15,319,320],{},"Subagents",[15,322,323],{},"Conversations",", and ",[15,326,327],{},"Danger",[24,329,331],{"id":330},"profile-tab","Profile tab",[11,333,334,335,337,338,341],{},"The ",[15,336,311],{}," tab contains the agent's identity — its display name, emoji, role, and vibe. Edit any of these fields and click ",[15,339,340],{},"Save"," to apply changes. The description is optional but helps you and your teammates understand what the agent is for.",[24,343,345],{"id":344},"personality-tab","Personality tab",[11,347,334,348,350],{},[15,349,59],{}," tab holds the agent's system prompt — the instructions that define how it thinks and behaves.",[11,352,353],{},"Write the personality in plain English. A few tips:",[80,355,356,359,362,365],{},[31,357,358],{},"Start with a role: \"You are a customer support specialist for a SaaS company.\"",[31,360,361],{},"Add behavioral rules: \"Always confirm what the user wants before taking any action.\"",[31,363,364],{},"Keep it focused. Six sharp sentences are more effective than thirty vague ones.",[31,366,367],{},"Avoid putting task-specific content here — personalities define behavior, not individual jobs.",[11,369,370],{},"Changes to personality apply to new conversations immediately. Existing conversations retain the personality they started with.",[24,372,374],{"id":373},"subagents-tab","Subagents tab",[11,376,334,377,379],{},[15,378,320],{}," 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,381,382,383,386],{},"Add a subagent by clicking ",[15,384,385],{},"Add subagent"," and selecting from the list. Remove one by clicking the remove icon next to its name.",[172,388,389],{"type":174},[11,390,391],{},"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.",[24,393,395],{"id":394},"delete-an-agent","Delete an agent",[11,397,334,398,400],{},[15,399,327],{}," tab contains the option to delete the agent. The agent is permanently removed from your workspace and cannot be recovered through the app.",[11,402,403,404,408],{},"Before deleting, consider ",[50,405,407],{"href":406},"\u002Fhelp\u002Fagents\u002Fexport-and-import-agents","exporting the agent"," as a backup.",{"title":110,"searchDepth":111,"depth":111,"links":410},[411,412,413,414],{"id":330,"depth":111,"text":331},{"id":344,"depth":111,"text":345},{"id":373,"depth":111,"text":374},{"id":394,"depth":111,"text":395},"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",[123,288,420],"agents\u002Fcontrol-who-can-use-your-agents",{"title":297,"description":415},"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":427,"title":428,"body":429,"category":115,"description":594,"draft":117,"extension":118,"meta":595,"navigation":120,"order":596,"path":597,"relatedArticles":598,"seo":600,"slug":601,"stem":602,"updatedAt":128,"__hash__":603,"excerpt":594,"searchText":604},"help\u002Fhelp\u002Fagents\u002F05.export-and-import-agents.md","Export and import agents",{"type":8,"value":430,"toc":587},[431,434,438,454,458,490,494,540,545,549,563,567,576],[11,432,433],{},"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.",[24,435,437],{"id":436},"export-an-agent","Export an agent",[28,439,440,445,451],{},[31,441,33,442,444],{},[15,443,17],{}," and select the agent you want to export.",[31,446,39,447,450],{},[15,448,449],{},"Export"," in the agent detail view.",[31,452,453],{},"Choose a location to save the file.",[24,455,457],{"id":456},"import-an-agent","Import an agent",[28,459,460,464,470,473,484],{},[31,461,33,462,42],{},[15,463,17],{},[31,465,39,466,469],{},[15,467,468],{},"Import Agent"," at the top of the screen.",[31,471,472],{},"Select the exported file using the file picker.",[31,474,475,476,479,480,483],{},"If an agent with the same name already exists, a dialog appears. Either edit the pre-filled name in the ",[15,477,478],{},"New name"," field to keep both agents, or check ",[15,481,482],{},"Overwrite existing agent"," to replace it.",[31,485,39,486,489],{},[15,487,488],{},"Import"," to confirm. The agent appears in your list immediately.",[24,491,493],{"id":492},"what-the-file-contains","What the file contains",[183,495,496,506],{},[186,497,498],{},[189,499,500,503],{},[192,501,502],{},"Included",[192,504,505],{},"Not included",[201,507,508,516,524,532],{},[189,509,510,513],{},[206,511,512],{},"Agent name",[206,514,515],{},"Conversation history",[189,517,518,521],{},[206,519,520],{},"Description",[206,522,523],{},"Approval records",[189,525,526,529],{},[206,527,528],{},"Personality (system prompt)",[206,530,531],{},"Audit trail",[189,533,534,537],{},[206,535,536],{},"AI model selection",[206,538,539],{},"Usage statistics",[172,541,542],{"type":174},[11,543,544],{},"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.",[24,546,548],{"id":547},"common-use-cases","Common use cases",[80,550,551,554,557,560],{},[31,552,553],{},"Moving an agent from your work machine to another device",[31,555,556],{},"Sharing a well-configured agent with a teammate",[31,558,559],{},"Backing up an agent before making significant changes to its personality or tools",[31,561,562],{},"Exporting as a starting point — import, then modify for a different use case",[24,564,566],{"id":565},"known-limitations","Known limitations",[172,568,570],{"type":569},"warning",[11,571,572,575],{},[15,573,574],{},"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.",[172,577,578],{"type":174},[11,579,580,583,584,586],{},[15,581,582],{},"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 ",[15,585,311],{}," tab after importing.",{"title":110,"searchDepth":111,"depth":111,"links":588},[589,590,591,592,593],{"id":436,"depth":111,"text":437},{"id":456,"depth":111,"text":457},{"id":492,"depth":111,"text":493},{"id":547,"depth":111,"text":548},{"id":565,"depth":111,"text":566},"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",[288,124,599],"agents\u002Flocal-agents-vs-cloud-agents",{"title":428,"description":594},"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.",1778463885885]