Skip to main content
Honcho 通过外部插件为 OpenClaw 添加 AI 原生记忆。它将对话持久化到专用服务,并随着时间推移构建用户和智能体模型,让你的智能体获得跨会话上下文,其范围超越工作区中的 Markdown 文件。

提供的功能

  • 跨会话记忆 - 每轮对话后都会持久化,因此上下文可跨会话重置、压缩和渠道切换延续。
  • 用户建模 - Honcho 为每位用户维护档案(偏好、事实、沟通风格),并为智能体维护档案(个性、习得行为)。
  • 语义搜索 - 搜索过去对话中的观察结果,而不仅限于当前会话。
  • 多智能体感知 - 父智能体会自动跟踪其创建的子智能体,并在子会话中将父智能体添加为观察者。

可用工具

Honcho 会注册智能体可在对话期间使用的工具: 数据检索(快速,不调用 LLM): 问答(由 LLM 驱动):

入门指南

安装插件并运行设置:
设置命令会提示输入 API 凭据、写入配置,并可选择迁移现有的工作区记忆文件。
Honcho 可以完全在本地运行(自行托管),也可以使用位于 api.honcho.dev 的托管 API。自行托管选项不需要任何外部依赖项。

配置

设置位于 plugins.entries["openclaw-honcho"].config 下:
对于自行托管的实例,将 baseUrl 指向本地服务器(例如 http://localhost:8000),并省略 API key。

迁移现有记忆

如果已有工作区记忆文件(USER.mdMEMORY.mdIDENTITY.mdmemory/canvas/),openclaw honcho setup 会检测这些文件并提供迁移选项。
迁移是非破坏性的——文件会上传到 Honcho,原始文件永远不会被删除或移动。

工作原理

每次 AI 回复后,对话都会持久化到 Honcho。系统会观察用户和智能体的消息,让 Honcho 随着时间推移构建并完善其模型。 对话期间,Honcho 工具会在 OpenClaw 的 before_prompt_build 插件钩子中查询服务,并在模型看到提示词之前注入相关上下文。

Honcho 与内置记忆的比较

Honcho 和内置记忆系统可以协同工作。配置 QMD 后,将提供额外工具,用于在 Honcho 的跨会话记忆之外搜索本地 Markdown 文件。

CLI 命令

延伸阅读

相关内容