OpenClaw配置文件上传限制

OpenClaw 处理文档、表格或资料文件时，上传限制会直接影响体验。限制太小，用户经常上传失败；限制太宽，又可能带来磁盘占用、任务超时和安全风险。比较稳妥的做法，是根据实际业务类型设置文件大小、格式白名单和临时目录清理规则。

一、为什么要限制上传文件

文件上传限制不是为了增加使用门槛，而是为了保证系统稳定。过大的文件会占用存储和内存，格式不明的文件可能无法解析，长期不清理的临时文件还会让服务器磁盘被慢慢占满。

二、先确定允许哪些文件

如果业务暂时用不到压缩包、可执行文件或未知格式，就不要放开。白名单越清晰，后续排查越简单。

三、文件大小怎么设

文件大小应结合模型能力、服务器配置和任务耗时来决定。很多文档即使成功上传，也可能在解析、切分或模型处理阶段失败。普通文档可先设置保守值，大文件则建议拆分上传。

四、上传失败怎么排查

1. 确认文件后缀是否在白名单中。
2. 检查文件大小是否超过限制。
3. 查看文件名是否包含特殊字符。
4. 确认临时目录是否有写入权限。
5. 检查服务器磁盘空间是否充足。
6. 查看入口服务是否也有限制。

五、临时目录清理

文件上传后通常会进入临时目录。如果任务执行失败、用户中断或系统没有自动清理，临时文件可能长期保留。建议设置定期清理规则，清理前确认目录只保存临时数据，不要误删正式资料和配置文件。

六、常见问题

文件上传成功但任务失败怎么办？ 说明上传环节正常，问题可能在解析、切分或模型处理阶段。

可以直接放开所有文件格式吗？ 不建议。白名单更容易控制风险，也方便排查。