必须点击「上传」按钮,文件才会被复制至~/AionClaw/workspace/uploads/并生成哈希标识供Agent调度;直接填本地路径仅适用于RPA脚本且需满足权限与路径格式硬性条件,否则报错。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要让AionClaw处理一份刚整理好的客户名单Excel,但不确定该点「上传」按钮还是直接粘贴本地路径——这两种操作在文件可见性、执行权限、后续调用逻辑上完全不同,选错会导致任务卡死或报错「文件不存在」。
上传文件的实际效果
点击界面中「上传」按钮(通常位于对话输入框上方或技能配置弹窗内),选择本地文件后,AionClaw会将该文件完整复制进其专属工作目录~/AionClaw/workspace/uploads/,并生成唯一哈希标识符关联到当前会话上下文。
这一步完成后,文件才真正进入AionClaw的调度视野;未上传的原始路径文件,即使在同一个磁盘分区,Agent也无法读取内容或触发自动化流程。
上传过程自带自动格式校验:CSV/Excel/PDF等支持类型会实时解析首百行做结构预览,若检测到编码异常(如GBK乱码)或列名含非法字符,界面上会立刻标红提示,避免后续RPA任务因字段错位失败。
提供本地路径的适用场景
在「自动化(RPA)」模块编写脚本时,可直接填写绝对路径,例如:/Users/yourname/Documents/report_final.xlsx。
该路径必须满足两个硬性条件:【AionClaw进程拥有该路径的读取权限】,且【路径不能包含中文空格或特殊符号(如&、#、[ ])】,否则执行时会抛出PermissionError或FileNotFoundError而无具体错误描述。
Mac用户需特别注意:通过访达右键「显示简介」看到的路径,若含「Macintosh HD」字样,必须手动替换为/开头的标准Unix路径;Windows用户则需把C:\改为C:/斜杠格式,反斜杠会导致解析中断。
关键区别总结与操作建议
第一步:判断任务类型——如果是对话中临时让AI分析某份文件,必须点「上传」;
第二步:如果是定时任务或RPA流程中固定读取某个目录下的最新文件,才用本地路径;
第三步:路径方式下,先在终端执行ls -l "你的路径"确认权限显示-rw-r--r--或更宽松,再填入AionClaw;
第四步:上传后的文件可在「工具管理→已上传文件」列表里查看有效期,默认保留7天,超期自动清理;
第五步:不要把同一份文件既上传又填路径——AionClaw会当作两个独立资源处理,可能造成内存重复加载或版本混淆。











