honcho-setup

honcho-setup 是一个专门用于将 OpenClaw 文件式记忆系统迁移至 Honcho 长期记忆服务的专业工具。该 Skill 通过标准化的七步流程，帮助用户将分散在本地工作区的记忆文件（包括 USER.md、MEMORY.md、IDENTITY.md 等用户配置文件，以及 SOUL.md、AGENTS.md 等智能体配置）安全、完整地迁移至 Honcho API，实现从文件管理到云端记忆服务的转型。

核心用法遵循明确的操作流程：首先通过 OpenClaw 插件系统安装并启用 @honcho-ai/openclaw-honcho 插件，验证与 Honcho 服务（托管版 api.honcho.dev 或自托管实例）的连接状态。随后自动扫描工作区根目录检测遗留记忆文件，在获得用户明确确认后，使用 Honcho SDK 将文件内容上传至指定服务端，区分用户文件（使用 owner peer）与智能体文件（使用 openclaw peer）。上传成功后，系统会自动将原始文件归档至 {workspace_root}/archive/ 目录，并更新工作区文档以引用 Honcho 工具（honcho_profile、honcho_context 等），完成记忆系统的平滑过渡。

该 Skill 的显著优点在于其完善的安全与透明机制。所有数据上传行为均在事前进行完整披露，明确列出上传文件清单与目标地址，并要求用户两次显式确认（上传前与归档前）。文件操作具备严格的备份保护机制，任何删除操作前必须验证归档副本的成功创建，且支持同名文件自动时间戳命名避免覆盖。同时支持自托管模式，用户可通过配置 HONCHO_BASE_URL 将数据保留在本地基础设施，满足数据主权要求。代码层面使用官方 Honcho SDK，无动态代码加载或危险函数调用，开源可审计。

潜在局限性包括来源可信度为 T3 级（社区/个人开发者），虽代码通过 A 级安全认证，但非顶级企业或基金会背书。功能上依赖外部网络服务，托管模式下需将记忆数据上传至第三方云服务，可能不符合极高敏感场景要求。配置流程相对复杂，需正确设置 API 密钥或自托管环境，对非技术用户存在一定门槛。此外，迁移过程不可逆（尽管有备份），原文件系统将被 Honcho 服务替代。

适合的目标群体主要是正在使用 OpenClaw 框架且需要增强 AI 智能体长期记忆能力的开发者与高级用户，特别是那些希望从繁琐的文件记忆管理转向结构化 API 服务的团队。对于重视数据隐私但希望获得云端记忆同步能力的用户，该 Skill 提供的自托管选项极具吸引力。同时适合需要将多智能体配置集中管理的复杂 AI 应用场景。

使用该 Skill 需注意以下常规风险：网络连接稳定性影响上传成功率，建议在稳定网络环境下执行迁移；尽管有确认机制，用户仍需仔细审查上传文件列表，避免误传敏感信息；自托管模式需要额外的 Docker 与基础设施维护能力；归档文件虽提供本地备份，但长期占用磁盘空间需定期清理；插件依赖 Node.js 与 npm 环境，存在依赖版本冲突的可能性。