Agent 集成概览

OpenViking 可以作为多种 Agent 运行时的长期记忆与上下文后端。按你的运行时挑选合适的接入方式即可。

该用哪个集成？

你在用…	选这个
Claude Code	Claude Code 记忆插件 — 通过 hooks 实现自动召回与自动捕获
OpenClaw	OpenClaw 插件 — 全生命周期一体化集成
Codex / TraeCode CLI 2.0	Codex 记忆插件 — 生命周期 hooks 自动召回与增量捕获
Cursor	Cursor 记忆集成 — 一条命令安装生命周期 Hook、MCP 工具、Rules 与 Skills
TRAE / TRAE CN	TRAE 记忆集成 — 一个安装器完成 prompt 召回、回合捕获与 OpenViking 工具接入
DeepSeek Harness（`dsh`）	DeepSeek Harness 记忆插件 — 进程内 Cordis 插件，pre-step 召回、事件捕获与 OpenViking MCP 工具
Hermes Agent	Hermes Agent — 内置 OpenViking 记忆提供方，无需安装插件
OpenCode	OpenCode 插件 — MCP 工具 + 生命周期 hooks，覆盖仓库上下文、自动召回与捕获
pi	pi Coding Agent 扩展 — 原生扩展，自动召回、逐轮捕获与阈值 commit
LangChain / LangGraph	LangChain 和 LangGraph — retriever、tools、context backend、store 和 middleware
多个本地开发 Agent / 希望使用桌面界面	OpenViking Helper — 可视化完成 Agent 接入、会话分析和记忆管理
任意支持 Agent Plugins 1.0 的客户端	Agent Plugins 1.0 插件包 — 一个可移植的包：`openviking-memory` 技能 + OpenViking MCP 工具
Manus / Claude Desktop / ChatGPT / 其他 MCP 客户端	MCP 客户端 — 任何兼容 MCP 的客户端直接对接内置 `/mcp` 端点
ZCode / AstrBot / …	社区插件 — 社区维护的各运行时集成

横向对比各集成能力

想知道各个集成在工具面、自动召回、会话与 commit、压缩接管、降级容错上的具体差异，见集成能力参考——一份覆盖全部集成的横向对照矩阵。

开发与维护插件

新增或维护集成时，请遵循 Hook + MCP Agent 插件开发与维护规范。使用 VibeCoding 时，务必让 coding agent 在修改前阅读并遵循该规范；实现可以参考 Claude Code、Codex 和其他现有插件。

所有集成的共同前置

本页所有集成都需要连接到一个正在运行的 OpenViking 服务。如果你还没有，请先按快速开始部署。默认端点是 http://localhost:1933；远程使用需要 API Key（参见鉴权）。

低延迟召回

查询扩展和召回结果压缩是两个独立的可选模型调用。需要优先保证响应速度时，可以在 Agent 插件端同时关闭它们；语义检索、预算控制、档位降级和跨轮去重仍会正常工作。

下面这组环境变量同时适用于 Claude Code 和 Codex。查询扩展在所有经共享加载器解析配置的记忆插件上都可以关闭；压缩只有 Claude Code 和 Codex 支持。

bash

export OPENVIKING_RECALL_QUERY_EXPANSION=off
export OPENVIKING_RECALL_COMPRESS=off

两个插件都有本地压缩逻辑，但配置模型不同：

Claude Code 默认使用 recallCompress=auto：优先调用本地 claude -p（Sonnet + low），本地 CLI 不可用时回落到 OpenViking 服务端生成 digest。client 强制只用本地，server 强制只用服务端。
Codex 默认调用本地 codex exec，模型顺序为 gpt-5.3-codex-spark，其次 gpt-5.6-luna + low。它不会启用服务端压缩。

两端的共同默认配置是 recallCompress=auto。OPENVIKING_RECALL_COMPRESS=off 会同时关闭两端压缩；Codex 将 auto 或 client 解释为启用本地压缩。旧的 Claude Code 变量 OPENVIKING_RECALL_REWRITE 仍可兼容，但新配置请使用统一名称。

也可以把同样的设置写进 ~/.openviking/ovcli.conf：

json

{
  "url": "https://openviking.example.com",
  "api_key": "your-api-key",
  "plugin": {
    "recallQueryExpansion": "off",
    "recallCompress": "off"
  }
}

环境变量优先于 ovcli.conf。修改后重启对应的 Agent，让 hook 进程重新加载配置。上述设置属于插件客户端，不需要修改服务端的 ov.conf。

plugin 段由每个记忆插件读取——claude-code、codex、cursor、trae、trae-cn、zcode、opencode、dsh 和 pi；plugin.<harness> 对象只覆盖其中某一个 harness 的共享键，两种写法都认（claude_code 或 claude-code、trae_cn 或 trae-cn）。压缩是例外：其余 harness 认 recallQueryExpansion，但忽略 recallCompress 及其配套项——它们都不会请求服务端 digest。

context 请求的等待时间比普通请求更长，因为客户端提前中断会丢掉整个响应，而不只是超时的那一段。服务端流水线是串行的，每个可选阶段各有保险丝：先是查询扩展（retrieval.recall_intent_timeout_s，5 秒），然后是检索、正文读取和预算规划，最后才是 digest 重写（retrieval.recall_rewrite_timeout_s，30 秒）。因此这个上限按请求实际启用的阶段决定——带 session、会走查询扩展时取 15 秒，同时还要 digest 时取 45 秒，两者都不涉及时沿用插件自身的普通超时。可以用 OPENVIKING_RECALL_CONTEXT_TIMEOUT_MS（或 plugin.recallContextTimeoutMs）指定这个上限，取值应高于该请求会用到的保险丝、低于 Agent 自身的 hook 超时。

Agent 集成概览 ​

该用哪个集成？ ​

横向对比各集成能力 ​

开发与维护插件 ​

所有集成的共同前置 ​

低延迟召回 ​