（1246期）honcho-setup – AI 长期记忆一键迁移工具

AI 长期记忆一键迁移工具 由 Plastic Labs 官方支持的 OpenClaw 插件，将本地文件式 AI 记忆系统迁移至 Honcho 长期记忆服务，支持托管/自托管双模式，需用户确认后上传工作区敏感文件。 使用说明 核心用法 honcho-setup 是一个 OpenClaw 生态的迁移工具，用于将传统的基于 Markdown 文件的 AI 记忆系统（USER.md、MEMORY.md、memory/ 目录等）迁移到 Honcho 长期记忆 API。整个流程分为七个步骤：安装并启用 @honcho-ai/openclaw-honcho 插件、验证 Honcho 连接（支持托管云服务和自托管本地实例）、检测遗留记忆文件、上传至 Honcho、归档原始文件、更新工作区文档引用、最终确认完成。 该 skill 支持两种运行模式：托管模式（默认连接 api.honcho.dev，需 API key）和自托管模式（用户配置 HONCHOBASEURL，无需 key）。上传时使用 Honcho SDK 的 session.uploadFile API，将用户文件（USER.md、IDENTITY.md 等）归到 owner peer，代理配置文件（SOUL.md、AGENTS.md 等）归到 openclaw peer。 显著优点 完整的安全披露机制：skill 文档包含长达数千字的 Security & Privacy Disclosure，逐条说明数据上传内容、敏感文件访问范围、网络端点、用户控制点，透明度极高。 双重用户确认：Step 3 上传前和 Step 5 归档前均需用户明确确认，且会展示完整文件列表、大小、目的地 URL，杜绝静默操作。 失败安全设计：若上传失败，绝不进行任何归档或删除操作，原始文件保持原状，防止数据丢失。 灵活的部署选项：既可用官方托管服务快速上手，也支持完全离线的 Docker 自托管，满足不同隐私合规需求。 自动备份机制：所有待删除文件先复制到 {workspace_root}/archive/，同名文件自动附加时间戳，确保可回滚。 潜在缺点与局限性 数据上传不可避免：无论托管还是自托管，用户记忆文件（可能含 PII）必须离开本地环境，对极高敏感场景仍是障碍。 依赖外部 SDK：核心功能绑定 @honcho-ai/sdk，若 SDK 出现漏洞或停更，skill 功能受影响。 文件级粒度不足：目前是全量迁移，不支持选择性排除特定文件，用户无法精细控制哪些记忆片段上传。 Node/npm 环境依赖：需要本地具备 Node.js 和 npm 环境，对纯 Python 或其他技术栈用户增加配置负担。 自托管门槛：虽然提供 Docker 方案，但仍需用户自行维护 Postgres 等依赖，运维成本不低。 适合的目标群体 使用 OpenClaw 框架且记忆文件膨胀、需要结构化长期记忆的 AI 代理开发者 希望将分散的 Markdown 记忆整合到统一 API 的团队 对数据主权有要求、愿意自建基础设施的技术型用户（自托管模式） 需要快速验证 AI 记忆产品、愿意使用托管服务的个人开发者或初创团队 使用风险 性能风险：大体积 memory/ 或 canvas/ 目录可能导致上传耗时较长，网络中断需重试。 依赖项风险：插件安装后可能因依赖解析失败需手动进入目录执行 npm install，增加故障排查成本。 数据残留风险：虽然本地有归档，但托管模式下数据一旦上传至 Honcho 云服务，删除需遵循对方数据保留策略，非即时彻底清除。 版本兼容性：Honcho SDK 版本迭代可能导致 API 变动，skill 需及时跟进维护。 原始说明 Install the @honcho-ai/openclaw-honcho plugin and migrate legacy file-based memory to Honcho. **UPLOADS WORKSPACE CONTENT TO EXTERNAL API**: Sends USER.md, MEMORY.md, IDENTITY.md, memory/, canvas/, SOUL.md, AGENTS.md, BOOTSTRAP.md, TOOLS.md, and HEARTBEAT.md contents to api.honcho.dev (managed, default) or your self-hosted HONCHO_BASE_URL. Requires user confirmation before uploading. Archives originals locally with user confirmation. Updates workspace docs to reference Honcho tools. Works with managed Honcho (requires API key) or self-hosted local instances (no key needed).