jvs claw平台支持四种本地文档导入方式：①客户端拖拽上传；②clawspace网页端通过客户端同步本地文件夹；③cli命令行批量注入txt/csv/jsonl结构化数据；④挂载lighthouse cos实现远程自动同步。
在JVS Claw平台中导入本地文档，是为了让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命令行批量注入结构化数据
适用于开发者或需要自动化脚本控制导入流程的场景，比如每日定时整理会议纪要、批量处理日志文本。
方法一：注入UTF-8编码的纯文本段落
在终端中执行：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路径中禁止使用中文文件夹名，否则会导致解析失败且日志无明确错误提示】
