概述
Honcho 是通过插件接入 OpenClaw 的 AI 原生记忆系统。它将对话持久化到专用服务，并随时间构建用户和 Agent 的模型，提供跨会话的上下文记忆，超越工作区 Markdown 文件的能力范围。
核心要点
- 跨会话记忆：每轮对话后自动持久化，上下文跨会话重置、压缩和渠道切换后仍可保留
- 用户建模：自动维护每个用户的偏好、事实、沟通风格档案，以及 Agent 的人格和学习行为
- 语义搜索：对历史对话的观察结果进行语义检索，不限于当前会话
- 多 Agent 感知：父 Agent 自动追踪子 Agent，父 Agent 作为观察者加入子会话
- 可本地部署：支持自托管（无需外部依赖）或使用托管 API（api.honcho.dev）
- 与内置记忆共存：Honcho 和内置记忆系统可同时工作，QMD 配置时额外工具可搜索本地 Markdown
可用工具
数据检索（无 LLM 调用，速度快）：
| 工具 | 功能 |
|---|---|
honcho_context | 跨会话的完整用户表示 |
honcho_search_conclusions | 对存储结论进行语义搜索 |
honcho_search_messages | 跨会话查找消息（可按发送者、日期过滤） |
honcho_session | 当前会话历史和摘要 |
honcho_ask | LLM 驱动的用户问答（quick/thorough 深度） |
配置/使用
安装与初始化：
openclaw plugins install @honcho-ai/openclaw-honcho
openclaw honcho setup
openclaw gateway --force配置项（plugins.entries["openclaw-honcho"].config）：
{
apiKey: "your-api-key", // 自托管时省略
workspaceId: "openclaw", // 记忆隔离
baseUrl: "https://api.honcho.dev"
}CLI 命令：
openclaw honcho setup # 配置 API key 并迁移文件
openclaw honcho status # 检查连接状态
openclaw honcho ask <question> # 查询用户信息
openclaw honcho search <query> # 语义搜索记忆与内置记忆对比：
| 维度 | 内置/QMD | Honcho |
|---|---|---|
| 存储 | 工作区 Markdown | 专用服务 |
| 跨会话 | 通过记忆文件 | 自动内置 |
| 用户建模 | 手动写入 | 自动档案 |
| 多 Agent | 不追踪 | 父子感知 |
相关页面
- memory — OpenClaw 记忆系统总览
- memory-builtin — 内置 SQLite 记忆引擎
- memory-qmd — QMD 本地搜索引擎
- context-engine — 插件上下文引擎机制