OpenClaw Honcho 跨会话记忆:插件安装、配置与内置 Markdown 记忆的对比【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw本篇技术指南围绕 OpenClaw 的 Honcho 记忆插件展开:通过外部插件honcho-ai/openclaw-honcho为 Agent 提供跨会话、跨渠道的持久记忆与用户建模能力。读完本文,你将掌握该插件的完整安装与配置流程、五个可用工具含快速检索与 LLM 问答两类的用途、与内置 Markdown 记忆体系的差异取舍,以及如何把已有的MEMORY.md等工作区记忆文件无损迁移过去。什么是 Honcho 记忆Honcho 记忆文档 给出的定位是:通过外部插件为 OpenClaw 增加 AI 原生的跨会话记忆。它与 OpenClaw 默认的工作区 Markdown 记忆不同,会把对话持久化到一个专用记忆服务(可自托管,也可使用托管 API),并随时间推移持续构建用户模型和 Agent 模型,让 Agent 获得超越本地工作区文件的上下文能力。它提供四项核心能力:跨会话记忆:每一轮对话后都会持久化,上下文可以跨会话重置、上下文压缩(compaction)以及渠道切换而保留;用户建模:Honcho 会为每个用户维护一份画像(偏好、事实、沟通风格),也会为 Agent 本身建模(性格、习得行为);语义搜索:搜索对象是历史对话中沉淀的观察(observations),而不仅是当前会话;多 Agent 感知:父 Agent 会自动跟踪其派生的子 Agent,父 Agent 会作为观察者加入子会话。需要明确一个边界:Honcho 插件本身是外部 npm 插件(honcho-ai/openclaw-honcho),不在 OpenClaw 主仓库源码内。从当前仓库检索可以看到,主仓库中与 Honcho 直接相关的代码只有 Hermes 迁移扩展对 Honcho 配置的处理(见下文迁移已有记忆一节),其余机制以文档描述为准。Honcho 提供的工具Honcho 会在会话期间向 Agent 注册一组工具,分为两类:数据检索类(快速,不触发 LLM 调用):工具作用honcho_context获取用户跨会话的完整表征honcho_search_conclusions对已存储的结论做语义搜索honcho_search_messages跨会话查找消息(可按发送者、日期过滤)honcho_session查看当前会话的历史与摘要问答类(LLM 驱动):工具作用honcho_ask针对用户提问。depthquick返回事实性回答,thorough返回综合归纳从设计上看,这种分层很实用:日常对话中 Agent 优先使用不耗 LLM 调用的检索工具快速取回上下文,只有在需要综合推理时才调用honcho_ask。快速上手:安装与初始化三条命令完成接入:openclaw plugins install honcho-ai/openclaw-honcho openclaw honcho setup openclaw gateway --forceopenclaw honcho setup会提示输入 API 凭证、写入配置,并可选地把已有工作区记忆文件迁移到 Honcho。这里有几个容易混淆的点,文档中明确说明了:它索要的 API key 由 Honcho 服务方签发,而不是OpenClaw 签发;该 key 仅在使用托管 API(api.honcho.dev)时需要;自托管 Honcho 部署没有 key 可填;Honcho 可以完全本地自托管运行,也可以使用api.honcho.dev的托管 API;自托管方案不要求任何外部依赖。最后一条openclaw gateway --force用于在插件安装后强制重启网关,使插件在运行中的网关里生效。插件配置详解Honcho 的设置位于plugins.entries[openclaw-honcho].config下:{ plugins: { entries: { openclaw-honcho: { config: { apiKey: your-api-key, // omit for self-hosted workspaceId: openclaw, // memory isolation baseUrl: https://api.honcho.dev, }, }, }, }, }各参数含义:参数说明apiKey托管 API 的访问凭证;自托管部署时省略workspaceId记忆隔离用的工作区标识,示例值为openclawbaseUrlHoncho 服务端地址,默认为托管 APIhttps://api.honcho.dev自托管时把baseUrl指向你的本地服务(例如http://localhost:8000),并省略apiKey。值得一提的是,从源码结构看,OpenClaw 的插件体系用plugins.entries.插件名承载各插件独立配置,用plugins.slots表达功能插槽的绑定关系。例如 Hermes 迁移扩展在检测到用户有文件记忆时,会把plugins.slots打上{ memory: memory-core }的补丁,以指定默认记忆插件(见 extensions/migrate-hermes/config.ts)。Honcho 作为记忆插件,也遵循同一套条目式配置约定。迁移已有记忆如果你的工作区里已经存在记忆文件(USER.md、MEMORY.md、IDENTITY.md、memory/目录),openclaw honcho setup会检测它们并提示迁移。迁移过程是无损的(non-destructive):文件会被上传到 Honcho,但原始文件绝不会被删除或移动。OpenClaw 默认的记忆体系是把USER.md(用户画像指令)、MEMORY.md(长期记忆)、memory/YYYY-MM-DD.md(每日笔记)等 Markdown 文件放在 Agent 工作区(默认~/.openclaw/workspace),详见 记忆总览。Honcho 的迁移入口正是对接这套文件。此外,migrate-hermes 扩展 中还有一个可佐证的实现事实:当从 Hermes 迁移且其memory.provider为honcho时,迁移器会把 Hermes 的 Honcho 配置原样保留为一个插件条目(plugins.entries下的 honcho 条目,enabled: true),同时生成一条手动提示项,建议先安装并审查 Honcho 记忆插件,再把它选入plugins.slots.memory。可以看到,OpenClaw 对 Honcho 的接入在配置层面就是插件条目 记忆插槽的标准形态,与本文前述的plugins.entries配置路径一致。工作原理Honcho 的工作流分两条线:写入线:每一轮 AI 对话结束后,对话会被持久化到 Honcho。用户消息和 Agent 消息都会被观察(observed),Honcho 借此随时间构建并精炼用户/Agent 模型;读取线:在对话过程中,Honcho 工具通过 OpenClaw 的before_prompt_build插件钩子查询服务,在模型看到提示词之前注入相关上下文。也就是说,记忆的注入发生在提示词构建阶段,属于插件钩子机制的一部分,而不是在模型输出之后再做后处理。更多插件钩子机制可参考 Context Engines 与 Context 相关文档。Honcho 与内置记忆体系对比原文档 给出的对比表是选型的关键依据:维度内置记忆Honcho存储工作区 Markdown 文件专用服务(本地或托管)跨会话通过记忆文件内置、自动用户建模手动(写进 MEMORY.md)自动画像搜索向量 关键词混合检索基于观察的语义搜索多 Agent不跟踪父子 Agent 感知依赖无需安装插件两者的关系是可以共存,而非二选一:内置搜索继续提供本地 Markdown 记忆,Honcho 提供跨会话记忆。实践中可以理解为:内置记忆是人可读、可手动维护、零依赖的磁盘真相(模型只记得写到磁盘上的东西),Honcho 是在其上叠加的自动建模与跨会话召回层。若你关心内置记忆如何工作,可继续阅读 内置记忆引擎 和 记忆搜索。CLI 命令速查Honcho 插件注册了独立的 CLI 子命令:openclaw honcho setup # 配置 API key 并迁移文件 openclaw honcho status # 检查连接状态 openclaw honcho ask question # 就用户向 Honcho 提问 openclaw honcho search query [-k N] [-d D] # 对记忆做语义搜索search命令的-k N用于控制返回结果数量,-d D用于指定深度/范围参数;ask与 Agent 侧的honcho_ask工具对应,提供同等的 LLM 驱动问答能力,方便在终端直接验证记忆服务是否可用。小结与延伸阅读Honcho 通过外部插件 专用服务为 OpenClaw 提供跨会话记忆、用户建模、语义搜索和父子 Agent 感知,配置集中在plugins.entries[openclaw-honcho].config的三个参数上;它支持完全自托管(baseUrl指向本地服务、无 API key)与托管 API(api.honcho.dev)两种部署形态;与内置 Markdown 记忆可共存,迁移已有记忆文件是无损操作;记忆注入通过before_prompt_build插件钩子在模型看到提示词前完成。延伸阅读(仓库内相对路径):Honcho 记忆文档记忆总览内置记忆引擎Context EnginesHermes 迁移配置处理【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考