接入方式总览

更新时间：2026-07-17

您可以根据 Agent 类型、技术栈和业务控制要求，选择合适的 Agent 记忆服务接入方式。不同接入方式的主要区别在于：记忆调用由谁触发、是否自动 retain / recall、是否需要写代码、是否能跨客户端复用。

如果您使用的 Agent 平台已提供专用插件，建议优先选择插件接入；如果需要跨多个客户端复用统一工具，建议选择 MCP；如果需要在业务代码中精确控制记忆写入和检索，建议选择 API 或 SDK；如果希望用指令文件约束 Agent 行为，建议选择 Skill。

信息填写

信息	填写位置	注意事项
API Base URL	插件配置、MCP 配置、SDK 构造参数、Skill 模板或 REST 请求 base URL	`https://cloud.memory.bj.baidubce.com/api`，已包含 `/api`，不要再额外拼接 `/api`
API Key / API Token	插件配置、认证字段或 `Authorization` 请求头	控制台创建的 API Key 在部分插件中称为 API Token，二者是同一份鉴权凭证；请只放在安全配置中
Bank ID	插件配置、MCP URL 路径、SDK 方法参数、Skill 模板或请求体 `bank_id`	按用户、项目、团队或 Agent 规划，避免多个无关租户混用
Tags	Retain、Recall、Reflect 参数	用于范围过滤和权限隔离，不建议仅作为内容分类

接入方式	接入体验	是否自动记忆	是否需要写代码	适合场景	典型对象	详细文档
API	任意语言直接通过 HTTP 调用	否	是	最通用、最透明，适合自研系统、低代码平台或需要完全控制调用流程的业务	Java、PHP、Ruby、Shell、低代码平台、自研 Agent	API 接入
SDK	在代码中直接调用，类型安全	否	是	在后端服务或微服务中集成记忆能力，减少 HTTP 样板代码	Go 后端服务、微服务	SDK 接入
MCP	将记忆能力注册为标准工具，由 Agent 自主调用	取决于 Agent 行为	否	希望一个服务兼容多个 MCP 客户端，统一暴露 retain / recall / reflect 等工具	Claude Code、Claude Desktop、Cursor、Windsurf、VS Code	MCP 接入
Skill	通过指令文件教 Agent 何时使用 CLI 或 API	取决于指令和 Agent 执行	通常不需要	编程 Agent 可执行命令，需要精细控制调用时机和行为规则	Claude Code、OpenCode、Codex CLI、自建 coding agent	Skill 接入
插件接入	安装对应 Agent 插件后，按宿主平台机制自动 recall / retain	是	否	已有专用插件的 Agent 平台，希望开箱即用接入长期记忆	Claude Code、Hermes、OpenClaw、OpenCode	见各插件接入文档

插件接入是面向特定 Agent 平台的快捷接入方式。插件通常会利用宿主平台的 hooks、MemoryProvider 或 plugin 机制，在对话前自动召回记忆，在对话后自动沉淀内容，并按 Bank ID 或动态 Bank 规则隔离记忆空间。

当前支持的插件包括：

插件	适用平台	接入特点	详细文档
OpenClaw 插件	OpenClaw	自动 retain / recall，支持会话过滤、失败重试队列和历史回填	OpenClaw 插件接入
OpenCode 插件	OpenCode	通过 `opencode plugin` 安装，可项目级或全局启用	OpenCode 插件接入
Claude Code 插件	Claude Code	通过 hooks 自动召回和沉淀，支持知识工具和带记忆的子智能体	Claude Code 插件接入
Hermes 插件	Hermes	作为 Hermes `MemoryProvider` 接入，支持 `hybrid` / `context` / `tools` 模式	Hermes 插件接入

使用需求	推荐方式
使用 Claude Code、Hermes、OpenClaw 或 OpenCode，希望快速获得自动记忆能力	优先选择对应插件接入
需要跨 Claude Code、Cursor、Windsurf、VS Code 等多个客户端复用同一套记忆工具	优先选择 MCP
需要自定义 Agent 的记忆调用行为和触发规则	选择 Skill
Go 项目需要类型安全的记忆服务调用	选择 Go SDK
需要在业务流程中精确控制写入、检索和推理	选择 REST API
需要最低接入门槛、无需写业务代码	优先选择插件接入，其次选择 MCP