通过插件接入Agentic Memory智能体记忆服务

Claude Code与Claude Cowork

Claude Code与Claude Cowork共享同一套插件系统。安装后将自动完成完整配置，包括MCP服务器与生命周期钩子。

CLI方式：

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

Cowork桌面应用方式：打开Cowork标签页，在侧边栏单击Customize，单击Browse plugins，然后安装Agentic Memory。

安装后自动注册的生命周期钩子如下。

Cursor

若此前已在Cursor的MCP设置中配置过agentic-memory，请先移除已有条目，避免工具重复注册。

手动配置方式仅接入MCP服务器，不含钩子与Skill。在.cursor/mcp.json中添加以下内容。

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

若需同时获得Skill与生命周期钩子（sessionStart、beforeSubmitPrompt、preToolUse、preCompact、stop共5个事件），请改用插件安装方式，插件仓库已内置Cursor插件清单。

Codex

Codex提供两种接入方案，请勿同时使用。插件清单会通过.codex-mcp.json自动注册agentic-memory为MCP服务器，若再手动添加[mcp_servers.agentic-memory]会导致重复注册。

方案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}替换为步骤一获取的实际访问域名。

说明：codex mcp add仅支持stdio类型的服务器，Agentic Memory是HTTP服务器，只能在config.toml中直接配置，或通过Codex应用的Plugins > Connect to a custom MCP > Streamable HTTP界面配置。

方案B：侧加载插件

可获得完整体验，包括MCP服务器、Skill与可选的生命周期钩子。注册插件市场。

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

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

管理插件的常用命令如下。

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

方案B可选步骤：启用生命周期钩子

Codex不会自动从插件清单加载钩子，仅读取~/.codex/hooks.json或<repo>/.codex/hooks.json。运行插件内置的安装脚本，将Agentic Memory的钩子配置合并进去。

python3 <插件安装目录>/scripts/install_codex_hooks.py

脚本会向~/.codex/hooks.json合并3个条目，并把脚本路径改写为绝对路径，同时保留您已有的其他钩子。

注意：必须从codex plugin marketplace add侧加载得到的插件目录运行该脚本，不要从自行git clone的目录运行。脚本靠插件目录名识别自己写入的钩子条目，从自建克隆目录运行时，重复执行会重复追加条目，且--uninstall无法删除条目。

启用钩子还需在~/.codex/config.toml中打开codex_hooks特性开关，否则安装脚本会打印提示。修改后请重启Codex。

[features]
  codex_hooks = true

如需卸载钩子，执行python3 <插件安装目录>/scripts/install_codex_hooks.py --uninstall。由于钩子文件中存储的是绝对路径，若移动或删除了插件目录，请从新位置重新运行安装脚本。

QoderWork

步骤1：克隆仓库并打包为zip文件

git clone https://github.com/aliyun/alibabacloud-opensearch-memory.git && zip -r alibabacloud-opensearch-memory.zip alibabacloud-opensearch-memory

步骤2：导入Kit

在QoderWork中，通过右上角的Expert Kits > Install Kit导入alibabacloud-opensearch-memory.zip。

步骤3：手动替换MCP配置中的环境变量

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

Hermes

Hermes通过memory provider方式接入，与其他客户端的插件机制不同，不依赖环境变量，凭证写在插件的配置文件中。

步骤1：安装插件

hermes plugins install https://github.com/aliyun/alibabacloud-opensearch-memory-for-hermes.git

注意：hermes plugins install仅安装插件文件，不保证为memory provider安装Python运行时依赖。安装完成后必须补齐依赖，二选一即可。

• 交互式安装：运行hermes memory setup，用方向键选择agentic_memory，由Hermes依据plugin.yaml自动安装pip_dependencies。

• 手动安装：将依赖安装到Hermes实际使用的Python环境中，然后设置provider。

pip install requests
  hermes config set memory.provider agentic-memory

步骤2：配置插件

若选择交互式安装，插件会提示输入所有必需配置项；否则需手动创建配置文件$HERMES_HOME/agentic_memory.json。

说明：工作空间名由api_endpoint自动解析得出，无需配置。

步骤3：配置MCP客户端

在~/.hermes/config.yaml中添加以下内容。

mcp_servers:
    agentic-memory:
      url: [YOUR_ENDPOINT]/v1/agentic-memory/mcp
      headers:
        Accept: application/json, text/event-stream
        Authorization: Bearer [YOUR_API_TOKEN]

步骤4：重启Hermes

重启Hermes以加载插件与MCP服务器。