核心用法
honcho-setup 是一款专为 OpenClaw 生态设计的记忆迁移技能，用于将传统基于文件的 workspace 记忆系统（USER.md、MEMORY.md、IDENTITY.md、memory/、canvas/ 等）无缝迁移至 Honcho 结构化记忆平台。
执行流程：
1. 插件安装：通过 openclaw plugins install @honcho-ai/openclaw-honcho 安装官方插件，处理依赖缺失问题
2. 连接验证：支持两种模式——托管 Honcho（需 HONCHO_API_KEY）或自托管本地实例（需 HONCHO_BASE_URL），验证连接后方可继续
3. 遗留文件扫描：自动检测三类内容——用户/所有者文件（USER.md、IDENTITY.md、MEMORY.md）、代理/自我文件（SOUL.md、AGENTS.md、TOOLS.md、BOOTSTRAP.md、HEARTBEAT.md）、以及 memory/ 和 canvas/ 目录
4. 数据上传：通过 Honcho SDK 的 session.uploadFile() 将内容上传至对应会话，用户内容关联 owner peer，代理内容关联 openclaw peer
5. 安全归档：默认归档至 {workspace_root}/archive/，支持自定义路径；删除原始文件前强制备份，关键工作区文档（AGENTS.md、SOUL.md、BOOTSTRAP.md）保留并更新
6. 文档更新：使用插件模板替换文件记忆引用为 Honcho 工具调用（honcho_profile、honcho_context、honcho_search、honcho_recall、honcho_analyze）
显著优点：
- 零数据丢失设计：所有删除操作前强制备份，上传失败则中止归档
- 双模式灵活部署：既可用官方托管服务快速启动，也支持完全离线自托管
- 语义化记忆管理：从平面文件升级至支持检索、上下文、分析的向量记忆系统
- 渐进式迁移：保留并智能更新现有工作区文档，而非强制替换
潜在局限：
- 依赖 Node.js/npm 环境，存在已知插件依赖安装问题需手动修复
- 网络上传涉及敏感工作区内容，需信任 Honcho 服务端或自行托管
- 大规模 canvas/ 目录可能面临上传超时或 API 限制
- 当前仅支持 Markdown/文本文件，PDF/JSON 等格式虽 SDK 支持但未在迁移流程中明确覆盖
适合人群：
- 长期使用 OpenClaw 且积累大量 USER.md/MEMORY.md 文件的老用户
- 需要跨会话持久化记忆、厌倦手动文件管理的团队
- 对数据隐私敏感、希望自托管记忆基础设施的技术用户
常规风险：
- 数据泄露风险：上传至 api.honcho.dev 的内容受 Honcho 隐私政策约束
- API 可用性：托管模式依赖第三方服务，存在单点故障可能
- 版本兼容性：OpenClaw 插件生态快速迭代，可能出现 SDK 版本不匹配
- 误删除风险：尽管有备份机制，用户仍需确认归档路径正确性