Honcho 为 OpenClaw 添加了 AI 原生记忆。它会将
对话持久化到一个专用服务中，并随着时间推移构建用户和代理模型，
为你的代理提供超越工作区 Markdown
文件的跨会话上下文。
它提供什么
- 跨会话记忆 — 每轮对话后都会持久化，因此上下文可跨越会话重置、压缩和频道切换。
- 用户建模 — Honcho 为每个用户维护一个档案（偏好、事实、沟通风格），并为代理维护一个档案（个性、已学习的行为）。
- 语义搜索 — 可在过去对话的观察内容上进行搜索，而不仅仅是当前会话。
- 多代理感知 — 父代理会自动跟踪已生成的子代理，并在子会话中将父代理添加为观察者。
可用工具
Honcho 会注册代理可在对话期间使用的工具：
数据检索（快速，无需 LLM 调用）：
| 工具 | 功能说明 |
|---|
honcho_context | 跨会话的完整用户表示 |
honcho_search_conclusions | 对已存储结论进行语义搜索 |
honcho_search_messages | 跨会话查找消息（按发送者、日期筛选） |
honcho_session | 当前会话历史和摘要 |
| 工具 | 功能说明 |
|---|
honcho_ask | 询问有关用户的问题。depth='quick' 用于事实，'thorough' 用于综合 |
开始使用
安装插件并运行设置：
openclaw plugins install @honcho-ai/openclaw-honcho
openclaw honcho setup
openclaw gateway --force
Honcho 可以完全在本地运行（自托管），也可以通过
api.honcho.dev 上的托管 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 密钥。
迁移现有记忆
如果你已有工作区记忆文件（USER.md、MEMORY.md、
IDENTITY.md、memory/、canvas/），openclaw honcho setup 会检测到并
提供迁移选项。
迁移是非破坏性的 — 文件会被上传到 Honcho。原始文件
绝不会被删除或移动。
工作原理
每次 AI 回合后，对话都会持久化到 Honcho。用户和
代理消息都会被观察，从而使 Honcho 能够随着时间推移构建并优化其模型。
在对话期间，Honcho 工具会在 before_prompt_build
阶段查询服务，在模型看到提示词之前注入相关上下文。这确保了
准确的轮次边界和相关回忆。
Honcho 与内置记忆
| 内置 / QMD | Honcho |
|---|
| 存储 | 工作区 Markdown 文件 | 专用服务（本地或托管） |
| 跨会话 | 通过记忆文件 | 自动内置 |
| 用户建模 | 手动（写入 MEMORY.md） | 自动档案 |
| 搜索 | 向量 + 关键词（混合） | 对观察内容进行语义搜索 |
| 多代理 | 未跟踪 | 父/子感知 |
| 依赖 | 无（内置）或 QMD 二进制文件 | 安装插件 |
CLI 命令
openclaw honcho setup # 配置 API 密钥并迁移文件
openclaw honcho status # 检查连接状态
openclaw honcho ask <question> # 向 Honcho 询问有关用户的问题
openclaw honcho search <query> [-k N] [-d D] # 对记忆进行语义搜索
延伸阅读
相关内容
