[{"data":1,"prerenderedAt":786},["ShallowReactive",2],{"help-category-\u002Fconversations":3,"help-article-\u002Fconversations":260},[4,263,354,509],{"id":5,"title":6,"body":7,"category":246,"description":247,"draft":248,"extension":249,"meta":250,"navigation":251,"order":252,"path":253,"relatedArticles":254,"seo":258,"slug":64,"stem":259,"updatedAt":260,"__hash__":261,"excerpt":247,"searchText":262},"help\u002Fhelp\u002Fconversations\u002F01.start-a-conversation.md","Start a conversation",{"type":8,"value":9,"toc":232},"minimark",[10,19,24,37,41,52,55,62,65,68,93,98,104,108,118,125,132,136,147,155,159,166,172,197,207,211,226],[11,12,13,14,18],"p",{},"The ",[15,16,17],"strong",{},"Conversations"," screen is your main working area in MultiClaw. Every chat with an agent — new and past — lives here. The layout adapts as you work: a welcoming start screen when no conversation is active, and a focused message thread once the first message is sent.",[20,21,23],"h2",{"id":22},"before-you-start","Before you start",[11,25,26,27,30,31,36],{},"Your gateway must be running before agents can respond. Check the ",[15,28,29],{},"gateway status indicator"," in the top-right corner of the app — it should be green. If it shows red, ",[32,33,35],"a",{"href":34},"\u002Fgetting-started\u002Fconnect-to-your-workspace","connect to your workspace"," first.",[20,38,40],{"id":39},"the-welcome-screen","The welcome screen",[11,42,43,44,47,48,51],{},"When no conversation is active, the screen shows the greeting ",[15,45,46],{},"\"What can I help you build today?\""," The composer appears centered below it — this is the ",[15,49,50],{},"welcome phase",".",[11,53,54],{},"Once you send your first message, the layout shifts: the composer moves to the bottom of the screen and the conversation thread fills the space above it.",[11,56,57],{},[58,59],"img",{"alt":60,"src":61},"Sending your first message — type in the composer and the agent responds in real time","\u002Fimages\u002Fdemos\u002Fsend-first-message.gif",[20,63,6],{"id":64},"start-a-conversation",[11,66,67],{},"You can start a new conversation in three ways:",[69,70,71,79,90],"ul",{},[72,73,74,75,78],"li",{},"Click the ",[15,76,77],{},"pencil icon"," at the top-left of the chat area.",[72,80,81,82,85,86,89],{},"Press ",[15,83,84],{},"Cmd+N"," (Mac) or ",[15,87,88],{},"Ctrl+N"," (Windows\u002FLinux).",[72,91,92],{},"If you're already on the welcome screen, type directly in the composer — no extra step needed.",[94,95,97],"h3",{"id":96},"pick-an-agent","Pick an agent",[11,99,13,100,103],{},[15,101,102],{},"agent selector"," is embedded in the bottom toolbar of the composer. It shows the currently selected agent's name and emoji. Click it to open a searchable list of your agents and select a different one.",[94,105,107],{"id":106},"send-your-message","Send your message",[11,109,110,111,114,115,51],{},"Type in the composer and press ",[15,112,113],{},"Enter"," to send. To insert a line break without sending, press ",[15,116,117],{},"Shift+Enter",[11,119,120,121,124],{},"While the agent is responding, a ",[15,122,123],{},"Stop generating"," button appears in the composer — click it to cancel the response at any time.",[126,127,129],"callout",{"type":128},"tip",[11,130,131],{},"You can have multiple conversations with the same agent. Each is a separate thread with its own history. The agent does not carry memory between threads unless you include context in your message.",[20,133,135],{"id":134},"agent-locking","Agent locking",[11,137,138,139,142,143],{},"Once you send the first message, the agent selector ",[15,140,141],{},"locks"," for that conversation. The agent name is shown with a lock icon, and hovering it displays: ",[144,145,146],"em",{},"\"Agents can't be changed mid-conversation. Start a new chat to use a different agent.\"",[11,148,149,150,152,153,51],{},"To switch agents, start a new conversation using the compose icon or ",[15,151,84],{}," \u002F ",[15,154,88],{},[20,156,158],{"id":157},"continue-a-past-conversation","Continue a past conversation",[11,160,161,162,165],{},"Your previous conversations are saved in the ",[15,163,164],{},"Chats"," sidebar, which starts collapsed by default.",[11,167,168],{},[58,169],{"alt":170,"src":171},"Opening the Chats sidebar to browse and select a past conversation","\u002Fimages\u002Fdemos\u002Fopen-chat-sidebar.gif",[173,174,175,184,187,194],"ol",{},[72,176,74,177,180,181,183],{},[15,178,179],{},"sidebar toggle"," button (panel icon) at the top-left of the chat area to reveal the ",[15,182,164],{}," sidebar.",[72,185,186],{},"Browse your conversations — each entry shows the title and a preview of the last message, sorted by most recent.",[72,188,189,190,193],{},"Use the ",[15,191,192],{},"Search conversations..."," field to filter by keyword.",[72,195,196],{},"Click a conversation to open it. The agent selector locks to the agent used in that session, and the composer moves to the bottom of the screen.",[11,198,199,200,203,204],{},"If you have no past conversations, the sidebar shows ",[15,201,202],{},"\"No conversations yet.\""," If a search returns no matches, it shows ",[15,205,206],{},"\"No conversations match your search.\"",[20,208,210],{"id":209},"rename-or-delete-a-conversation","Rename or delete a conversation",[11,212,213,214,217,218,221,222,225],{},"With a conversation open, click the ",[15,215,216],{},"more options"," button (three-dot icon) at the top-right of the chat area. From there you can choose ",[15,219,220],{},"Rename"," to give the conversation a new title, or ",[15,223,224],{},"Delete"," to remove it.",[126,227,229],{"type":228},"warning",[11,230,231],{},"Deleting a conversation is permanent. There is no way to recover a deleted conversation.",{"title":233,"searchDepth":234,"depth":234,"links":235},"",2,[236,237,238,243,244,245],{"id":22,"depth":234,"text":23},{"id":39,"depth":234,"text":40},{"id":64,"depth":234,"text":6,"children":239},[240,242],{"id":96,"depth":241,"text":97},3,{"id":106,"depth":241,"text":107},{"id":134,"depth":234,"text":135},{"id":157,"depth":234,"text":158},{"id":209,"depth":234,"text":210},"conversations","Open the Conversations screen, start a new chat from the welcome greeting, pick an agent inline, and continue past sessions from the sidebar.",false,"md",{},true,1,"\u002Fconversations\u002Fstart-a-conversation",[255,256,257],"conversations\u002Fquick-chat-vs-tasks","conversations\u002Fconversation-history","getting-started\u002Fstart-your-first-conversation",{"title":6,"description":247},"help\u002Fconversations\u002F01.start-a-conversation",null,"bXvccRACPHxntZcf-llSeQZ7fzFtsAQl7B3OTnIpyl0","Start a conversation Open the Conversations screen, start a new chat from the welcome greeting, pick an agent inline, and continue past sessions from the sidebar.",{"id":264,"title":265,"body":266,"category":246,"description":344,"draft":248,"extension":249,"meta":345,"navigation":251,"order":234,"path":346,"relatedArticles":347,"seo":350,"slug":273,"stem":351,"updatedAt":260,"__hash__":352,"excerpt":344,"searchText":353},"help\u002Fhelp\u002Fconversations\u002F02.quick-chat-vs-tasks.md","Quick chat vs tasks",{"type":8,"value":267,"toc":340},[268,271,274,322,328,332,335],[11,269,270],{},"When you send a message, the agent responds in one of two ways: it either replies conversationally — answering questions, brainstorming, summarising — or it begins taking action on your behalf. The difference comes down to whether you asked a question or asked the agent to act.",[20,272,265],{"id":273},"quick-chat-vs-tasks",[275,276,277,292],"table",{},[278,279,280],"thead",{},[281,282,283,286,289],"tr",{},[284,285],"th",{},[284,287,288],{},"Quick chat",[284,290,291],{},"Tasks",[293,294,295,309],"tbody",{},[281,296,297,303,306],{},[298,299,300],"td",{},[15,301,302],{},"Purpose",[298,304,305],{},"Questions, brainstorming, summaries, discussion",[298,307,308],{},"Taking action — browsing, file management, sending messages, running a workflow",[281,310,311,316,319],{},[298,312,313],{},[15,314,315],{},"When to use",[298,317,318],{},"You want an answer or want to think something through",[298,320,321],{},"You want the agent to take action on your behalf",[11,323,324],{},[58,325],{"alt":326,"src":327},"Quick chat exchange — the agent provides a conversational answer to a question","\u002Fimages\u002Fdemos\u002Fquick-chat-reply.gif",[20,329,331],{"id":330},"how-the-agent-decides","How the agent decides",[11,333,334],{},"The agent reads your message and determines whether you want a conversational reply or action. A question like \"What's a good subject line for this email?\" gets a direct reply. A request like \"Find all invoices from last quarter\" will have the agent start working through the task.",[126,336,337],{"type":128},[11,338,339],{},"If you want action, make sure your message clearly describes what you want done. If the agent responds conversationally to an action request, rephrase your message more explicitly.",{"title":233,"searchDepth":234,"depth":234,"links":341},[342,343],{"id":273,"depth":234,"text":265},{"id":330,"depth":234,"text":331},"Understand when the agent replies conversationally and when it takes action on your behalf.",{},"\u002Fconversations\u002Fquick-chat-vs-tasks",[348,256,349],"conversations\u002Fstart-a-conversation","agents\u002Fwhat-are-agents",{"title":265,"description":344},"help\u002Fconversations\u002F02.quick-chat-vs-tasks","vLX2DOxFmzgI7nSgS2v5cbu1_frzRCN5H3SLkPCziaA","Quick chat vs tasks Understand when the agent replies conversationally and when it takes action on your behalf.",{"id":355,"title":356,"body":357,"category":246,"description":498,"draft":248,"extension":249,"meta":499,"navigation":251,"order":500,"path":501,"relatedArticles":502,"seo":504,"slug":505,"stem":506,"updatedAt":260,"__hash__":507,"excerpt":498,"searchText":508},"help\u002Fhelp\u002Fconversations\u002F04.conversation-history.md","Conversation history",{"type":8,"value":358,"toc":492},[359,362,366,371,388,393,397,400,403,434,443,447,467,472,476,485],[11,360,361],{},"Every conversation you have with an agent is saved automatically. You can return to any past conversation and delete or export individual threads whenever you need to.",[20,363,365],{"id":364},"find-a-past-conversation","Find a past conversation",[11,367,368],{},[58,369],{"alt":370,"src":171},"Opening the sidebar to find and select a past conversation",[173,372,373,379,382,385],{},[72,374,375,376,378],{},"Open the ",[15,377,17],{}," screen.",[72,380,381],{},"Look at the left panel — your conversations are listed there, sorted by most recent at the top.",[72,383,384],{},"Each entry shows the conversation title and a snippet of the last message.",[72,386,387],{},"Click any entry to open it in the chat area.",[126,389,390],{"type":128},[11,391,392],{},"Agents do not carry memory between separate conversation threads. If you need the agent to remember context from a previous chat, copy the relevant details into your new message.",[20,394,396],{"id":395},"how-long-conversations-are-kept","How long conversations are kept",[11,398,399],{},"Conversations are stored until you delete them. There is no automatic expiry.",[11,401,402],{},"Where conversations are stored depends on how you use MultiClaw:",[69,404,405,424],{},[72,406,407,410,411,415,416,419,420,423],{},[15,408,409],{},"Local mode"," — stored as ",[412,413,414],"code",{},".jsonl"," files in ",[412,417,418],{},"~\u002F.openclaw\u002F"," on your Mac or Linux machine, or ",[412,421,422],{},"%APPDATA%\\openclaw\\"," on Windows.",[72,425,426,429,430,51],{},[15,427,428],{},"Cloud mode"," — stored on your cloud desktop instance hosted on AWS. Retention and deletion for cloud conversations follows our ",[32,431,433],{"href":432},"\u002Fhelp\u002Flegal-compliance\u002Fprivacy-policy","Privacy Policy",[126,435,437],{"type":436},"note",[11,438,439,440,442],{},"Cloud conversations are stored on your cloud desktop instance hosted by MultiClaw on AWS infrastructure. See our ",[32,441,433],{"href":432}," for information on data location, access controls, and your rights under applicable data protection law.",[20,444,446],{"id":445},"delete-a-conversation","Delete a conversation",[173,448,449,452,458,464],{},[72,450,451],{},"Open the conversation in the chat area.",[72,453,74,454,457],{},[15,455,456],{},"⋯"," menu in the top-right corner of the chat area.",[72,459,460,461,51],{},"Select ",[15,462,463],{},"Delete conversation",[72,465,466],{},"Confirm when prompted.",[11,468,469,470,51],{},"Deletion removes the conversation from your list. For cloud mode, deleted conversations are handled in accordance with our ",[32,471,433],{"href":432},[20,473,475],{"id":474},"export-conversations","Export conversations",[11,477,478,479,481,482,484],{},"Conversations are stored as plain ",[412,480,414],{}," files — one file per thread. To export in local mode, locate the file in ",[412,483,418],{}," and copy it to wherever you want to keep it.",[11,486,487,488,51],{},"For cloud mode conversation data or to exercise your data portability rights under applicable law, email ",[32,489,491],{"href":490},"mailto:privacy@multiclaw.io","privacy@multiclaw.io",{"title":233,"searchDepth":234,"depth":234,"links":493},[494,495,496,497],{"id":364,"depth":234,"text":365},{"id":395,"depth":234,"text":396},{"id":445,"depth":234,"text":446},{"id":474,"depth":234,"text":475},"All your past conversations are stored in the left panel — you can delete and export them at any time.",{},4,"\u002Fconversations\u002Fconversation-history",[348,503],"conversations\u002Fsend-attachments-and-context",{"title":356,"description":498},"conversation-history","help\u002Fconversations\u002F04.conversation-history","F2uI05QCM20crppam_e1n08f3JhHJ5JJBBP82SIgphw","Conversation history All your past conversations are stored in the left panel — you can delete and export them at any time.",{"id":510,"title":511,"body":512,"category":246,"description":776,"draft":248,"extension":249,"meta":777,"navigation":251,"order":778,"path":779,"relatedArticles":780,"seo":781,"slug":782,"stem":783,"updatedAt":260,"__hash__":784,"excerpt":776,"searchText":785},"help\u002Fhelp\u002Fconversations\u002F05.send-attachments-and-context.md","Send attachments and context",{"type":8,"value":513,"toc":770},[514,517,522,526,532,539,559,566,576,580,707,712,717,721,728,733,740,744,747,767],[11,515,516],{},"You can attach files to any message in MultiClaw. The agent reads the file content as part of your message, so it has the context it needs to help you accurately.",[126,518,519],{"type":436},[11,520,521],{},"File content you attach is sent to the AI model configured for your agent — which may be hosted by a third-party provider such as OpenAI or Anthropic — to generate a response. Do not attach files containing sensitive personal data unless you have reviewed your agent's model configuration and confirmed this is appropriate.",[20,523,525],{"id":524},"attach-a-file","Attach a file",[11,527,528],{},[58,529],{"alt":530,"src":531},"Attaching files to a message — file chips appear above the composer before you send","\u002Fimages\u002Fdemos\u002Fsend-with-attachment.gif",[11,533,534,535,538],{},"When chatting with a ",[15,536,537],{},"local agent"," (connected to your local OpenClaw installation), there are three ways to attach files:",[69,540,541,547,553],{},[72,542,543,546],{},[15,544,545],{},"Paperclip button"," — click the attachment icon in the composer and select one or more files from the file picker.",[72,548,549,552],{},[15,550,551],{},"Drag and drop"," — drag files directly onto the composer area and release.",[72,554,555,558],{},[15,556,557],{},"Paste an image"," — paste a screenshot or copied image from your clipboard directly into the composer (images only; 10 MB limit per pasted image).",[11,560,561,562,565],{},"When chatting with an agent on a ",[15,563,564],{},"cloud desktop",", only the paperclip button is available.",[11,567,568,569,571,572,575],{},"After attaching, files appear above the composer. Add your message if you haven't already, then press ",[15,570,113],{}," or click ",[15,573,574],{},"Send",". The agent receives your message and the file content together.",[20,577,579],{"id":578},"supported-file-types","Supported file types",[275,581,582,592],{},[278,583,584],{},[281,585,586,589],{},[284,587,588],{},"Type",[284,590,591],{},"Extensions",[293,593,594,611,633,679],{},[281,595,596,599],{},[298,597,598],{},"Plain text",[298,600,601,604,605,604,608],{},[412,602,603],{},".txt",", ",[412,606,607],{},".md",[412,609,610],{},".csv",[281,612,613,616],{},[298,614,615],{},"Images",[298,617,618,604,621,604,624,604,627,604,630],{},[412,619,620],{},".jpg",[412,622,623],{},".jpeg",[412,625,626],{},".png",[412,628,629],{},".gif",[412,631,632],{},".webp",[281,634,635,638],{},[298,636,637],{},"Code",[298,639,640,604,643,604,646,604,649,604,652,604,655,604,658,604,661,604,664,604,667,604,670,604,673,604,676],{},[412,641,642],{},".js",[412,644,645],{},".ts",[412,647,648],{},".tsx",[412,650,651],{},".jsx",[412,653,654],{},".py",[412,656,657],{},".rs",[412,659,660],{},".go",[412,662,663],{},".java",[412,665,666],{},".rb",[412,668,669],{},".c",[412,671,672],{},".cpp",[412,674,675],{},".h",[412,677,678],{},".sh",[281,680,681,684],{},[298,682,683],{},"Config and markup",[298,685,686,604,689,604,692,604,695,604,698,604,701,604,704],{},[412,687,688],{},".json",[412,690,691],{},".yaml",[412,693,694],{},".yml",[412,696,697],{},".toml",[412,699,700],{},".xml",[412,702,703],{},".html",[412,705,706],{},".css",[126,708,709],{"type":436},[11,710,711],{},"PDF files are not currently supported.",[126,713,714],{"type":436},[11,715,716],{},"Image analysis depends on the AI model configured for your agent. If your model does not support vision, the agent will not be able to describe or interpret image content. When chatting with a local agent, a warning appears in the composer if your model may lack image support.",[20,718,720],{"id":719},"context-window-limits","Context window limits",[11,722,723,724,727],{},"Every AI model has a ",[15,725,726],{},"context window"," — the total amount of text it can process at once. This includes your conversation history, your current message, and any files you attach.",[126,729,730],{"type":228},[11,731,732],{},"If the combined size of your conversation and attachments exceeds the model's context window, the agent will notify you. It cannot process the request until the context fits within the limit. This is a constraint of the underlying AI model, not MultiClaw itself.",[11,734,735,736,739],{},"When pasting an image from your clipboard, the maximum size is ",[15,737,738],{},"10 MB per image",". Files attached via the file picker or drag and drop do not have an enforced size limit in the app, though very large files may still exceed your model's context window.",[20,741,743],{"id":742},"tips-for-large-files","Tips for large files",[11,745,746],{},"If a file is too large to attach in full, try these approaches:",[69,748,749,755,761],{},[72,750,751,754],{},[15,752,753],{},"Paste a relevant excerpt"," instead of the whole file — copy the section the agent needs and include it directly in your message.",[72,756,757,760],{},[15,758,759],{},"Break it into parts"," — send the file in sections across multiple messages.",[72,762,763,766],{},[15,764,765],{},"Summarize first"," — ask the agent to work with a short description of the file's contents, then send specific sections as needed.",[11,768,769],{},"For large codebases, attaching an entire project will almost always exceed context limits. Identify the specific files or functions relevant to your question and attach only those.",{"title":233,"searchDepth":234,"depth":234,"links":771},[772,773,774,775],{"id":524,"depth":234,"text":525},{"id":578,"depth":234,"text":579},{"id":719,"depth":234,"text":720},{"id":742,"depth":234,"text":743},"Attach files to any message so the agent has the context it needs — supported types include text, images, and code files.",{},5,"\u002Fconversations\u002Fsend-attachments-and-context",[348,255,256],{"title":511,"description":776},"send-attachments-and-context","help\u002Fconversations\u002F05.send-attachments-and-context","8kSgVP3Xw3WpCNO-JcFTm_c-SrVPMZsIQiX0gFFbfVM","Send attachments and context Attach files to any message so the agent has the context it needs — supported types include text, images, and code files.",1778463882978]