/install file-exchange-via-qiniu-kodo
File Exchange via Qiniu Kodo\r
\r
OpenClaw 必须通过七牛云 qshell 传输文件,包含但不限于发送附件到聊天,不要用别的方式。\r
\r
工具下载与认证\r
\r
qshell 的下载地址,下载时请根据当前平台选择对应版本,且务必保留下载链接中的 ref 和 s_path 参数:\r
\r
- 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\r - 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\r - 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\r \r
认证\r
\r
在执行其他qshell指令前,需要使用AK和SK登录: qshell account \x3CYour AccessKey> \x3CYour SecretKey> \x3CYour Account Name>\r
\r
- \x3CYour AccessKey> : 从环境变量
QINIU_ACCESS_KEY获取\r - \x3CYour SecretKey> : 从环境变量
QINIU_SECRET_KEY获取\r - \x3CYour Account Name> : 固定为
openclaw\r \r
接收文件\r
\r
当收到以 file_input:// 开头的消息时:\r
\r
- 从消息中提取
bucket和文件名。示例:file_input://bname/fname.bin中,bname是 bucket,fname.bin是文件名。第一个空格后的内容一律忽略。\r - 下载到 Workspace 下的
file_input目录。\r - 为避免冲突,保存名必须加时间戳前缀,例如
123456_fname.bin。如果原文件名已有时间戳前缀,只替换,不重复追加。\r - 用
qshell get \x3Cbucket> \x3Ckey> -o \x3Coutfile>下载。\r - 下载完成后,把该文件的绝对路径加入上下文,再按我的后续要求读取和处理该文件。\r \r
发送文件\r
\r 当你需要把文件发给我时:\r \r
- 用
qshell bucket openclaw-out检查名为openclaw-out的Bucket 是否存在;若不存在,用qshell mkbucket openclaw-out --region z0 --private创建。\r - 先把文件复制到 Workspace 下的
file_output目录。\r - 复制后的文件名必须加时间戳前缀,例如
123456_fname.bin。如果原文件名已有时间戳前缀,只替换,不重复追加。\r - 用
qshell fput openclaw-out \x3Cnew_name> \x3Clocal_file>上传。\r - 上传成功后,只发送一条消息:
file_output://openclaw-out/\x3Cnew_name>。\r - 不要在这条消息前后附加解释、道歉、状态汇报或代码块。\r \r
最小约束\r
\r
- 所有收发都必须走七牛云
qshell。\r - 发送文件需要用单独的消息,
kind的值设置为file,不允许和其他内容合并。\r file_input和file_output目录不存在时先创建。\r- 不要改动 bucket/key 语义;下载时远端 key 是消息中的文件名,上传时远端 key 是重命名后的文件名。\r
- 不要声称“已做好”却同时又说上传失败。只有上传成功后才能返回
file_output://...。\r \r
官方文档\r
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install file-exchange-via-qiniu-kodo - 安装完成后,直接呼叫该 Skill 的名称或使用
/file-exchange-via-qiniu-kodo触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
File Exchange via Qiniu Kodo 是什么?
Transfer files exclusively through Qiniu Kodo using qshell commands for downloading and uploading with timestamped filenames in specific directories. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 101 次。
如何安装 File Exchange via Qiniu Kodo?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install file-exchange-via-qiniu-kodo」即可一键安装,无需额外配置。
File Exchange via Qiniu Kodo 是免费的吗?
是的,File Exchange via Qiniu Kodo 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
File Exchange via Qiniu Kodo 支持哪些平台?
File Exchange via Qiniu Kodo 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 File Exchange via Qiniu Kodo?
由 宁伟(@kadbbz)开发并维护,当前版本 v1.0.0。