核心用法
honcho-setup 是一款面向 OpenClaw 生态的记忆迁移工具，用于将传统基于 Markdown 文件的本地记忆系统升级至 Honcho 持久化记忆平台。执行流程分为七步：
1. 插件安装：通过 openclaw plugins install @honcho-ai/openclaw-honcho 安装官方插件，解决依赖后启用
2. 连接验证：支持托管云（需 HONCHO_API_KEY）或本地自托管（需 HONCHO_BASE_URL），验证通过后方可继续
3. 遗留文件检测：扫描 USER.md、IDENTITY.md、MEMORY.md、SOUL.md、AGENTS.md、BOOTSTRAP.md、HEARTBEAT.md、TOOLS.md 及 memory/、canvas/ 目录
4. 数据上传：通过 Honcho SDK 的 session.uploadFile() 将用户文件（owner peer）与 Agent 文件（openclaw peer）上传至会话
5. 文件归档：经用户确认后，将 USER.md、MEMORY.md、IDENTITY.md、HEARTBEAT.md 归档至 archive/ 并删除原文件；memory/、canvas/ 目录整体迁移；AGENTS.md、SOUL.md、BOOTSTRAP.md、TOOLS.md 保留原位
6. 文档更新：基于插件模板更新或创建 AGENTS.md、SOUL.md、BOOTSTRAP.md，替换文件式记忆引用为 honcho_profile、honcho_context、honcho_search、honcho_recall、honcho_analyze 等工具调用
7. 完成确认：汇总迁移结果并指向 Honcho 官方文档
显著优点
- 零数据丢失风险：所有删除操作前强制归档，失败时中止流程
- 双模式部署：兼顾托管云便捷性与自托管隐私性
- 结构化迁移：区分用户记忆与 Agent 自我描述，利用 Honcho 的 peer 机制实现权限隔离
- 工具化升级：将被动文件读取转为主动 API 调用，支持语义搜索与上下文注入
潜在局限
- 依赖 Node.js 生态：需处理 npm 依赖安装故障（已知 OpenClaw 插件安装器缺陷）
- 网络要求：上传阶段依赖 Honcho API 可用性
- 模板覆盖风险：若用户已深度自定义
SOUL.md等文件，自动化更新可能产生合并冲突 - 本地部署复杂度：自托管需 Docker 环境及额外配置
适合人群
- 使用 OpenClaw 且记忆文件膨胀、检索困难的长期用户
- 需要跨会话持久记忆的多 Agent 场景开发者
- 对数据主权敏感、希望选择自托管的企业用户
常规风险
- API 密钥泄露：
HONCHO_API_KEY需妥善保管，避免提交至版本控制 - 上传中断导致状态不一致：虽设计了失败保护，但大规模
memory/目录传输仍可能因网络波动中断 - 归档目录权限：需确保
archive/目录写入权限，否则回退机制失效