Huo15 Claw Butler File Delivery
Deliver files (report, PDF, image, spreadsheet, archive, code) to 龙虾管家 client via file.push node, avoiding failed WebChat file sends.
给龙虾管家客户端发文件(file.push)
龙虾管家(Claw Butler)客户端通过 WebChat 通道连接。WebChat 是 OpenClaw 的内部通道,不支持出站文件投递 —— 你若想用普通消息附带文件,会得到 Delivering to WebChat is not supported / 客户端只看到 Message failed,或文件退化成一个打不开的链接。
正确做法:用客户端的 file.push node 能力把文件推过去。 客户端收到后会自动内联预览(图片 / PDF / Markdown / 代码 / 音视频),并让用户一键保存到设备。
何时用
- 用户要任何文件:报告、PDF、图片、Excel、导出、压缩包、代码包。
- 你已经在工作目录产出了文件,需要交付给用户。
- 你刚试着“发文件”失败了(Message failed / 只显示成链接)→ 立刻改用本能力重发。
怎么调用
用 nodes 工具,action: "invoke",命令 file.push:
nodes(
action="invoke",
node="<目标客户端,单设备可用 auto>",
invokeCommand="file.push",
invokeParamsJson="{...见下...}"
)
invokeParamsJson 是一段 JSON 字符串,字段:
| 字段 | 说明 |
|---|---|
fileName | 文件名(带扩展名,决定预览类型)。必填。 |
mimeType | MIME 类型,如 application/pdf、image/png、text/markdown。建议填。 |
contentBase64 | 小文件(≤ ~48MB):文件字节的 base64。 |
url | 大文件:先把文件传到可访问地址(公司 OSS 等),再推 HTTP(S) URL,客户端自取。 |
contentBase64 与 url 二选一:小文件走 base64(不依赖外网),大文件走 url(避免一次性塞爆连接)。
例子
小文件(内联 base64):
nodes(action="invoke", node="auto", invokeCommand="file.push",
invokeParamsJson="{\"fileName\":\"周报.pdf\",\"mimeType\":\"application/pdf\",\"contentBase64\":\"JVBERi0xLjQ...\"}")
大文件(OSS 中转):
nodes(action="invoke", node="auto", invokeCommand="file.push",
invokeParamsJson="{\"fileName\":\"数据集.zip\",\"mimeType\":\"application/zip\",\"url\":\"https://huo15-odoo.oss-cn-qingdao.aliyuncs.com/exports/数据集.zip\"}")
成功返回 { ok: true, payload: { received: true, fileName } },用户端会弹出预览。
红线
- ❌ 不要用普通消息 / WebChat 出站投递文件(必失败)。
- ❌ 不要把远程机器上的本地路径(
/home/...、media://...)直接当链接发给用户 —— 客户端拿不到,必死链。改用file.push:小文件 base64、大文件先传 OSS 再推 url。 - ✅ 大文件优先
url模式;contentBase64仅用于小文件。 - 前提:客户端已配对,且未在权限里关闭“接收文件 / Receive Files”(默认开启)。
- Downloads
- 559All time
- Security audit
- Pass
- Last updated
- 4mo ago
- Current version
- v1.0.0
- License
- MIT-0
