Honcho 记忆

Honcho 通过外部插件为 OpenClaw 添加 AI 原生记忆。它将对话持久化到专用服务，并随时间构建用户与智能体模型，为你的智能体提供超越工作区 Markdown 文件的跨会话上下文。

提供的功能¶

跨会话记忆 - 每一轮对话后会话都会持久化，因此上下文可跨越会话重置、压缩和频道切换。
用户建模 - Honcho 为每个用户维护画像（偏好、事实、沟通风格），也为智能体维护画像（个性、习得行为）。
语义搜索 - 可对过去对话中的观察进行搜索，而不仅限于当前会话。
多智能体感知 - 父智能体自动追踪其衍生的子智能体，父智能体会作为观察者被添加到子会话中。

可用工具¶

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

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

工具	作用
`honcho_context`	跨会话的完整用户画像
`honcho_search_conclusions`	对已存储结论的语义搜索
`honcho_search_messages`	跨会话查找消息（按发送者、日期筛选）
`honcho_session`	当前会话历史与摘要

问答（LLM 驱动）：

工具	作用
`honcho_ask`	询问关于用户的问题。`depth='quick'` 获取事实，`'thorough'` 获取综合分析

快速开始¶

安装插件并运行设置：

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

设置命令会提示你输入 API 凭据、写入配置，并可选地迁移现有工作区记忆文件。它要求的 API 密钥由 Honcho 签发，而非 OpenClaw，并且仅用于 api.honcho.dev 上的托管 API；自托管 Honcho 部署无需输入密钥。

Info

Honcho 可以完全本地运行（自托管），或通过 api.honcho.dev 上的托管 API 运行。自托管选项无需任何外部依赖。

配置¶

设置位于 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",
        },
      },
    },
  },
}

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

迁移现有记忆¶

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

Info

迁移是非破坏性的 - 文件会被上传到 Honcho。原始文件永远不会被删除或移动。

工作原理¶

每次 AI 回合结束后，对话都会被持久化到 Honcho。用户和智能体的消息都会被观察，让 Honcho 能够随时间构建并完善其模型。

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

Honcho 与内置记忆对比¶

	内置记忆	Honcho
存储	工作区 Markdown 文件	专用服务（本地或托管）
跨会话	通过记忆文件	自动，内置
用户建模	手动（写入 `MEMORY.md`）	自动画像
搜索	向量 + 关键词（混合）	基于观察的语义搜索
多智能体	不追踪	父/子感知
依赖	无	插件安装

Honcho 与内置记忆系统可以协同工作。内置搜索在 Honcho 的跨会话记忆之外，仍保持本地 Markdown 可用。

CLI 命令¶

openclaw honcho setup                        # Configure API key and migrate files
openclaw honcho status                       # Check connection status
openclaw honcho ask <question>               # Query Honcho about the user
openclaw honcho search <query> [-k N] [-d D] # Semantic search over memory

延伸阅读¶

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw