> ## Documentation Index
> Fetch the complete documentation index at: https://rpa.bazhuayu.com/helpcenter/llms.txt
> Use this file to discover all available pages before exploring further.

# 导入文件为云文档

## 1. 功能说明

将本地的 Word、TXT、Markdown（含.md/.mark/.markdown）或 HTML 文件，一键导入为飞书在线云文档。该指令内部封装了 “上传文件至飞书素材库→创建导入任务” 的完整流程，是【任务 - 创建导入任务】的简化版，同样为异步任务，需配合【任务 - 查询导入任务结果】获取最终导入状态。

## 2. 配置项说明

<img src="https://mintcdn.com/bazhuayu-rpa-docs/jgqaQu-4rHRwwb68/helpcenter/commands/custom-commands/ssmPSj2C/images/5Gso6Xqf-01.png?fit=max&auto=format&n=jgqaQu-4rHRwwb68&q=85&s=e2383c6991651678a3a9a8f42d317fa8" alt="image" width="660" height="479" data-path="helpcenter/commands/custom-commands/ssmPSj2C/images/5Gso6Xqf-01.png" />

配置项必填说明<strong>飞书访问凭证</strong>是选择已配置的飞书访问凭证，需确保对应应用已开通云文档 “导入” 和 “上传” 相关权限。<strong>文件路径</strong>是填写本地待导入文件的完整路径（如 C:\docs\项目需求.docx），或点击「选择文件」按钮直接选取文件。支持格式：.docx/.doc/.txt/.md/.mark/.markdown/.html。<strong>上传位置 Token</strong>是飞书云空间中目标文件夹的 token，导入后的云文档将存放在此文件夹下。<strong>任务 ID</strong>是存储内部生成的导入任务唯一标识（ticket），用于后续【查询导入任务结果】的入参。

<strong>底层逻辑与依赖</strong>

该指令是对飞书两个核心 API 的封装：<strong>上传素材 API</strong>：将本地文件上传至飞书素材库，获取 file\_token。<strong>创建导入任务 API</strong>：使用 file\_token 创建异步导入任务，返回 task\_id。指令会自动完成上述两步，无需手动拆分操作。

<strong>返回结果说明</strong>

指令执行后，主要通过<strong>生成的变量</strong>返回关键信息：<strong>任务 ID</strong>：存储导入任务的唯一标识（如 task\_1234567890abcdef），用于后续查询任务结果。

## 3. 示例场景

将本地 Markdown 文档导入飞书云文档：<strong>飞书访问凭证</strong>：选择已配置的凭证。<strong>文件路径</strong>：填写 C:\notes\产品说明.md（或点击「选择文件」选取该文件）。<strong>上传位置 Token</strong>：填写目标文件夹的 token（如 fldcn1234567890abcdef）。<strong>任务 ID</strong>：设置为 import\_task\_id。执行指令后，import\_task\_id 存储任务 ID，后续通过【查询导入任务结果】获取最终状态。

## 4. 注意事项

常见问题错误类型可能原因解决方案<strong>文件不存在或无权限</strong>填写的文件路径错误，或 RPA 机器人无文件读取权限核对文件路径准确性，确保机器人对目标文件有读权限。<strong>文件格式不支持</strong>上传的文件不在支持的格式列表中仅上传 Word、TXT、Markdown、HTML 格式的文件。<strong>上传位置 Token 无效</strong>目标文件夹 token 不存在或已被删除重新获取目标文件夹的有效 token。<strong>权限不足</strong>飞书应用未开通云文档上传 / 导入权限参考飞书权限配置文档，为应用添加对应权限。<strong>网络异常</strong>网络波动导致文件上传或任务创建失败检查网络连接，并重试指令。

<Info>
  使用指令过程中遇到问题？前往 [八爪鱼RPA 开发者社区问答板块](https://rpa.bazhuayu.com/community/questions) 提问，获取官方与社区帮助。
</Info>
