为您的 AI 工作流添加持久化记忆能力。通过 Agentic Memory Platform 跨会话存储、检索和管理记忆。支持Claude CodeCLI、Claude Cowork桌面应用、Cursor、QoderWork和Codex。快速部署在兼容的agent对话框内输入以下Prompt指令安装插件请根据https://github.com/aliyun/alibabacloud-opensearch-memory/blob/main/README.md 文档安装插件详细步骤第一步设置 API Key安装插件前必须先完成此步骤。如果尚未注册请前往 https://opensearch.console.aliyun.com/cn-shanghai/rag/server-market 注册账号进入 api-keys 页面点击创建 API Key复制密钥以OS-开头和 baseurlhttp://xxx.platform-cn-shanghai.opensearch.aliyuncs.com将其添加到 shell 配置文件中# zshmacOS 默认 echoexport AGENTIC_MEMORY_API_KEYOS-your-api-key~/.zshrc echoexport AGENTIC_MEMORY_BASE_URLhttp://xxx.platform-cn-shanghai.opensearch.aliyuncs.com~/.zshrc source~/.zshrc # bash echoexport AGENTIC_MEMORY_API_KEYOS-your-api-key~/.bashrc echoexport AGENTIC_MEMORY_BASE_URLhttp://xxx.platform-cn-shanghai.opensearch.aliyuncs.com~/.bashrc source~/.bashrc确认环境变量已生效echo $AGENTIC_MEMORY_API_KEYecho $AGENTIC_MEMORY_BASE_URL第二步安装插件请根据您使用的工具选择对应的安装方式。所有方式均需先完成上述 API Key 设置。Claude CodeCLI/ Claude Cowork桌面应用Claude Code 和 Claude Cowork 共享同一套插件系统。CLI 方式claude plugin marketplace add aliyun/alibabacloud-opensearch-memory claude plugin install agentic-memoryagentic-memory-pluginsCowork 桌面应用打开 Cowork 标签页点击侧边栏的Customize点击Browse plugins安装 Agentic Memory。安装后将自动配置完整插件包括 MCP 服务器和生命周期钩子自动记忆捕获。QoderWork克隆仓库并打包为 zipgit clone https://github.com/aliyun/alibabacloud-opensearch-memory.git zip -r alibabacloud-opensearch-memory.zip alibabacloud-opensearch-memory在 QoderWork 中通过右上角的 Expert Kits - Install Kit 导入alibabacloud-opensearch-memory.zip由于 QoderWork 不支持在url中使用环境变量需要手动将~/.qoderwork/plugins-custom/agentic-memory/.mcp.json中的${AGENTIC_MEMORY_BASE_URL}和${AGENTIC_MEMORY_API_KEY}替换为实际值。由于 QoderWork 不支持 hooks 子目录需要手动将~/.qoderwork/plugins-custom/agentic-memory/hooks/hooks.json中的设置添加到~/.qoderwork/settings.json。注意将 ${CLAUDE_PLUGIN_ROOT} 替换为实际路径前缀~/.qoderwork/plugins-custom/agentic-memory。为所有脚本添加执行权限chmod x ~/.qoderwork/plugins-custom/agentic-memory/scripts/*重启 QoderWork。Codex方案 A — 直接 MCP 连接最快捷仅 MCP 功能Codex 从~/.codex/config.toml读取 MCP 服务器配置。添加以下内容[mcp_servers.agentic-memory] url ${AGENTIC_MEMORY_BASE_URL}/v1/agentic-memory/mcp bearer_token_env_var AGENTIC_MEMORY_API_KEY在 shell 中导出AGENTIC_MEMORY_API_KEY和AGENTIC_MEMORY_BASE_URL环境变量然后重启 Codex。如果您的 Codex 版本不支持url中的环境变量插值请将${AGENTIC_MEMORY_BASE_URL}替换为第一步中获取的实际 base URL。codex mcp add仅支持 stdio 服务器因此像 Agentic Memory 这样的 HTTP 服务器需要直接在config.toml中配置或通过 Codex 应用中的Plugins → Connect to a custom MCP → Streamable HTTP界面配置。方案 B — 侧加载插件完整体验MCP skills 可选钩子克隆仓库并通过一条 CLI 命令注册 marketplacecodex plugin marketplaceaddhttps://github.com/aliyun/alibabacloud-opensearch-memory.git重启 Codex运行/plugins从Agentic Memory Pluginsmarketplace 安装Agentic Memory。请勿同时使用方案 A 和方案 B。插件清单会通过agentic-memory-plugin/.codex-mcp.json自动注册agentic-memory作为 MCP 服务器——手动添加[mcp_servers.agentic-memory]会导致重复注册。可选 — 启用生命周期钩子。Codex 不会自动从插件清单中加载钩子它仅读取~/.codex/hooks.json或repo/.codex/hooks.json文档。运行一次内置安装脚本即可合并 Agentic Memory 的钩子配置python3 ~/codex-plugins/agentic-memory-source/agentic-memory-plugin/scripts/install_codex_hooks.py此脚本会在~/.codex/hooks.json中合并三个条目路径指向您的克隆目录事件功能SessionStart加载历史记忆作为启动上下文UserPromptSubmit将相关记忆注入到提示中Stop在回合结束时提醒 Agent 保存学习成果重复运行安装脚本是幂等的替换而非重复添加 Agentic Memory 条目并会保留您已有的其他钩子。如需卸载python3 .../install_codex_hooks.py --uninstall。如果您移动或删除了克隆目录请从新位置重新运行安装脚本——hooks 文件中存储的是绝对路径。Codex 钩子还需要在~/.codex/config.toml中启用codex_hooksfeature flag[features] codex_hooks true如果未设置该标志安装脚本会打印提醒。编辑配置后请重启 Codex。管理插件codex plugin marketplace upgrade# 拉取最新插件版本codex plugin marketplace remove agentic-memory-plugins# 取消注册 marketplaceCursor已经配置了agentic-memory作为 MCP 服务器 安装前请先从 Cursor MCP 设置中移除已有条目避免工具重复。手动配置仅 MCP 服务器在.cursor/mcp.json中添加以下内容{mcpServers:{agentic-memory:{url:${env:AGENTIC_MEMORY_BASE_URL}/v1/agentic-memory/mcp,headers:{Authorization:Bearer ${env:AGENTIC_MEMORY_API_KEY}}}}}验证安装安装完成后确认 MCP 服务器已连接启动新会话或重启当前会话输入“搜索一下我的爱好”如果agentic-memory工具出现并正常响应则表示安装成功更新插件当插件更新后从 marketplace 拉取新版本或重新本地安装现有会话中的 MCP 服务器连接会持有过期句柄并停止响应。请重启客户端以重新连接Claude Code在提示符中运行/restart或关闭后重新打开 CLI。Cursor退出并重新启动。Codex重启编辑器会话。您的AGENTIC_MEMORY_API_KEY无需重新输入——认证头会在新会话启动时从环境变量中重新读取。插件的 MCP 配置在会话启动时而非安装时进行${AGENTIC_MEMORY_API_KEY}变量插值因此只要环境变量已持久化设置在 shell 配置文件或~/.claude/settings.json的env块中重启后即可自动重连。如果重启后仍无法重连请检查新 shell 中是否可以访问AGENTIC_MEMORY_API_KEYecho $AGENTIC_MEMORY_API_KEY并确认密钥以OS-开头。MCP 工具安装后以下工具可供使用工具说明add_memory为用户/Agent 保存文本或对话历史search_memories通过语义搜索和过滤条件检索记忆get_memory根据 ID 获取特定记忆update_memory根据 ID 覆盖更新记忆内容delete_memory根据 ID 删除单条记忆