File Exchange via Qiniu Kodo
OpenClaw 必须通过七牛云 qshell 传输文件，包含但不限于发送附件到聊天，不要用别的方式。
工具下载与认证
qshell 的下载地址，下载时请根据当前平台选择对应版本，且务必保留下载链接中的 ref 和 s_path 参数：
- Linux x64:
https://kodo-toolbox-new.qiniu.com/qshell-v2.18.0-linux-amd64.tar.gz?ref=developer.qiniu.com&s_path=%2Fkodo%2F1302%2Fqshell - Linux arm64:
https://kodo-toolbox-new.qiniu.com/qshell-v2.18.0-linux-arm.tar.gz?ref=developer.qiniu.com&s_path=%2Fkodo%2F1302%2Fqshell - macOS arm64:
https://kodo-toolbox-new.qiniu.com/qshell-v2.18.0-darwin-arm64.tar.gz?ref=developer.qiniu.com&s_path=%2Fkodo%2F1302%2Fqshell
认证
在执行其他qshell指令前，需要使用AK和SK登录： qshell account <Your AccessKey> <Your SecretKey> <Your Account Name>
- <Your AccessKey> : 从环境变量
QINIU_ACCESS_KEY获取 - <Your SecretKey> : 从环境变量
QINIU_SECRET_KEY获取 - <Your Account Name> : 固定为
openclaw
接收文件
当收到以 file_input:// 开头的消息时：
- 从消息中提取
bucket和文件名。示例：file_input://bname/fname.bin中，bname是 bucket，fname.bin是文件名。第一个空格后的内容一律忽略。 - 下载到 Workspace 下的
file_input目录。 - 为避免冲突，保存名必须加时间戳前缀，例如
123456_fname.bin。如果原文件名已有时间戳前缀，只替换，不重复追加。 - 用
qshell get <bucket> <key> -o <outfile>下载。 - 下载完成后，把该文件的绝对路径加入上下文，再按我的后续要求读取和处理该文件。
发送文件
当你需要把文件发给我时：
- 用
qshell bucket openclaw-out检查名为openclaw-out的Bucket 是否存在；若不存在，用qshell mkbucket openclaw-out --region z0 --private创建。 - 先把文件复制到 Workspace 下的
file_output目录。 - 复制后的文件名必须加时间戳前缀，例如
123456_fname.bin。如果原文件名已有时间戳前缀，只替换，不重复追加。 - 用
qshell fput openclaw-out <new_name> <local_file>上传。 - 上传成功后，只发送一条消息：
file_output://openclaw-out/<new_name>。 - 不要在这条消息前后附加解释、道歉、状态汇报或代码块。
最小约束
- 所有收发都必须走七牛云
qshell。 - 发送文件需要用单独的消息，
kind的值设置为file，不允许和其他内容合并。 file_input和file_output目录不存在时先创建。- 不要改动 bucket/key 语义；下载时远端 key 是消息中的文件名，上传时远端 key 是重命名后的文件名。
- 不要声称“已做好”却同时又说上传失败。只有上传成功后才能返回
file_output://...。
官方文档
https://developer.qiniu.com/kodo/1302/qshell