一、指令概述

该 RPA 指令用于从飞书下载指定 FileKey 对应的文件到本地指定路径，需配置飞书访问凭证、文件唯一标识（FileKey）及本地保存参数，执行后返回运行结果与最终文件路径，适用于飞书文件的本地化备份、离线使用等场景。

飞书官方开发文档参考：https://open.feishu.cn/document/server-docs/im-v1/file/get

二、调用参数配置示意

三、使用示例（下载飞书文件并自定义命名场景）

场景：从飞书下载 FileKey 为 file_**************** 的文件，保存到 “C:\Documents\” 路径下，自定义文件名为 “meeting_notes”。

参数配置：

• 指令：下载文件

• 飞书访问凭证：feishuAuthToken（通过 “获取飞书访问凭证” 指令生成的变量）

• FileKey：file_****************（提前通过 “上传文件” 指令获取的文件标识变量，关键字符已打码）

• 保存路径：C:\Documents\（或通过「选择文件夹」选取）

• 自定义保存文件名：勾选

• 文件名：meeting_notes

• 运行结果：downloadResult（自定义变量，存储下载结果）

• 文件路径：localFilePath（自定义变量，存储本地完整路径）

执行流程：

调用该 RPA 指令后，RPA 会通过 feishuAuthToken 完成飞书 API 认证，根据 FileKey 定位飞书文件并下载；下载完成后，将执行结果存入 downloadResult，并把本地完整文件路径（如 “C:\Documents\meeting_notes.mp3”）存入 localFilePath，便于后续流程（如本地文件查看、分享至其他系统）调用。

四、返回结果说明

1. 飞书 API 标准返回示例（成功场景，关键信息已打码）：

指令执行后，“运行结果” 变量（如downloadResult）会存储包含下载状态、本地路径等信息的 JSON 结果，格式如下：

2. 响应字段含义：

• success：布尔值，true 表示文件下载成功，false 表示下载失败（失败时会补充 error_msg 字段说明原因，如 “FileKey 不存在”“本地路径无写入权限”）。

• file_path：本地完整文件路径（用户信息 “niuyanfei” 已替换为 “****” 打码处理），与 “生成的变量 - 文件路径”（如localFilePath）值一致，可直接用于访问本地文件。

• content_type：文件的 MIME 类型，如 “application/octet-stream”（二进制流）、“text/plain”（纯文本）等，反映文件格式。

• http_status：HTTP 响应状态码，200 表示飞书 API 请求成功（非 200 需结合飞书官方文档排查，如401表示凭证失效、404表示文件不存在）。

3. 文件路径结果：

“生成的变量 - 文件路径”（如localFilePath）会被直接赋值为上述 file_path 字段的打码后路径（如 “C:\Users****\Desktop\test\ 新建文件夹 \MP3.mp3”），后续可通过该路径调用本地文件进行处理。

五、注意事项

1. 访问凭证有效性：“飞书访问凭证” 需具备文件下载权限且未过期（建议通过 “获取飞书访问凭证” 指令动态生成有效凭证），否则会导致 http_status=401 或 success=false。

2. FileKey 准确性：FileKey 需是飞书内真实存在的文件标识（需与目标文件一一对应，打码部分不影响标识有效性），否则会返回 success=false 且 error_msg="FileKey不存在"，http_status=404。

3. 保存路径合法性：“保存路径” 需指向本地存在且可写入的文件夹（避免系统保护路径，如 “C:\Windows\”），否则会因 “路径不存在” 或 “无写入权限” 导致 success=false。

4. 文件格式兼容性：飞书支持下载的文件格式需符合其 API 规范，若遇到特殊格式无法下载，需参考飞书官方文档确认兼容性。

六、延伸应用

可结合 RPA 的 “文件解析”“数据提取” 指令，实现飞书文件自动化下载与内容处理：例如从飞书文档库下载业务报表文件，通过本指令保存到本地后，调用文件解析指令提取关键数据，再将数据同步至企业数据库或生成可视化报表，替代人工手动下载、解析、录入的重复工作，提升数据处理效率。