将本地文档导入JVS Claw平台，总共包含四种主流方式。第一种，直接在客户端内拖拽上传；第二种，通过ClawSpace网页端配合客户端同步文件夹实现；第三种，利用CLI命令行批量处理TXT、CSV或JSONL格式文件；最后一种，挂载Lighthouse COS存储桶实现远程自动同步。核心目标始终一致——让Clawbot能够读取您的私有资料，进而完成智能分析、归档与问答功能。如果文件无法进入Clawbot的存储空间，后续所有高级智能操作都将无法正常运行。
通过JVS Claw客户端直接拖拽上传
从视觉体验来看，这是最直观的操作方式。适用于单次、少量文件的快速处理，无需接触命令行或复杂配置。前提条件较为简单：已在Mac或Windows系统上安装客户端并成功登录。
操作流程如下：打开JVS Claw桌面客户端 → 确认左下角显示“在线”状态 → 将PDF、TXT、DOCX、PPTX、XLSX等文件直接拖拽至主界面中央的虚线框区域 → 松开鼠标，上传和解析流程便会自动启动。
需要留意一个小细节：拖入文件前，请确保文件未被其他程序占用。例如，如果PDF正被预览应用打开、Excel表格仍处于编辑状态，上传过程会卡在“准备中”阶段，既不报错也不推进。务必避免这个常见陷阱。
上传完成后，文件会自动出现在“我的文档库”中。Clawbot后台会立即执行文本提取和向量索引构建，通常在3秒内即可响应自然语言查询请求。
通过ClawSpace网页端同步至云端文档库
网页端本身无法直接上传本地文件，需要借助已安装的JVS Claw客户端作为中转桥梁。
详细步骤说明如下：
第一步：在Mac或Windows系统上运行JVS Claw客户端，绑定账号并授权“文件管理权限”；
第二步：点击客户端右上角的【同步】按钮 → 选择“同步本地文件夹” → 指定您存放文档的目录，例如~/Downloads/学习资料；
第三步：勾选“启用增量扫描”选项 → 点击【开始同步】→ 客户端会持续监控该目录，新增或修改的文件将自动上传；
第四步：登录clawspace.aliyun.com → 进入【我的文档库】→ 查看同步状态和文件列表。
必须确保客户端始终处于运行状态，并且网络连接稳定——否则同步任务将无法触发。
该同步机制支持断点续传，但初次全量同步大型文件夹（超过500MB）时，建议保持客户端后台常驻，避免电脑进入休眠模式，以免连接中断。
使用CLI命令行批量注入结构化数据
这条路径适合开发者或希望实现自动化脚本的用户。例如，每日定时整理会议纪要、批量处理日志文本等场景。操作直接，效率极高。
三种典型应用方式：
方法一：注入纯文本段落
在终端执行以下命令：openclaw-cli memory inject --source ./notes/*.txt --format txt。系统会按空行切分段落，并为每个段落独立执行向量化处理。
方法二：注入带元信息的CSV数据
准备一个CSV文件，第一行必须包含content,tags,timestamp字段。其中content为必填项，timestamp需采用ISO 8601格式（例如2026-06-29T10:30:00Z）。然后执行：openclaw-cli memory inject --source ./data/reports.csv --format csv。
方法三：推送JSONL格式的流式数据
每行一个JSON对象，必须包含content字段，metadata为可选字段，可用于标注来源、作者、分类等信息。执行命令：openclaw-cli memory inject --source ./data/stream.jsonl --format jsonl。
所有CLI命令执行完毕后，终端会显示写入的条目数量以及首个向量的哈希值。例如Injected 87 items, first vector hash: d4e2a1c9，可据此校验数据完整性。
挂载Lighthouse COS实现远程自动同步
这是面向企业级部署的理想方案。前提条件：已在腾讯云Lighthouse上创建COS存储桶，并完成读写权限策略的配置。
操作流程较为直接：在JVS Claw服务端的config.yaml配置文件中，启用COS挂载模块。将storage.type设置为cos，然后填写cos.region、cos.bucket、cos.secretId、cos.secretKey等参数。修改完成后，重启ClawRuntime服务使配置生效。
配置成功后，只需将PDF、TXT、DOCX文件上传至指定的COS路径（例如claw-input/2026/Q2/），Clawbot会在30秒内自动拉取、解析并入库，全程无需人工干预。
COS路径中请勿使用中文文件夹名称——否则解析会失败，且日志中不会出现明确的错误提示，排查难度较大。
