QClaw文件处理存在多重体积限制：图片单张限5MB；本地文件系统支持达16TB但AI解析暂限500MB内；腾讯文档受32768 token限制；ima知识库超100MB仅索引标题摘要。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 QClaw 处理文件时遇到上传失败、提示尺寸异常或操作中断，很可能是所选文件体积超出了当前功能模块的承载阈值。以下是针对 QClaw 文件处理能力限制的具体说明与应对方式：
一、图片附件上传大小限制
QClaw 当前对单张图片附件实施硬性体积上限管控，该限制源于系统级安全与传输稳定性设计。超出阈值将直接触发拦截并返回明确错误码。
1、系统强制设定的单图上限为 5000000 字节（即 5MB）；
2、实际上传失败案例中，常见报错内容为：Error: attachment image: exceeds size limit (6765925 > 5000000 bytes)；
3、该数值对应原始文件大小约 6.45MB，超出限制约 1.45MB。
二、文件空间功能支持的本地文件范围
“文件空间”作为 QClaw 新上线的核心模块，其设计目标是打通本地存储与云端协作生态，但并未改变底层文件读取与加载的物理约束。该模块依赖操作系统原生文件接口，因此实际可处理文件尺寸受制于宿主环境。
1、Windows 平台下，QClaw 可正常加载并解析的单个本地文件，理论上限与 NTFS 文件系统一致，即 16TB；
2、macOS 平台下，受限于 APFS 文件系统特性，单文件支持上限同样达 16TB；
3、但需注意：即便文件系统允许，QClaw 当前版本对超大文件（如 >500MB）的解析、分块读取及 AI 处理尚未开放完整支持，可能出现响应延迟或内存溢出。
三、腾讯文档与 ima 知识库接入限制
通过“文件空间”调用腾讯文档或 ima 知识库内容时，QClaw 实际操作的是远程资源引用链接与元数据，而非整份原始文件下载。因此该路径不直接受限于本地体积，但存在服务端协同策略约束。
1、腾讯文档内嵌内容被拉入 QClaw 对话框后，AI 可处理的文本段落长度受模型上下文窗口限制，当前默认上限为 32768 token；
2、ima 知识库中单个文档若为 PDF 或 Word 格式，QClaw 支持解析其文字内容，但图像密集型 PDF（含高分辨率扫描页）可能因 OCR 耗时过长而中断处理流程；
3、知识库中单文件若体积超过 100MB，系统将自动跳过全文索引，仅保留标题与摘要供检索。
四、规避超限问题的三种实操方法
当您需要处理超出当前限制的文件时，可采用以下任一方式绕过体积瓶颈，确保任务连续执行。
1、对原始图片执行无损压缩：使用系统自带画图工具或第三方软件（如 XnConvert）将 PNG/JPEG 图像压缩至 ≤5MB，同时保持视觉可用性；
2、拆分超大文档：将单个 >500MB 的 Excel 或 PPT 文件按工作表或幻灯片页数分割为多个子文件，再逐个提交至 QClaw 执行分析；
3、改用链接式输入：将大文件上传至腾讯微云或企业 NAS，生成公开/授权链接后，在 QClaw 指令中直接提供 URL，由其调用流式加载接口进行轻量解析。
