Agentic Memory扩展对接主流Agent适配Claude Code等

为您的AI工作流赋予持久的记忆能力。借助Agentic Memory Platform（智能体记忆平台），您可以在跨会话交互中轻松完成记忆的存储、检索与管理，全面支持Claude Code（CLI）、Claude Cowork（桌面应用）、Cursor、QoderWork及Codex等主流Agent工具。

快速部署

在兼容的Agent对话框内输入以下Prompt指令，即可快速安装插件，为您的AI工作流开启持久化记忆功能：

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

详细步骤

第一步：设置APIKey

1. 如果您尚未注册，请前往opensearch.console.aliyun.com/cn-shanghai…完成账号注册
2. 进入api-keys页面
3. 点击创建APIKey，复制密钥（以OS-开头）和baseurl（xxx.platform-cn-shanghai.opensearch.aliyuncs.com）
4. 将其添加到shell配置文件中：

# 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

5. 确认环境变量已成功生效：

echo $AGENTIC_MEMORY_API_KEY
echo $AGENTIC_MEMORY_BASE_URL

第二步：安装插件

根据您使用的AI Agent工具选择对应的安装方式。所有安装方法均需提前完成上述APIKey的配置。

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

Claude Code与Claude Cowork共享同一套插件系统，安装后可实现跨会话记忆管理。

CLI命令行安装方式：

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

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

安装完成后将自动配置完整插件，包含MCP服务器与生命周期钩子（自动记忆捕获），让AI工作流具备持久化记忆能力。

QoderWork

1. 克隆仓库并打包为zip：git clone https://github.com/aliyun/alibabacloud-opensearch-memory.git && zip -r alibabacloud-opensearch-memory.zip alibabacloud-opensearch-memory
2. 在QoderWork中，通过右上角的Expert Kits -> Install Kit导入alibabacloud-opensearch-memory.zip
3. 由于QoderWork不支持在url中使用环境变量，需要手动将~/.qoderwork/plugins-custom/agentic-memory/.mcp.json中的${AGENTIC_MEMORY_BASE_URL}和${AGENTIC_MEMORY_API_KEY}替换为实际值。
4. 由于QoderWork不支持hooks子目录，需要手动将~/.qoderwork/plugins-custom/agentic-memory/hooks/hooks.json中的设置添加到~/.qoderwork/settings.json。注意将${CLAUDE_PLUGIN_ROOT}替换为实际路径前缀~/.qoderwork/plugins-custom/agentic-memory。
5. 为所有脚本添加执行权限：chmod +x ~/.qoderwork/plugins-custom/agentic-memory/scripts/*
6. 重启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}替换为第一步中获取的实际baseURL。注意codex mcp add仅支持stdio服务器，因此像Agentic Memory这样的HTTP服务器需要直接在config.toml中配置（或通过Codex应用中的Plugins → Connect to a custom MCP → Streamable HTTP界面配置）。

方案B——侧加载插件（完整体验：MCP + skills + 可选钩子）：

克隆仓库并通过一条CLI命令注册marketplace，即可获得完整的记忆管理体验：

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

重启Codex，运行/plugins，从Agentic Memory Plugins marketplace安装Agentic Memory。

可选——启用生命周期钩子。Codex不会自动从插件清单中加载钩子；它仅读取~/.codex/hooks.json（或/.codex/hooks.json）。运行一次内置安装脚本即可合并Agentic Memory的钩子配置：

python3 ~/codex-plugins/agentic-memory-source/agentic-memory-plugin/scripts/install_codex_hooks.py

此脚本会在~/.codex/hooks.json中合并三个条目，路径指向您的克隆目录：

重复运行安装脚本是幂等的（替换而非重复添加Agentic Memory条目），并会保留您已有的其他钩子。如需卸载：python3 .../install_codex_hooks.py --uninstall。如果您移动或删除了克隆目录，请从新位置重新运行安装脚本——hooks文件中存储的是绝对路径。

Codex钩子还需要在~/.codex/config.toml中启用codex_hooks feature flag：

[features]
codex_hooks = true

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

管理插件：

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

Cursor

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

在.cursor/mcp.json中添加以下内容，即可在Cursor中启用Agentic Memory的持久化记忆能力：

{
  "mcpServers": {
    "agentic-memory": {
      "url": "${env:AGENTIC_MEMORY_BASE_URL}/v1/agentic-memory/mcp",
      "headers": {
        "Authorization": "Bearer ${env:AGENTIC_MEMORY_API_KEY}"
      }
    }
  }
}

验证安装

安装完成后，请确认MCP服务器已成功连接，确保AI记忆管理功能正常工作：

1. 启动新会话（或重启当前会话）
2. 输入："搜索一下我的爱好"
3. 如果agentic-memory工具出现并正常响应，则表示安装成功，跨会话记忆功能已就绪

更新插件

当插件更新后（从marketplace拉取新版本或重新本地安装），现有会话中的MCP服务器连接会持有过期句柄并停止响应。请重启客户端以重新连接，确保持久化记忆服务持续可用：

• Claude Code：在提示符中运行/restart，或关闭后重新打开CLI。
• Cursor：退出并重新启动。
• Codex：重启编辑器会话。

您的AGENTIC_MEMORY_API_KEY无需重新输入——认证头会在新会话启动时从环境变量中重新读取。插件的MCP配置在会话启动时（而非安装时）进行${AGENTIC_MEMORY_API_KEY}变量插值，因此只要环境变量已持久化设置（在shell配置文件或~/.claude/settings.json的env块中），重启后即可自动重连，保障AI记忆的连续性。

如果重启后仍无法重连，请检查新shell中是否可以访问AGENTIC_MEMORY_API_KEY（echo $AGENTIC_MEMORY_API_KEY），并确认密钥以OS-开头。

MCP工具

安装完成后，以下MCP工具可供使用，帮助您高效管理AI工作流中的记忆数据：