File Transfer 插件参考

通过专用节点命令在已配对节点上获取、列出和写入文件。对于最大 16 MB 的二进制文件，通过 node.invoke 使用 base64 绕过 bash stdout 截断。

分发¶

• 包：@openclaw/file-transfer
• 安装方式：包含在 OpenClaw 中

表面¶

• CLI 命令：openclaw file-transfer
• 契约：tools

目录归档¶

dir_fetch 获取整个目录树，包括点文件和隐藏目录。文件传输策略会检查每个后代项；被拒绝的条目会导致整个传输被拒绝，而不是被过滤掉。路径身份、符号链接、归档大小和解压限制仍然适用。

迁移现有权限¶

升级后，旧的正向文件传输权限在你审查之前保持不活动。拒绝规则、大小限制和符号链接设置继续适用。请在 Gateway 主机上的交互式终端中运行此命令：

openclaw file-transfer approvals migrate

有关完整的标志选项和非交互式退出代码，请参阅 文件传输。

对于每个旧路径，请选择一种结果：

• 要求精确重新批准 会移除模糊权限。下次使用时会提示一次，并记录确切的节点、命令、请求路径和规范目标。
• 保留为有意通配符 会将该条目保留为操作员编写的 glob。
• 移除此权限 会删除正向条目。

使用 --dry-run 可在不写入的情况下审查计划。非交互式运行和 --json 运行从不猜测；它们会列出未解决项，并引导你返回同一交互式命令。

迁移会在确认后一次性写入新格式，并报告相邻的配置备份是否已验证。旧版 OpenClaw 无法读取迁移后的格式。若要降级，请在启动旧版本之前恢复所报告的 .bak 文件；这样做也会恢复旧的权限语义。