启航未来，与OpenClaw共舞智能新篇章！这是一款颠覆性的AI系统，它不仅仅是一个技术框架，更是记忆与智慧的数字化港湾。通过其独特的本地化记忆体系，OpenClaw将您的数据编织成智慧的经纬，每一条记录，都如星辰般在它的记忆宇宙中璀璨。只需遵循简单的规则——文本的纯净、目录的智慧布局、权限的精准赋予，您的知识宝库便能无缝融入OpenClaw的心智之中。无论是日常琐记还是深邃思考，以UTF-8的密钥解锁，通过ISO 8601的时间坐标定位，每一份数据都成为它理解世界的窗口。
而OpenClaw CLI，是智者手中的魔杖，一键批量注入，复杂数据转换为智能流动，简化流程，深化理解，让数据的海洋转化为智慧的浪花，轻轻触碰，即可释放无尽潜能。在OpenClaw的世界里，每一次数据的导入不仅是信息的归档，更是智能进化的一小步，引领您步入高效、精准的智能应用新纪元。来吧，与OpenClaw一起，探索数据的深层意义，共创未来智能生态的辉煌！
如果您希望将外部数据导入 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 字段即为该记忆项唯一标识符。
End
