核心用法
chatgpt-import 是一套用于将 ChatGPT 对话历史迁移至 OpenClaw 记忆检索系统的完整工作流技能。用户需先从 ChatGPT 导出 conversations.json,通过 Python 脚本转换为 Markdown 格式,再调用 OpenAI API 生成向量嵌入并存入 SQLite 数据库,最后配置 OpenClaw 的 memorySearch.extraPaths 参数即可启用检索。
显著优点
- 无缝迁移:保留完整对话上下文,支持复杂历史查询
- 成本低廉:约 2,400 条对话仅需 $0.15(text-embedding-3-small)
- 灵活过滤:可通过
--min-messages筛除无价值短对话 - 安全设计:API 密钥不持久化存储,输出库强制防覆盖
潜在局限
- 依赖 OpenAI API:需有效密钥且产生外部调用费用
- 隐私风险:敏感对话内容需人工预处理或限制 API 权限范围
- 技术门槛:需要命令行操作与 YAML 配置能力
- 无实时同步:一次性导入,非持续增量同步机制
适合人群
- 长期 ChatGPT 用户寻求历史对话的集中化检索
- 企业/团队需要构建可搜索的知识库归档
- 开发者熟悉 CLI 工具与向量数据库基础概念
常规风险
- 敏感数据通过第三方 API 传输需合规审查
- 导出文件
conversations.json本地存储期间的安全管理 - 向量嵌入模型的选择与成本控制(模型升级可能产生额外费用)