openclaw支持四种数据导入方式：一、本地文件系统写入记忆目录，需utf-8编码txt文件并配置权限；二、cli工具批量注入csv/jsonl格式数据；三、挂载lighthouse cos实现远程同步；四、调用/v1/memory/push api实时提交json结构化数据。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您希望将外部数据导入 OpenClaw 系统以支持记忆增强、任务执行或内容生成，但发现数据无法被识别或加载失败，则可能是由于文件格式不兼容、路径配置错误或权限缺失所致。以下是实现 OpenClaw 数据上传与正确格式适配的具体操作步骤：
一、通过本地文件系统直接写入记忆目录
OpenClaw 的记忆类数据采用本地化、文件驱动架构，所有记忆内容均以纯文本形式存储在指定目录中，系统启动时自动扫描并索引。该方式无需网络传输，适合结构清晰、人工整理过的原始数据。
1、确认 OpenClaw 当前记忆根目录路径，通常为 /home/lighthouse/openclaw/memory 或通过 config.yaml 中的 memory.base_path 字段查得。
2、在该目录下创建子文件夹，如 daily（用于每日记忆）或 longterm（用于长期记忆）。
3、将待导入的文本文件保存为 UTF-8 编码的 .txt 文件，文件名建议使用英文或数字，避免空格与特殊符号，例如 meeting_notes_20260305.txt。
4、确保文件内容每段以空行分隔，且单段长度不超过 2000 字符；若含时间信息，推荐首行以 ISO 8601 格式标注，例如 2026-03-05T14:22:00Z。
5、执行命令 sudo chown -R lighthouse:lighthouse /home/lighthouse/openclaw/memory，确保 OpenClaw 进程拥有读取权限。
二、使用 OpenClaw CLI 工具批量注入
OpenClaw 内置命令行工具 openclaw-cli 提供标准化数据注入接口，可自动解析语义结构、添加时间戳并触发向量化入库，适用于需保留上下文关系的大批量文本导入场景。
1、进入 OpenClaw 主程序所在目录，例如 /home/lighthouse/openclaw。
2、运行命令 npx openclaw-cli memory inject --source ./data/import_batch.csv --format csv，其中 csv 文件需包含至少两列：content（必填）和 timestamp（可选，ISO 格式）。
3、若导入 JSONL 格式（每行一个 JSON 对象），则使用参数 --format jsonl，且每行必须含 content 字段，例如 {"content":"项目A需求已确认","tags":["product","review"]}。
4、执行完成后，CLI 将输出成功写入条目数及首个嵌入向量哈希值，例如 Injected 142 items, first vector hash: a7f3e9b2。
三、挂载 Lighthouse COS 存储桶后同步远程数据
当数据规模超过本地磁盘容量或需多实例共享记忆源时，可通过挂载轻量对象存储 Lighthouse COS 实现集中式数据托管。OpenClaw 启动后会将挂载路径视作普通本地目录进行扫描，无需修改代码逻辑。
1、登录腾讯云轻量应用服务器控制台，在【对象存储】卡片页点击「挂载存储桶」。
2、选择与服务器同地域的存储桶，并设置挂载参数：存储桶挂载目录填 /cos-memory，服务器挂载目录填 /home/lighthouse/cos-memory，授权类型选「匿名读取」。
3、挂载成功后，在 COS 控制台对应存储桶内创建文件夹 openclaw/daily，上传 UTF-8 编码的 .txt 文件，文件名须符合 YYYYMMDD_HHMMSS_content_summary.txt 命名规范。
4、编辑 OpenClaw 配置文件 config.yaml，将 memory.base_path 修改为 /home/lighthouse/cos-memory/openclaw，并重启服务。
5、验证挂载有效性：执行 ls -l /home/lighthouse/cos-memory/openclaw/daily，应可见已上传文件列表且无权限拒绝提示。
四、通过 API 接口实时提交结构化数据
对于需要与业务系统集成的场景，OpenClaw 提供 HTTP POST 接口 /v1/memory/push，支持 JSON 格式实时推送单条记忆记录。该方式绕过文件系统，适用于日志采集、表单提交等低延迟要求场景。
1、确认 OpenClaw 服务已启用 API 模式，且 config.yaml 中 api.enabled 设置为 true，端口默认为 18789。
2、构造请求头：Content-Type 必须为 application/json，Authorization 字段填入配置生成的 Token，例如 Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...。
3、请求体 JSON 必须包含 content 字符串字段，可选字段包括 category（字符串）、tags（字符串数组）、timestamp（ISO 8601 时间字符串）。
4、使用 curl 发送示例请求：curl -X POST http://localhost:18789/v1/memory/push -H "Content-Type: application/json" -H "Authorization: Bearer YOUR_TOKEN" -d '{"content":"客户张三反馈支付失败","category":"support","tags":["payment","error"]}'。
5、响应状态码为 201 时表示成功入库，返回 JSON 中 id 字段即为该记忆项唯一标识符。
