AI Coding应用接入Hologres长记忆服务-实时数仓 Hologres(Hologres)-阿里云帮助中心

前提条件

已安装以下任一或多个AI Coding应用：Qoder CLI、Claude Code CLI（claude）、OpenAI Codex CLI（codex）。
已在Hologres控制台创建长记忆服务，并获取连接地址和API Key。具体操作，请参见创建和调用长记忆服务。
AI Coding应用所在环境可访问长记忆服务连接地址。同VPC建议使用私网地址；跨VPC或本地环境需配置公网白名单。

步骤一：一键安装

一键安装脚本会自动检测本地已安装的AI Coding应用，并为每个应用安装对应的Hologres长记忆插件、配置MCP连接、设置环境变量。

执行如下安装命令即可一键安装：

# Mac & Linux:
curl -fsSL https://hologres-open-memory.oss-cn-hangzhou.aliyuncs.com/hologres-openmemory/install.py | python3 -

# Windows:
curl.exe -fsSL https://hologres-open-memory.oss-cn-hangzhou.aliyuncs.com/hologres-openmemory/install.py | python -

脚本执行后，首先读取已有凭据或交互式提示输入连接地址和API Key，然后自动检测本地环境并展示可选的应用列表：

==================================================
 Hologres OpenMemory Installer
==================================================

  ✓ Using credentials from /Users/xxx/.hologres-open-memory/config.json
     URL: http://<ENDPOINT>:80
     Key: om-xxxxxxxx

  Validating credentials...
  ✓ Connection verified (HTTP 200) at http://<ENDPOINT>:80

  Select agents to configure
  (pre-selected [x] = already installed, press Enter in TTY to accept)

    [1] [x] Qoder CLI          (detected: v1.2.3)
    [2] [ ] Claude Code        (detected)
    [3] [ ] Codex              (not detected)

选择应用并确认后，脚本依次完成以下操作：

操作	说明
下载插件包	下载对应应用的插件并解压安装。
配置MCP连接	自动将长记忆服务的URL和API Key写入各应用的MCP配置文件。
设置环境变量	写入`HOLOGRES_OPEN_MEMORY_URL`和`HOLOGRES_OPEN_MEMORY_API_KEY`。Mac和Linux写入shell profile（如`~/.zshrc`或`~/.bashrc`），Windows通过`setx`写入当前用户的环境变量。
保存凭据	将连接地址和API Key存储到`~/.hologres-open-memory/config.json`。
安装管理CLI	安装`openmemory`命令行工具，用于后续管理。

安装完成后的输出示例：

==================================================
 Summary
==================================================
  ✓ Qoder CLI: installed
  ✓ Claude Code: installed

  Management CLI: /Users/xxx/.local/bin/openmemory
  Run openmemory status to check installation.
  Run openmemory uninstall to remove.

（可选）如需在CI/CD或自动化场景中使用，可通过环境变量和-y参数跳过交互。Mac和Linux示例如下：

export HOLOGRES_OPEN_MEMORY_URL=http://<ENDPOINT>:80
export HOLOGRES_OPEN_MEMORY_API_KEY=om-xxxxxxxx

curl -fsSL https://hologres-open-memory.oss-cn-hangzhou.aliyuncs.com/hologres-openmemory/install.py | python3 - install -y \
    --agents qodercli,claude-code,codex \
    --source-url https://hologres-open-memory.oss-cn-hangzhou.aliyuncs.com/hologres-openmemory/install.py

Windows（PowerShell）示例如下：

$env:HOLOGRES_OPEN_MEMORY_URL = "http://<ENDPOINT>:80"
$env:HOLOGRES_OPEN_MEMORY_API_KEY = "om-xxxxxxxx"

curl.exe -fsSL https://hologres-open-memory.oss-cn-hangzhou.aliyuncs.com/hologres-openmemory/install.py | python - install -y --agents qodercli,claude-code,codex --source-url https://hologres-open-memory.oss-cn-hangzhou.aliyuncs.com/hologres-openmemory/install.py

说明

--agents参数支持的值：qodercli（Qoder CLI）、claude-code（Claude Code）、codex（Codex）。多个应用以逗号分隔。--source-url参数确保管理CLI在非交互模式下也能正确安装。

步骤二：验证效果

检查安装状态

openmemory status

预期返回：

==================================================
 Hologres OpenMemory Status
==================================================

  ✓ Qoder CLI v1.2.3 [detected]
     config: /Users/xxx/.qoder/plugins/cache/local/openmemory/1.2.3/.qoder-mcp.json

  ✓ Claude Code v0.1.1 [detected]
     config: /Users/xxx/.claude/settings.json

  ✓ Codex v0.1.1 [detected]
     config: /Users/xxx/.codex/plugins/cache/hologres-openmemory-plugins/openmemory/0.1.1/.codex-mcp.json

  CLI: /Users/xxx/.local/bin/openmemory (exists)

  ✓ Using credentials from /Users/xxx/.hologres-open-memory/config.json
     URL: http://<ENDPOINT>:80
     Key: om-xxxxxxxx
  Credentials: configured

  3/3 agent(s) installed

在AI Coding应用中验证

Qoder CLI：启动Qoder CLI后，在对话中告知Agent一些个人信息，然后在新会话中提问，验证记忆是否被自动召回。也可以在对话中输入/openmemory:health检查长记忆服务连接状态。

Claude Code：启动Claude Code后，插件会自动加载。在对话中测试跨Session的记忆持久化效果。

Codex：启动Codex后，通过/openmemory:health命令检查长记忆服务连接状态，然后在对话中验证记忆召回。

配置信息说明

一键安装脚本已完成所有配置，通常无需手动修改。以下为各应用的配置文件位置，供参考。

凭据存储

安装脚本将连接地址和API Key统一存储在~/.hologres-open-memory/config.json：

{
  "hologres_open_memory_url": "http://<ENDPOINT>:80",
  "hologres_open_memory_api_key": "om-xxxxxxxx"
}

如需修改凭据，可通过以下命令重新配置：

# 交互式修改
openmemory config

# 或直接指定参数
openmemory config --url http://<ENDPOINT>:80 --key om-xxxxxxxx

各应用配置文件

应用	配置文件路径	说明
Qoder CLI	`~/.qoder/plugins/cache/local/openmemory/<VERSION>/.qoder-mcp.json`	MCP连接配置，包含URL（自动拼接`/mcp`）和Authorization请求头。
Claude Code	`~/.claude/settings.json`	`env`字段中存储URL和API Key环境变量；`pluginConfigs`中存储插件选项。
Codex	`~/.codex/plugins/cache/hologres-openmemory-plugins/openmemory/<VERSION>/.codex-mcp.json`	MCP连接配置，包含URL（自动拼接`/mcp`）。

说明

表中的~代表当前用户的主目录。Windows下对应%USERPROFILE%，且路径分隔符为反斜杠，例如%USERPROFILE%\.claude\settings.json。

环境变量

Mac和Linux下，安装脚本会在shell profile（如~/.zshrc或~/.bashrc）中写入以下环境变量：

# >>> hologres-open-memory >>>
export HOLOGRES_OPEN_MEMORY_URL="http://<ENDPOINT>:80"
export HOLOGRES_OPEN_MEMORY_API_KEY="om-xxxxxxxx"
# <<< hologres-open-memory <<<

Windows下，安装脚本通过setx将以下变量写入当前用户的环境变量：

HOLOGRES_OPEN_MEMORY_URL=http://<ENDPOINT>:80
HOLOGRES_OPEN_MEMORY_API_KEY=om-xxxxxxxx

说明

安装脚本还会将管理CLI所在目录加入PATH：Mac和Linux为~/.local/bin，Windows为%LOCALAPPDATA%\openmemory。Mac和Linux需执行source ~/.zshrc（或对应的shell profile）或重新打开终端，Windows需重新打开终端，环境变量和PATH才会生效，之后即可直接运行openmemory命令。

常见问题

如何查看当前安装了哪些应用？

运行openmemory status，会列出所有支持的应用及其安装状态。

如何修改已配置的连接地址或API Key？

openmemory config --url http://<ENDPOINT>:80 --key om-xxxxxxxx

修改后需要重新运行安装以更新各应用的配置：

openmemory update

安装后连接失败怎么办？

排查步骤：

确认服务地址带http://前缀且包含端口号（如:80）。
确认API Key与Hologres控制台一致（以om-开头）。
确认本地环境可访问长记忆服务连接地址（通过curl http://<ENDPOINT>:80/mcp测试连通性）。
如使用公网地址，确认已配置IP白名单。

如何卸载某个应用的插件？

openmemory uninstall

交互式选择需要卸载的应用。也可指定应用：

openmemory uninstall --agents qodercli

首次安装时没有已保存的凭据，如何输入？

脚本会交互式提示输入Service URL和API Key，获取方式请参见获取连接信息。

  Please enter your OpenMemory service credentials.

  Service URL: http://<ENDPOINT>:80
  API Key:  (输入时不回显)

输入后脚本会自动验证连通性，验证通过则继续安装流程。