Honcho 记忆

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

提供的功能

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

可用工具

Honcho 会注册智能体可在对话期间使用的工具：

数据检索（快速，不调用 LLM）：

问答（由 LLM 驱动）：

入门指南

安装插件并运行设置：

openclaw plugins install @honcho-ai/openclaw-honchoopenclaw honcho setupopenclaw gateway --force

设置命令会提示输入 API 凭据、写入配置，并可选择迁移现有的工作区记忆文件。

配置

设置位于 plugins.entries["openclaw-honcho"].config 下：

{  plugins: {    entries: {      "openclaw-honcho": {        config: {          apiKey: "your-api-key", // 自行托管时省略          workspaceId: "openclaw", // 记忆隔离          baseUrl: "https://api.honcho.dev",        },      },    },  },}

对于自行托管的实例，将 baseUrl 指向本地服务器（例如 http://localhost:8000），并省略 API key。

迁移现有记忆

如果已有工作区记忆文件（USER.md、MEMORY.md、 IDENTITY.md、memory/、canvas/），openclaw honcho setup 会检测这些文件并提供迁移选项。

工作原理

每次 AI 回复后，对话都会持久化到 Honcho。系统会观察用户和智能体的消息，让 Honcho 随着时间推移构建并完善其模型。

对话期间，Honcho 工具会在 OpenClaw 的 before_prompt_build 插件钩子中查询服务，并在模型看到提示词之前注入相关上下文。

Honcho 与内置记忆的比较

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

CLI 命令

openclaw honcho setup                        # 配置 API key 并迁移文件openclaw honcho status                       # 检查连接状态openclaw honcho ask <question>               # 向 Honcho 查询有关用户的信息openclaw honcho search <query> [-k N] [-d D] # 对记忆进行语义搜索

延伸阅读

• 插件源代码
• Honcho 文档
• Honcho OpenClaw 集成指南

相关内容

• 记忆概览
• 内置记忆引擎
• QMD 记忆引擎
• 上下文引擎