Agentic Memory Extension 支持对接主流Agent - 适用于 Claude Code、CodeX等

为您的 AI 工作流添加持久化记忆能力。通过 Agentic Memory Platform 跨会话存储、检索和管理记忆。支持 Claude Code （CLI）、Claude Cowork （桌面应用）、Cursor 、QoderWork 和 Codex。

快速部署

在兼容的agent对话框内输入以下Prompt指令，安装插件：

plaintext 复制代码

请根据https://github.com/aliyun/alibabacloud-opensearch-memory/blob/main/README.md 文档安装插件

详细步骤

第一步：设置 API Key

安装插件前必须先完成此步骤。

如果尚未注册，请前往 opensearch.console.aliyun.com/cn-shanghai... 注册账号
进入 api-keys 页面
点击 创建 API Key ，复制密钥（以 OS- 开头）和 baseurl（xxx.platform-cn-shanghai.opensearch.aliyuncs.com）

将其添加到 shell 配置文件中：

json 复制代码

# zsh（macOS 默认）
echo 'export AGENTIC_MEMORY_API_KEY="OS-your-api-key"' >> ~/.zshrc
echo 'export AGENTIC_MEMORY_BASE_URL="http://xxx.platform-cn-shanghai.opensearch.aliyuncs.com"' >> ~/.zshrc
source ~/.zshrc

# bash
echo 'export AGENTIC_MEMORY_API_KEY="OS-your-api-key"' >> ~/.bashrc
echo 'export AGENTIC_MEMORY_BASE_URL="http://xxx.platform-cn-shanghai.opensearch.aliyuncs.com"' >> ~/.bashrc
source ~/.bashrc

确认环境变量已生效：

json 复制代码

echo $AGENTIC_MEMORY_API_KEY
echo $AGENTIC_MEMORY_BASE_URL

第二步：安装插件

请根据您使用的工具选择对应的安装方式。所有方式均需先完成上述 API Key 设置。

Claude Code（CLI）/ Claude Cowork（桌面应用）

Claude Code 和 Claude Cowork 共享同一套插件系统。

CLI 方式：

plaintext 复制代码

claude plugin marketplace add aliyun/alibabacloud-opensearch-memory
claude plugin install agentic-memory@agentic-memory-plugins

Cowork 桌面应用： 打开 Cowork 标签页，点击侧边栏的 Customize ，点击 Browse plugins，安装 Agentic Memory。

安装后将自动配置完整插件，包括 MCP 服务器和生命周期钩子（自动记忆捕获）。

QoderWork

克隆仓库并打包为 zip：git 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 服务器配置。添加以下内容：

toml 复制代码

[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 命令注册 marketplace：

bash 复制代码

codex plugin marketplace add https://github.com/aliyun/alibabacloud-opensearch-memory.git

重启 Codex，运行 /plugins，从 Agentic Memory Plugins marketplace 安装 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 的钩子配置：

bash 复制代码

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_hooks feature flag：

toml 复制代码

[features]
codex_hooks = true

如果未设置该标志，安装脚本会打印提醒。编辑配置后请重启 Codex。

管理插件：

bash 复制代码

codex plugin marketplace upgrade               # 拉取最新插件版本
codex plugin marketplace remove agentic-memory-plugins   # 取消注册 marketplace

Cursor

已经配置了 agentic-memory 作为 MCP 服务器？安装前请先从 Cursor MCP 设置中移除已有条目，避免工具重复。

手动配置（仅 MCP 服务器）：

在 .cursor/mcp.json 中添加以下内容：

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_KEY（echo $AGENTIC_MEMORY_API_KEY），并确认密钥以 OS- 开头。

MCP 工具

安装后，以下工具可供使用：

工具	说明
`add_memory`	为用户/Agent 保存文本或对话历史
`search_memories`	通过语义搜索和过滤条件检索记忆
`get_memory`	根据 ID 获取特定记忆
`update_memory`	根据 ID 覆盖更新记忆内容
`delete_memory`	根据 ID 删除单条记忆