快速开始
欢迎访问 MemOS 云平台，可参考本新手指南，快速接入记忆能力。
1. 获取接口密钥
注册并登录 MemOS 云平台，此时系统已为您创建一个默认项目，从控制台复制您的默认 API Key。
2.核心记忆操作
如果是使用Python SDK，需先执行pip install MemoryOS -U
2.1 添加原始对话（addMessage）
会话 A：2025-06-10 发生
你只需要把原始的对话记录给到MemOS，MemOS 会自动抽象加工并保存为记忆。
import os
import requests
import json
# 替换成你的 API Key
os.environ["MEMOS_API_KEY"] = "YOUR_API_KEY"
os.environ["MEMOS_BASE_URL"] = "https://memos.memtensor.cn/api/openmem/v1"
data = {
"user_id": "memos_user_123",
"conversation_id": "0610",
"messages": [
{"role": "user", "content": "我暑假定好去广州旅游，住宿的话有哪些连锁酒店可选？"},
{"role": "assistant", "content": "您可以考虑【七天、全季、希尔顿】等等"},
{"role": "user", "content": "我选七天"},
{"role": "assistant", "content": "好的，有其他问题再问我。"}
]
}
headers = {
"Content-Type": "application/json",
"Authorization": f"Token {os.environ['MEMOS_API_KEY']}"
}
url = f"{os.environ['MEMOS_BASE_URL']}/add/message"
res = requests.post(url=url, headers=headers, data=json.dumps(data))
print(f"result: {res.json()}")
# # 请确保已安装MemoS (pip install MemoryOS -U)
from memos.api.client import MemOSClient
# 使用 API Key 初始化客户端
client = MemOSClient(api_key="YOUR_API_KEY")
messages = [
{"role": "user", "content": "我暑假定好去广州旅游，住宿的话有哪些连锁酒店可选？"},
{"role": "assistant", "content": "您可以考虑【七天、全季、希尔顿】等等"},
{"role": "user", "content": "我选七天"},
{"role": "assistant", "content": "好的，有其他问题再问我。"}
]
user_id = "memos_user_123"
conversation_id = "0610"
res = client.add_message(messages=messages, user_id=user_id, conversation_id=conversation_id)
print(f"result: {res}")
curl --request POST \
--url https://memos.memtensor.cn/api/openmem/v1/add/message \
--header 'Authorization: Token YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"user_id": "memos_user_123",
"conversation_id": "0610",
"messages": [
{"role": "user", "content": "我暑假定好去广州旅游，住宿的话有哪些连锁酒店可选？"},
{"role": "assistant", "content": "您可以考虑【七天、全季、希尔顿】等等"},
{"role": "user", "content": "我选七天"},
{"role": "assistant", "content": "好的，有其他问题再问我。"}
]
}'
add_message_res.json
{
"code": 0,
"data": {
"success": true
},
"message": "ok"
}
2.2 查询记忆（searchMemory）
会话 B：2025-9-28 发生
用户在一个新的会话中，提出让AI推荐国庆旅游地点和酒店，MemOS 会自动召回【事实记忆：曾去过哪里】【偏好记忆：订酒店的偏好】供AI参考，从而推荐更加个性化的旅游计划
import os
import requests
import json
# 替换成你的 API Key
os.environ["MEMOS_API_KEY"] = "YOUR_API_KEY"
os.environ["MEMOS_BASE_URL"] = "https://memos.memtensor.cn/api/openmem/v1"
data = {
"query": "我国庆想出去玩，帮我推荐个没去过的城市，以及没住过的酒店品牌",
"user_id": "memos_user_123",
"conversation_id": "0928"
}
headers = {
"Content-Type": "application/json",
"Authorization": f"Token {os.environ['MEMOS_API_KEY']}"
}
url = f"{os.environ['MEMOS_BASE_URL']}/search/memory"
res = requests.post(url=url, headers=headers, data=json.dumps(data))
print(f"result: {res.json()}")
# 请确保已安装MemOS (pip install MemoryOS -U)
from memos.api.client import MemOSClient
# 使用 API Key 初始化客户端
client = MemOSClient(api_key="YOUR_API_KEY")
query = "我国庆想出去玩，帮我推荐个没去过的城市，以及没住过的酒店品牌"
user_id = "memos_user_123"
conversation_id = "0928"
res = client.search_memory(query=query, user_id=user_id, conversation_id=conversation_id)
print(f"result: {res}")
curl --request POST \
--url https://memos.memtensor.cn/api/openmem/v1/search/memory \
--header 'Authorization: Token YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"query": "我国庆想出去玩，帮我推荐个没去过的城市，以及没住过的酒店品牌",
"user_id": "memos_user_123",
"conversation_id": "0928"
}'
search_memory_res.json
{
"memory_detail_list": [
{
"id": "b89a6e16-4ba1-4568-8f93-bd1eb5e25521",
"memory_key": "暑假旅游计划",
"memory_value": "用户计划在暑假期间前往广州旅游，并选择了七天连锁酒店作为住宿。",
"memory_type": "UserMemory",
"create_time": 1762748360718,
"conversation_id": "0610",
"status": "activated",
"confidence": 0.99,
"tags": [
"旅游",
"广州",
"暑假",
"住宿"
],
"update_time": 1762748360679,
"relativity": 0.011962891
}
],
"preference_detail_list": [
{
"id": "015d5695-179d-4452-8696-f2bba9ffbcd8",
"preference_type": "explicit_preference",
"preference": "用户选择七天作为在广州旅游时的住宿酒店。",
"reasoning": "用户在询问住宿选择后，明确表示选择了七天酒店，体现了对七天酒店的偏好。",
"create_time": 1762748209953,
"conversation_id": "0610",
"status": "activated",
"update_time": 1762748105661
},
{
"id": "8770596c-9fc0-41c9-b16b-0480a54627a8",
"preference_type": "implicit_preference",
"preference": "用户可能更偏好经济型酒店。",
"reasoning": "用户选择七天酒店，而没有选择全季或希尔顿。七天酒店通常是经济型酒店，相比其他推荐的酒店可能更为实惠。用户的选择可能反映出对经济实惠的偏好，而不是追求高档或奢华的住宿体验。虽然用户没有明确表述偏好的原因，但选择七天这一行为可能暗示其对经济型住宿的倾向。",
"create_time": 1762748105820,
"conversation_id": "0610",
"status": "activated",
"update_time": 1762748295149
}
],
"preference_note": "\n# 注意：\n事实记忆是事实的摘要，而偏好记忆是用户偏好的摘要。\n你的回复不得违反用户的任何偏好，无论是显式偏好还是隐式偏好，并简要解释你为什么这样回答以避免冲突。\n"
}
2.3 获取原始对话（getMessage）
获取指定用户和会话的原始对话消息，用于查看或参考完整聊天记录。
import os
import requests
import json
# 替换成你的 API Key
os.environ["MEMOS_API_KEY"] = "YOUR_API_KEY"
os.environ["MEMOS_BASE_URL"] = "https://memos.memtensor.cn/api/openmem/v1"
data = {
"user_id": "memos_user_123",
"conversation_id": "0610"
}
headers = {
"Content-Type": "application/json",
"Authorization": f"Token {os.environ['MEMOS_API_KEY']}"
}
url = f"{os.environ['MEMOS_BASE_URL']}/get/message"
res = requests.post(url=url, headers=headers, data=json.dumps(data))
print(f"result: {res.json()}")
# 请确保已安装MemoS (pip install MemoryOS -U)
from memos.api.client import MemOSClient
# 使用 API Key 初始化客户端
client = MemOSClient(api_key="YOUR_API_KEY")
user_id = "memos_user_123"
conversation_id = "0610"
res = client.get_message(user_id=user_id, conversation_id=conversation_id)
print(f"result: {res}")
curl --request POST \
--url https://memos.memtensor.cn/api/openmem/v1/get/message \
--header 'Authorization: Token YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"user_id": "memos_user_123",
"conversation_id": "0610"
}'
get_message_res.json
[
{
"role": "user",
"content": "我暑假定好去广州旅游，住宿的话有哪些连锁酒店可选？",
"chat_time": null,
"create_time": 1762747721000
},
{
"role": "assistant",
"content": "您可以考虑【七天、全季、希尔顿】等等",
"chat_time": null,
"create_time": 1762747721000
},
{
"role": "user",
"content": "我选七天",
"chat_time": null,
"create_time": 1762747721000
},
{
"role": "assistant",
"content": "好的，有其他问题再问我。",
"chat_time": null,
"create_time": 1762747721000
}
]
4. 下一步行动
👉 现在你已经能够运行 MemOS，查看完整的API 文档，探索更多功能吧！
5. 联系我们
