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

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

快速部署

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

请根据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"' >> ~/.zshrcecho 'export AGENTIC_MEMORY_BASE_URL="http://xxx.platform-cn-shanghai.opensearch.aliyuncs.com"' >> ~/.zshrcsource ~/.zshrc# bashecho 'export AGENTIC_MEMORY_API_KEY="OS-your-api-key"' >> ~/.bashrcecho 'export AGENTIC_MEMORY_BASE_URL="http://xxx.platform-cn-shanghai.opensearch.aliyuncs.com"' >> ~/.bashrcsource ~/.bashrc

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

echo $AGENTIC_MEMORY_API_KEYecho $AGENTIC_MEMORY_BASE_URL

第二步：安装插件

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

ClaudeCode（CLI）/ClaudeCowork（桌面应用）

ClaudeCode和ClaudeCowork共享同一套插件系统。

CLI方式：

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

Cowork桌面应用：打开Cowork标签页，点击侧边栏的Customize，点击Browseplugins，安装AgenticMemory。

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

QoderWork

1. 克隆仓库并打包为zip：gitclonehttps://github.com/aliyun/alibabacloud-opensearch-memory.git&&zip-ralibabacloud-opensearch-memory.zipalibabacloud-opensearch-memory

2. 在QoderWork中，通过右上角的ExpertKits->InstallKit导入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。codexmcpadd仅支持stdio服务器，因此像AgenticMemory这样的HTTP服务器需要直接在config.toml中配置（或通过Codex应用中的Plugins→ConnecttoacustomMCP→StreamableHTTP界面配置）。

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

克隆仓库并通过一条CLI命令注册marketplace：

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

重启Codex，运行/plugins，从AgenticMemoryPluginsmarketplace安装AgenticMemory。

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

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

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

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

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

[features]codex_hooks = true

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

管理插件：

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

Cursor

手动配置（仅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服务器已连接：

1. 启动新会话（或重启当前会话）

2. 输入："搜索一下我的爱好"

3. 如果agentic-memory工具出现并正常响应，则表示安装成功

更新插件

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

• ClaudeCode：在提示符中运行/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工具

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