本页介绍 OpenClaw 的 Honcho 记忆插件：通过专用服务实现跨会话持久记忆，自动构建用户和 Agent 画像，支持语义搜索历史对话。覆盖安装步骤、JSON5 配置、现有 memory 文件迁移，以及与内置 SQLite 引擎的功能对比。

Honcho 记忆插件

Honcho 为 OpenClaw 带来 AI 原生的记忆能力。它将对话持久化到专用服务，随时间构建用户和 Agent 模型，让你的龙虾在会话重置、上下文压缩、渠道切换后依然保有用户背景——这是 workspace Markdown 文件做不到的。

提供的能力

跨会话记忆：每轮对话后自动持久化，context 不因会话重置而丢失
用户建模：为每个用户（偏好、已知事实、沟通风格）和 Agent（人格、学到的行为）自动维护画像
语义搜索：在历史对话的观察记录里做语义检索，而不只是当前会话
多 Agent 感知：父 Agent 自动追踪生成的子 Agent，父 Agent 在子会话中作为 observer 存在

可用工具

Honcho 注册的工具在对话中可直接使用：

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

工具	功能
`honcho_context`	跨会话的完整用户表征
`honcho_search_conclusions`	在存储的结论上做语义搜索
`honcho_search_messages`	跨会话查找消息（可按发送者、日期过滤）
`honcho_session`	当前会话历史和摘要

问答（LLM 驱动）：

工具	功能
`honcho_ask`	询问用户相关问题。`depth='quick'` 返回事实，`'thorough'` 做综合推断

快速开始

安装插件并完成设置：

bash

openclaw plugins install @honcho-ai/openclaw-honcho
openclaw honcho setup
openclaw gateway --force

setup 命令会引导你输入 API 凭据、写入配置，并可选迁移现有 workspace memory 文件。

Honcho 支持完全本地自托管，也可使用 api.honcho.dev 托管 API。自托管无需外部依赖。

配置

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

json5

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

自托管时将 baseUrl 指向本地服务（例如 http://localhost:8000），并省略 apiKey。

迁移现有 memory 文件

如果你有现有的 workspace memory 文件（USER.md、MEMORY.md、IDENTITY.md、memory/、canvas/），openclaw honcho setup 会自动检测并提供迁移选项。

迁移是非破坏性的——文件被上传到 Honcho，本地原始文件不会被删除或移动。

工作原理

每次 AI 轮次结束后，对话被持久化到 Honcho。用户和 Agent 消息都会被观察，Honcho 以此逐步构建和精化模型。

对话期间，Honcho 工具在 before_prompt_build 阶段查询服务，在模型看到 prompt 之前注入相关上下文，确保准确的轮次边界和有效的记忆召回。

Honcho 与内置记忆对比

	内置 / QMD	Honcho
存储	workspace Markdown 文件	专用服务（本地或托管）
跨会话	依赖 memory 文件	自动内置
用户建模	手动写入 MEMORY.md	自动画像
搜索	向量 + 关键词（混合）	跨观察记录的语义搜索
多 Agent	不追踪	父/子感知
依赖	无（内置）或 QMD 二进制	插件安装

Honcho 与内置记忆系统可以协同工作。配置了 QMD 时，本地 Markdown 文件搜索和 Honcho 跨会话记忆可以同时使用。

CLI 命令

bash

openclaw honcho setup                         # 配置 API key 并迁移文件
openclaw honcho status                        # 检查连接状态
openclaw honcho ask "问题"                    # 向 Honcho 询问用户相关信息
openclaw honcho search "查询" [-k N] [-d D]   # 在记忆上做语义搜索

常见问题

Q: Honcho 和内置 memory 能同时用吗？

A: 可以。配置了 QMD 时，会同时拥有本地 Markdown 文件搜索和 Honcho 跨会话记忆两套工具。

Q: 自托管 Honcho 怎么部署？

A: 参考 Honcho 官方文档，将 baseUrl 指向本地地址并省略 apiKey 即可。

Q: 我的龙虾切换渠道后（WhatsApp 换到 Telegram），历史记忆还在吗？

A: 在。Honcho 跨渠道持久化对话，无论龙虾通过哪个渠道响应，都能访问同一用户的历史上下文。

Honcho 记忆插件 ​

提供的能力 ​

可用工具 ​

快速开始 ​

配置 ​

迁移现有 memory 文件 ​

工作原理 ​

Honcho 与内置记忆对比 ​

CLI 命令 ​

常见问题 ​

相关 ​