TencentDB Agent Memory · 第 10 章 Coding Agent 接入实战

TencentDB Agent Memory · 第 10 章 Coding Agent 接入实战

章节摘要:前面九章打好了地基,本章把「接入」这件事落到五类真实的 Agent 框架上。第一类是 Claude Code 与 CodeBuddy,它们走代理层接入——改一行 baseURL 即可拥有记忆,是阻力最小的路径。第二类是 Hermes Agent,它有一套专门的适配器,把记忆能力映射到 Hermes 的生命周期,并额外提供熔断、背压与进程守护,保证长期运行的稳定性。第三类是 OpenClaw,它用一套三层架构(框架适配层 / SDK 层 / Gateway 层)把记忆能力以插件形式注入。第四类是通用 OpenAI 兼容的 Agent,只要它说 OpenAI 协议,就能用 SDK 四步法接入。本章对每一类都给出从零到第一次记忆会话的完整步骤,并对比五者在「接入成本、可控程度、适用场景」上的差异。读完本章无论你用哪个 Agent 框架,都能找到对应的接入路径。

学习目标

阅读完本章,你应当能够:

1. 把 Claude Code 或 CodeBuddy 接入代理层,完成第一次带记忆的会话
2. 说清 Hermes 适配器如何映射记忆能力到生命周期,以及熔断 / 背压 / 进程守护各自的作用
3. 解释 OpenClaw 插件三层架构(框架适配层 / SDK 层 / Gateway 层)的职责划分
4. 用 SDK 四步法接入一个通用 OpenAI 兼容 Agent
5. 用一张对比表为给定场景选择最合适的接入方式

核心概念速览

一句话金句:五类框架,三条路径(代理 / 适配器 / SDK),但终点都是同一个记忆核心——接入方式可以选,记忆能力是统一的。

子章节导航

01 Claude Code 与 CodeBuddy 接入

给出代理层接入的完整步骤:改 baseURL、配密钥、第一次会话,这是阻力最小的路径,适合不想改代码的用户。

02 Hermes 适配器:生命周期映射与熔断背压

讲清 Hermes 适配器如何把记忆能力映射到 Hermes 的生命周期,以及熔断、背压、进程守护、自动发现如何保障长期运行。

03 OpenClaw 插件:三层架构

讲清 OpenClaw 插件的三层架构(框架适配层 / SDK 层 / Gateway 层),以及每一层的职责与设计决策。

04 通用 OpenAI 兼容接入

讲清如何用第 9 章 SDK 四步法接入任意说 OpenAI 协议的 Agent,以及这种方式的可控性收益与代码成本。

子章节之间的逻辑关系

本章四节按「接入成本从低到高、可控程度从低到高」排列,前三节是框架特化路径,第四节是通用路径:

接入成本低 ←─────────────────────────────────▶ 接入成本高
可控程度低 ←─────────────────────────────────▶ 可控程度高

┌──────────┐   ┌──────────┐   ┌──────────┐   ┌──────────┐
│ 01 代理   │   │ 02 Hermes │   │ 03 OpenClaw│   │ 04 通用   │
│ 改baseURL │   │ 适配器    │   │ 三层插件   │   │ SDK四步法 │
└──────────┘   └──────────┘   └──────────┘   └──────────┘
   Claude Code     Hermes         OpenClaw       任意OpenAI兼容
   CodeBuddy                                     (含自研Agent)
​

铺垫说明:本章是「怎么做」的实操章,不重复「为什么」——代理层八步管道的原理见第 8 章,SDK 四步法的实现见第 9 章,知识引擎的工具来源见第 7 章。本章把前面三章的能力,映射到五类真实框架的具体接入步骤上。

前置知识与后续延伸

前置知识:

• 第 1 章已跑通三件套(接入的前提是系统在运行)
• 第 8 章代理层八步管道(01 节的内部原理)
• 第 9 章 SDK 四步法(04 节的实现基础)
• 第 7 章 /v3/tools/call(03 节 OpenClaw 插件暴露的工具来源)

本章为后续章节奠定的基础:

• 五框架接入能力是第 11 章组队场景的基础(队伍里的 Agent 必须先能接入)
• Hermes 的熔断 / 背压是第 12 章生产级稳定性的实战范例
• 接入方式的选择,是第 11 章冷启动「读档」的前置决策