[{"data":1,"prerenderedAt":760},["ShallowReactive",2],{"docs-page-en-\u002Fmemos_cloud\u002Fgetting_started\u002Fagent_usage":3,"surround-en-\u002Fmemos_cloud\u002Fgetting_started\u002Fagent_usage":745},{"id":4,"title":5,"avatar":6,"banner":6,"body":7,"category":6,"desc":738,"description":13,"extension":739,"links":6,"meta":740,"navigation":6,"path":741,"seo":742,"stem":743,"__hash__":744},"docs\u002Fen\u002Fmemos_cloud\u002Fgetting_started\u002Fagent_usage.md","Use in Agents",null,{"type":8,"value":9,"toc":723},"minimark",[10,14,24,27,30,35,56,58,62,70,306,317,319,323,330,619,628,630,634,690,692,696,719],[11,12,13],"p",{},"In addition to calling the cloud APIs directly, you can connect MemOS to your AI workflow through plugins, MCP, and other integration methods if you use:",[15,16,17,21],"ul",{},[18,19,20],"li",{},"Agent frameworks such as OpenClaw and Hermes.",[18,22,23],{},"AI clients such as Cursor, VS Code, Claude Desktop, Cline, and Chatbox.",[11,25,26],{},"These integration methods help you save tokens while adding long-term memory to your Agent workflows.",[28,29],"br",{},[31,32,34],"h2",{"id":33},"_1-before-you-start","1. Before You Start",[15,36,37,48],{},[18,38,39,40,47],{},"Register and sign in to the ",[41,42,46],"a",{"href":43,"rel":44},"https:\u002F\u002Fmemos-dashboard.openmem.net\u002Fquickstart",[45],"nofollow","MemOS Cloud platform",".",[18,49,50,51,47],{},"Get an API Key from the ",[41,52,55],{"href":53,"rel":54},"https:\u002F\u002Fmemos-dashboard.openmem.net\u002Fapikeys",[45],"API Key page",[28,57],{},[31,59,61],{"id":60},"_2-use-the-plugin","2. Use the Plugin",[11,63,64,65,69],{},"MemOS currently provides a cloud plugin deeply integrated with ",[66,67,68],"strong",{},"OpenClaw",". If you use OpenClaw, prefer the plugin integration.",[71,72,74,79,87,103,106,151,155,184,191,291,295,298],"steps",{"level":73},"3",[75,76,78],"h3",{"id":77},"configure-the-api-key","Configure the API Key",[11,80,81,82,86],{},"The plugin reads OpenClaw-related environment variables or ",[83,84,85],"code",{},".env"," files. The minimal configuration is:",[88,89,94],"pre",{"className":90,"code":91,"language":92,"meta":93,"style":93},"language-env shiki shiki-themes material-theme-lighter github-light-high-contrast github-dark-default","MEMOS_API_KEY=YOUR_API_KEY\n","env","",[83,95,96],{"__ignoreMap":93},[97,98,101],"span",{"class":99,"line":100},"line",1,[97,102,91],{},[11,104,105],{},"You can also write it directly into the OpenClaw environment file:",[88,107,111],{"className":108,"code":109,"language":110,"meta":93,"style":93},"language-bash shiki shiki-themes material-theme-lighter github-light-high-contrast github-dark-default","mkdir -p ~\u002F.openclaw\necho 'MEMOS_API_KEY=YOUR_API_KEY' >> ~\u002F.openclaw\u002F.env\n","bash",[83,112,113,127],{"__ignoreMap":93},[97,114,115,119,123],{"class":99,"line":100},[97,116,118],{"class":117},"saonL","mkdir",[97,120,122],{"class":121},"sp2SP"," -p",[97,124,126],{"class":125},"sp1uZ"," ~\u002F.openclaw\n",[97,128,130,134,138,141,144,148],{"class":99,"line":129},2,[97,131,133],{"class":132},"svxCd","echo",[97,135,137],{"class":136},"sjUum"," '",[97,139,140],{"class":125},"MEMOS_API_KEY=YOUR_API_KEY",[97,142,143],{"class":136},"'",[97,145,147],{"class":146},"saN0X"," >>",[97,149,150],{"class":125}," ~\u002F.openclaw\u002F.env\n",[75,152,154],{"id":153},"install-and-enable-the-plugin","Install and enable the plugin",[88,156,158],{"className":108,"code":157,"language":110,"meta":93,"style":93},"openclaw plugins install @memtensor\u002Fmemos-cloud-openclaw-plugin@latest\nopenclaw gateway restart\n",[83,159,160,174],{"__ignoreMap":93},[97,161,162,165,168,171],{"class":99,"line":100},[97,163,164],{"class":117},"openclaw",[97,166,167],{"class":125}," plugins",[97,169,170],{"class":125}," install",[97,172,173],{"class":125}," @memtensor\u002Fmemos-cloud-openclaw-plugin@latest\n",[97,175,176,178,181],{"class":99,"line":129},[97,177,164],{"class":117},[97,179,180],{"class":125}," gateway",[97,182,183],{"class":125}," restart\n",[11,185,186,187,190],{},"Confirm that the plugin is enabled in ",[83,188,189],{},"~\u002F.openclaw\u002Fopenclaw.json",":",[88,192,196],{"className":193,"code":194,"language":195,"meta":93,"style":93},"language-json shiki shiki-themes material-theme-lighter github-light-high-contrast github-dark-default","{\n  \"plugins\": {\n    \"entries\": {\n      \"memos-cloud-openclaw-plugin\": { \"enabled\": true }\n    }\n  }\n}\n","json",[83,197,198,204,222,238,273,279,285],{"__ignoreMap":93},[97,199,200],{"class":99,"line":100},[97,201,203],{"class":202},"suWxN","{\n",[97,205,206,210,214,217,219],{"class":99,"line":129},[97,207,209],{"class":208},"sfJrv","  \"",[97,211,213],{"class":212},"skH7o","plugins",[97,215,216],{"class":208},"\"",[97,218,190],{"class":202},[97,220,221],{"class":202}," {\n",[97,223,225,228,232,234,236],{"class":99,"line":224},3,[97,226,227],{"class":208},"    \"",[97,229,231],{"class":230},"smon8","entries",[97,233,216],{"class":208},[97,235,190],{"class":202},[97,237,221],{"class":202},[97,239,241,244,248,250,252,255,258,262,264,266,270],{"class":99,"line":240},4,[97,242,243],{"class":208},"      \"",[97,245,247],{"class":246},"s_fzf","memos-cloud-openclaw-plugin",[97,249,216],{"class":208},[97,251,190],{"class":202},[97,253,254],{"class":202}," {",[97,256,257],{"class":208}," \"",[97,259,261],{"class":260},"sw4Oa","enabled",[97,263,216],{"class":208},[97,265,190],{"class":202},[97,267,269],{"class":268},"smHB8"," true",[97,271,272],{"class":202}," }\n",[97,274,276],{"class":99,"line":275},5,[97,277,278],{"class":202},"    }\n",[97,280,282],{"class":99,"line":281},6,[97,283,284],{"class":202},"  }\n",[97,286,288],{"class":99,"line":287},7,[97,289,290],{"class":202},"}\n",[75,292,294],{"id":293},"start-chatting","Start chatting",[11,296,297],{},"You can now have multi-turn conversations with OpenClaw:",[15,299,300,303],{},[18,301,302],{},"First session: \"I prefer using Python.\"",[18,304,305],{},"Second session after restart: \"Do you remember which programming language I like?\"",[307,308,309],"tip",{},[11,310,311,312,316],{},"The OpenClaw plugin also supports multi-Agent isolation, Config UI, filters, and more detailed configuration. See the ",[41,313,315],{"href":314},"\u002Fopenclaw\u002Fguide","OpenClaw Cloud Plugin"," for full configuration.",[28,318],{},[31,320,322],{"id":321},"_3-use-mcp","3. Use MCP",[11,324,325,326,329],{},"Mainstream clients that support MCP include ",[66,327,328],{},"Cursor, Claude Desktop, Cline, VS Code \u002F Trae, and Chatbox",". Taking Cursor as an example, after configuration, Cursor can directly call MemOS memory tools and use memory across clients.",[71,331,332,336,339,347,353,585,595,599,602,608,611],{"level":73},[75,333,335],{"id":334},"add-an-mcp-server","Add an MCP Server",[11,337,338],{},"In Cursor, go to:",[88,340,345],{"className":341,"code":343,"language":344,"meta":93},[342],"language-text","Cursor Settings → Tools & MCP → Add Custom MCP\n","text",[83,346,343],{"__ignoreMap":93},[11,348,349,350,190],{},"Then add this to ",[83,351,352],{},"mcp.json",[88,354,356],{"className":193,"code":355,"language":195,"meta":93,"style":93},"{\n  \"mcpServers\": {\n    \"memos-api-mcp\": {\n      \"timeout\": 60,\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@memtensor\u002Fmemos-api-mcp@latest\"\n      ],\n      \"env\": {\n        \"MEMOS_API_KEY\": \"YOUR_API_KEY\",\n        \"MEMOS_USER_ID\": \"your-user-id\",\n        \"MEMOS_CHANNEL\": \"MODELSCOPE\"\n      }\n    }\n  }\n}\n",[83,357,358,362,375,388,406,426,446,460,473,484,490,503,524,545,564,570,575,580],{"__ignoreMap":93},[97,359,360],{"class":99,"line":100},[97,361,203],{"class":202},[97,363,364,366,369,371,373],{"class":99,"line":129},[97,365,209],{"class":208},[97,367,368],{"class":212},"mcpServers",[97,370,216],{"class":208},[97,372,190],{"class":202},[97,374,221],{"class":202},[97,376,377,379,382,384,386],{"class":99,"line":224},[97,378,227],{"class":208},[97,380,381],{"class":230},"memos-api-mcp",[97,383,216],{"class":208},[97,385,190],{"class":202},[97,387,221],{"class":202},[97,389,390,392,395,397,399,403],{"class":99,"line":240},[97,391,243],{"class":208},[97,393,394],{"class":246},"timeout",[97,396,216],{"class":208},[97,398,190],{"class":202},[97,400,402],{"class":401},"sJNII"," 60",[97,404,405],{"class":202},",\n",[97,407,408,410,413,415,417,419,422,424],{"class":99,"line":275},[97,409,243],{"class":208},[97,411,412],{"class":246},"type",[97,414,216],{"class":208},[97,416,190],{"class":202},[97,418,257],{"class":136},[97,420,421],{"class":125},"stdio",[97,423,216],{"class":136},[97,425,405],{"class":202},[97,427,428,430,433,435,437,439,442,444],{"class":99,"line":281},[97,429,243],{"class":208},[97,431,432],{"class":246},"command",[97,434,216],{"class":208},[97,436,190],{"class":202},[97,438,257],{"class":136},[97,440,441],{"class":125},"npx",[97,443,216],{"class":136},[97,445,405],{"class":202},[97,447,448,450,453,455,457],{"class":99,"line":287},[97,449,243],{"class":208},[97,451,452],{"class":246},"args",[97,454,216],{"class":208},[97,456,190],{"class":202},[97,458,459],{"class":202}," [\n",[97,461,463,466,469,471],{"class":99,"line":462},8,[97,464,465],{"class":136},"        \"",[97,467,468],{"class":125},"-y",[97,470,216],{"class":136},[97,472,405],{"class":202},[97,474,476,478,481],{"class":99,"line":475},9,[97,477,465],{"class":136},[97,479,480],{"class":125},"@memtensor\u002Fmemos-api-mcp@latest",[97,482,483],{"class":136},"\"\n",[97,485,487],{"class":99,"line":486},10,[97,488,489],{"class":202},"      ],\n",[97,491,493,495,497,499,501],{"class":99,"line":492},11,[97,494,243],{"class":208},[97,496,92],{"class":246},[97,498,216],{"class":208},[97,500,190],{"class":202},[97,502,221],{"class":202},[97,504,506,508,511,513,515,517,520,522],{"class":99,"line":505},12,[97,507,465],{"class":208},[97,509,510],{"class":260},"MEMOS_API_KEY",[97,512,216],{"class":208},[97,514,190],{"class":202},[97,516,257],{"class":136},[97,518,519],{"class":125},"YOUR_API_KEY",[97,521,216],{"class":136},[97,523,405],{"class":202},[97,525,527,529,532,534,536,538,541,543],{"class":99,"line":526},13,[97,528,465],{"class":208},[97,530,531],{"class":260},"MEMOS_USER_ID",[97,533,216],{"class":208},[97,535,190],{"class":202},[97,537,257],{"class":136},[97,539,540],{"class":125},"your-user-id",[97,542,216],{"class":136},[97,544,405],{"class":202},[97,546,548,550,553,555,557,559,562],{"class":99,"line":547},14,[97,549,465],{"class":208},[97,551,552],{"class":260},"MEMOS_CHANNEL",[97,554,216],{"class":208},[97,556,190],{"class":202},[97,558,257],{"class":136},[97,560,561],{"class":125},"MODELSCOPE",[97,563,483],{"class":136},[97,565,567],{"class":99,"line":566},15,[97,568,569],{"class":202},"      }\n",[97,571,573],{"class":99,"line":572},16,[97,574,278],{"class":202},[97,576,578],{"class":99,"line":577},17,[97,579,284],{"class":202},[97,581,583],{"class":99,"line":582},18,[97,584,290],{"class":202},[11,586,587,588,591,592,47],{},"After configuration, confirm that Cursor's MCP tool list shows tools such as ",[83,589,590],{},"add_message"," and ",[83,593,594],{},"search_memory",[75,596,598],{"id":597},"cursor-rules","Cursor Rules",[11,600,601],{},"To make Cursor use memories more reliably, add rules like these to User Rules:",[88,603,606],{"className":604,"code":605,"language":344,"meta":93},[342],"Before answering the user's question, call MemOS search_memory to search long-term memories related to the current task.\nAfter answering, if this turn contains new user facts, preferences, project background, or other information useful in the long term, call add_message to write it into MemOS.\nOnly use memories relevant to the current task. Ignore memories that are irrelevant, outdated, or about the wrong subject.\nDo not expose internal implementation details such as \"memory store\" or \"retrieval results\" to the user.\n",[83,607,605],{"__ignoreMap":93},[75,609,294],{"id":610},"start-chatting-1",[15,612,613,616],{},[18,614,615],{},"First session: tell it who you are, your hobbies, and your profession, and ask it to remember.",[18,617,618],{},"Second session after restart: ask it who you are.",[307,620,621],{},[11,622,623,624,47],{},"Claude Desktop, Cline, Chatbox, and other clients are configured similarly, though the entry points differ. For more examples, see the ",[41,625,627],{"href":626},"\u002Fmcp_agent\u002Fmcp\u002Fguide","MCP Guide",[28,629],{},[31,631,633],{"id":632},"which-integration-should-you-choose","Which Integration Should You Choose?",[635,636,637,653],"table",{},[638,639,640],"thead",{},[641,642,643,647,650],"tr",{},[644,645,646],"th",{},"Integration",[644,648,649],{},"Best for",[644,651,652],{},"Priority",[654,655,656,668,679],"tbody",{},[641,657,658,662,665],{},[659,660,661],"td",{},"Plugin",[659,663,664],{},"OpenClaw and other Agent environments deeply integrated with MemOS",[659,666,667],{},"Prefer first; highest automation",[641,669,670,673,676],{},[659,671,672],{},"MCP",[659,674,675],{},"Cursor, Claude Desktop, Cline, Chatbox, and other AI clients",[659,677,678],{},"Use when the client supports MCP",[641,680,681,684,687],{},[659,682,683],{},"API \u002F SDK",[659,685,686],{},"Self-built Agents, chatbots, or business applications",[659,688,689],{},"Most control; best for production integration",[28,691],{},[31,693,695],{"id":694},"next-steps","Next Steps",[697,698,699,706,712],"card-group",{},[700,701,703],"card",{"icon":702,"title":315,"to":314},"i-ri-puzzle-line",[11,704,705],{},"View full installation, enabling, and advanced configuration for the OpenClaw plugin",[700,707,709],{"icon":708,"title":627,"to":626},"i-ri-terminal-box-line",[11,710,711],{},"Learn how to configure MCP in Cursor, Claude Desktop, Cline, and other clients",[700,713,716],{"icon":714,"title":683,"to":715},"i-ri-file-code-line","\u002Fmemos_cloud\u002Fgetting_started\u002Fquick_start",[11,717,718],{},"Start here if you are building your own Agent or application",[720,721,722],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .saonL, html code.shiki .saonL{--shiki-light:#E2931D;--shiki-default:#702C00;--shiki-dark:#FFA657}html pre.shiki code .sp2SP, html code.shiki .sp2SP{--shiki-light:#91B859;--shiki-default:#023B95;--shiki-dark:#79C0FF}html pre.shiki code .sp1uZ, html code.shiki .sp1uZ{--shiki-light:#91B859;--shiki-default:#032563;--shiki-dark:#A5D6FF}html pre.shiki code .svxCd, html code.shiki .svxCd{--shiki-light:#6182B8;--shiki-default:#023B95;--shiki-dark:#79C0FF}html pre.shiki code .sjUum, html code.shiki .sjUum{--shiki-light:#39ADB5;--shiki-default:#032563;--shiki-dark:#A5D6FF}html pre.shiki code .saN0X, html code.shiki .saN0X{--shiki-light:#39ADB5;--shiki-default:#A0111F;--shiki-dark:#FF7B72}html pre.shiki code .suWxN, html code.shiki .suWxN{--shiki-light:#39ADB5;--shiki-default:#0E1116;--shiki-dark:#E6EDF3}html pre.shiki code .sfJrv, html code.shiki .sfJrv{--shiki-light:#39ADB5;--shiki-default:#024C1A;--shiki-dark:#7EE787}html pre.shiki code .skH7o, html code.shiki .skH7o{--shiki-light:#9C3EDA;--shiki-default:#024C1A;--shiki-dark:#7EE787}html pre.shiki code .smon8, html code.shiki .smon8{--shiki-light:#E2931D;--shiki-default:#024C1A;--shiki-dark:#7EE787}html pre.shiki code .s_fzf, html code.shiki .s_fzf{--shiki-light:#F76D47;--shiki-default:#024C1A;--shiki-dark:#7EE787}html pre.shiki code .sw4Oa, html code.shiki .sw4Oa{--shiki-light:#E53935;--shiki-default:#024C1A;--shiki-dark:#7EE787}html pre.shiki code .smHB8, html code.shiki .smHB8{--shiki-light:#39ADB5;--shiki-default:#023B95;--shiki-dark:#79C0FF}html pre.shiki code .sJNII, html code.shiki .sJNII{--shiki-light:#F76D47;--shiki-default:#023B95;--shiki-dark:#79C0FF}",{"title":93,"searchDepth":129,"depth":129,"links":724},[725,726,731,736,737],{"id":33,"depth":129,"text":34},{"id":60,"depth":129,"text":61,"children":727},[728,729,730],{"id":77,"depth":224,"text":78},{"id":153,"depth":224,"text":154},{"id":293,"depth":224,"text":294},{"id":321,"depth":129,"text":322,"children":732},[733,734,735],{"id":334,"depth":224,"text":335},{"id":597,"depth":224,"text":598},{"id":610,"depth":224,"text":294},{"id":632,"depth":129,"text":633},{"id":694,"depth":129,"text":695},"Connect MemOS to Agent workflows through plugins, MCP, and APIs.","md",{},"\u002Fen\u002Fmemos_cloud\u002Fgetting_started\u002Fagent_usage",{"title":5,"description":13},"en\u002Fmemos_cloud\u002Fgetting_started\u002Fagent_usage","8YYqwr3DwJKRK7MWtRxcW8nZ_9uqhx3NGC0T2uXpQ2A",[746,754],{"title":747,"path":748,"stem":749,"icon":750,"framework":6,"module":6,"class":751,"target":-1,"active":752,"defaultOpen":752,"children":-1,"description":753},"Cloud Service & Open Source","\u002Fmemos_cloud\u002Fgetting_started\u002Fcloud_and_opensource","memos_cloud\u002Fgetting_started\u002Fcloud_and_opensource","i-ri-dashboard-line",[],false,"Choose the MemOS memory solution that best fits your needs.",{"title":755,"path":715,"stem":756,"icon":757,"framework":6,"module":6,"class":758,"target":-1,"active":752,"defaultOpen":752,"children":-1,"description":759},"Quick Start","memos_cloud\u002Fgetting_started\u002Fquick_start","i-ri-rocket-line",[],"Configure a MemOS Cloud account and create your first memory in five minutes.",1779709046093]