本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

mem9

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @mem9/dsh-plugin

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• • Hosted API: https://api.mem9.ai
• • Self-hosted: apply the matching control-plane schema, then start mnemo-server:
• • OpenClaw / ClawHub
• • Hermes Agent
• • Claude Code

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后还需要做什么？

需要先 export MEM9_API_KEY="<你的 mem9 key>"，再执行 dsh --profile --dump-config 验证配置已生效。

它会改动我原有的 agent 或 session 行为吗？

不会。插件只是插入一个名为 mem9 的 Cordis 行，不修改 agent 循环也不改动 session 数据格式。

默认会保存哪些内容到云端？

每个 turn/end 完成后，只会上传真实用户文本和助手文本，自动以 mode: smart 提交，单次最多 20 条消息或 204800 字节。

数据存在哪里？是否上传到第三方？

默认存到 https://api.mem9.ai（官方托管服务），也可通过 apiUrl 配置项换成自建实例。

subagent 默认能使用记忆吗？

默认不能。只有顶级 agent 会注册记忆工具；如需 subagent 也具备相同能力，需把 includeSubagents 设为 true。

单条记忆有大小或数量限制吗？

工具层限制：单条内容不超过 50000 字符、标签数组不超过 20 个；search 接口每次最多返回 200 条。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.7+
• Node: >=22.19.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则