{"id":"d8ba8ec2-5c65-4fa3-8bed-2bb9579d212d","entityType":"agent","slug":"clawhub-autogame-17-feishu-drive","name":"feishu-drive","canonicalUrl":"https://www.xpersona.co/agent/clawhub-autogame-17-feishu-drive","canonicalPath":"/agent/clawhub-autogame-17-feishu-drive","generatedAt":"2026-10-10T02:10:11.555Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"description":"Manage Feishu Drive files and folders with upload, download, move, search, metadata retrieval, and access permission syncing. Skill: feishu-drive Owner: autogame-17 Summary: Manage Feishu Drive files and folders with upload, download, move, search, metadata retrieval, and access permission syncing. Tags: latest:1.0.0 Version history: v1.0.0 | 2026-02-13T06:56:09.673Z | user **Major change: Simplified skill structure and transitioned to template-driven card system.** - Replaced all code and CLI scripts with static interactive card templates.","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 825 downloads reported by the source. Last updated 4/15/2026.","installCommand":"clawhub skill install kn7apafdj4thknczrgxdzfd2v1808svf:feishu-drive","sourceUrl":"https://clawhub.ai/autogame-17/feishu-drive","homepage":"https://clawhub.ai/autogame-17/feishu-drive","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/autogame-17/feishu-drive","kind":"source"}],"safetyScore":84,"overallRank":62,"popularityScore":58,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Manage Feishu Drive files and folders with upload, download, move, search, metadata retrieval, and access permission syncing. Skill: feishu-drive Owner: autogam"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"stars":null,"forks":null,"downloads":825,"packageName":null,"latestVersion":"1.0.0","tractionLabel":"825 downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-03-01T02:11:00.556Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T00:45:39.800Z","lastCrawledAt":"2026-03-01T02:11:00.556Z","lastIndexedAt":null,"nextCrawlAt":"2026-03-02T02:11:00.556Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.0","createdAt":"2026-02-13T06:56:09.673Z","changelog":"**Major change: Simplified skill structure and transitioned to template-driven card system.** - Replaced all code and CLI scripts with static interactive card templates. - Added example card JSONs: morning briefing, alert, and skill test result. - Removed code files, persona CLI wrappers, and documentation for sending text-based or persona messages. - SKILL.md rewritten to focus on API-driven usage, card structure, available templates, and integration best practices. - Clarifies current limitation (no card callback event handling yet) and recommends text fallback for user interaction.","fileCount":2,"zipByteSize":4991}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install kn7apafdj4thknczrgxdzfd2v1808svf:feishu-drive","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-autogame-17-feishu-drive/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-autogame-17-feishu-drive/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-autogame-17-feishu-drive/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-autogame-17-feishu-drive/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-autogame-17-feishu-drive/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-autogame-17-feishu-drive/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T02:10:11.555Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-autogame-17-feishu-drive/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-autogame-17-feishu-drive/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-autogame-17-feishu-drive/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-autogame-17-feishu-drive/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"readme":"Skill: feishu-drive\n\nOwner: autogame-17\n\nSummary: Manage Feishu Drive files and folders with upload, download, move, search, metadata retrieval, and access permission syncing.\n\nTags: latest:1.0.0\n\nVersion history:\n\nv1.0.0 | 2026-02-13T06:56:09.673Z | user\n\n**Major change: Simplified skill structure and transitioned to template-driven card system.**\n\n- Replaced all code and CLI scripts with static interactive card templates.\n- Added example card JSONs: morning briefing, alert, and skill test result.\n- Removed code files, persona CLI wrappers, and documentation for sending text-based or persona messages.\n- SKILL.md rewritten to focus on API-driven usage, card structure, available templates, and integration best practices.\n- Clarifies current limitation (no card callback event handling yet) and recommends text fallback for user interaction.\n\nArchive index:\n\nArchive v1.0.0: 2 files, 4991 bytes\n\nFiles: SKILL.md (10062b), _meta.json (131b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: feishu-drive\ndescription: 飞书云空间文件管理 Skill。上传/下载/移动/搜索文件、创建文件夹、获取元数据等。当需要管理飞书云空间中的文件和文件夹时使用此 Skill。\nrequired_permissions:\n  - drive:file:upload\n  - drive:file:download\n  - drive:drive:readonly\n  - drive:drive.search:readonly\n  - space:folder:create\n  - space:document:move\n\n# 🚀 快速启动：三步打通云空间 (必读)\n为避免机器人文件进入“私有黑盒”，请在首次使用前完成以下配置：\n1. **创建锚点**：在您的飞书云空间创建一个文件夹（如 `AI-Workspace`）。\n2. **授权机器人**：在文件夹的【协作】设置中，搜索并添加您的应用（机器人）为【管理】或【编辑】权限。\n3. **设置 Token**：复制该文件夹 URL 中的 Token，配置为 Skill 的 `ROOT_FOLDER_TOKEN`。\n4. **冒烟测试**：调用 `batch_query` 接口查询该 Token 元数据。若返回 200 则配置成功；若返回 403/404 则检查应用可见性或授权是否到位。\n---\n\n# 飞书云空间文件管理\n\n你是飞书云空间文件管理专家，负责通过 API 实现文件的上传、下载、移动、搜索和元数据管理。\n\n---\n\n## 一、API 基础信息\n\n| 项目 | 值 |\n|------|---|\n| Base URL | `https://open.feishu.cn/open-apis/drive/v1` |\n| 认证方式 | `Authorization: Bearer {tenant_access_token}` |\n| Content-Type | `application/json`（文件上传用 `multipart/form-data`） |\n\n---\n\n## 二、文件夹操作\n\n### 1. 创建文件夹\n\n```\nPOST /open-apis/drive/v1/folders\n```\n\n```json\n{ \"name\": \"文件夹名\", \"folder_token\": \"root\" }\n```\n\n**实测心法**：\n1. `folder_token` 为父文件夹 ID，`root` 表示根目录。\n2. **可见性保障 (重要)**：通过 API 创建的文件夹默认只对机器人可见。**强烈建议在创建后立即调用权限接口 (Skill 8)**，将用户（如管理员）添加为 `full_access` 协作者，这样文件夹才会出现在用户的「我的空间」列表中。\n3. **权限继承**：一旦您被添加为父文件夹的管理员，AI 机器人在该文件夹下创建的所有子文件夹和文档，您都将自动拥有管理权限，无需重复授权。\n\n---\n\n## 三、文件上传\n\n### 2. 上传文件（小文件一次性上传）\n\n```\nPOST /open-apis/drive/v1/files/upload_all\nContent-Type: multipart/form-data\n```\n\n表单字段：\n\n| 字段 | 说明 |\n|------|------|\n| `file` | 文件二进制内容 |\n| `file_name` | 文件名（如 `report.pdf`） |\n| `parent_type` | 父节点类型（`explorer` = 云空间，`bitable_file` = 多维表格附件） |\n| `parent_node` | 父节点 token（文件夹 token 或 app_token） |\n| `size` | 文件大小（字节） |\n\n**实测心法**：大文件建议使用分片上传接口。\n\n### 3. 分片上传（大文件）\n\n**第 1 步：准备上传**\n\n```\nPOST /open-apis/drive/v1/files/upload_prepare\n```\n\n```json\n{\n  \"file_name\": \"large_file.zip\",\n  \"parent_type\": \"explorer\",\n  \"parent_node\": \"fldcnXXX\",\n  \"size\": 104857600\n}\n```\n\n返回 `upload_id` 和分片信息。\n\n**第 2 步：逐片上传**\n\n```\nPOST /open-apis/drive/v1/files/upload_part\nContent-Type: multipart/form-data\n```\n\n**第 3 步：完成上传**\n\n```\nPOST /open-apis/drive/v1/files/upload_finish\n```\n\n---\n\n## 四、文件下载\n\n### 4. 下载文件\n\n```\nGET /open-apis/drive/v1/files/:file_token/download\n```\n\n**实测心法**：流式读取响应体，注意保存路径。返回的是二进制流。\n\n---\n\n## 五、文件操作\n\n### 5. 移动文件\n\n```\nPOST /open-apis/drive/v1/files/:file_token/move\n```\n\n```json\n{ \"type\": \"docx\", \"folder_token\": \"fldcn...\" }\n```\n\n**实测心法**：需要同时拥有源文件夹和目标文件夹的权限。\n\n### 6. 复制文件\n\n```\nPOST /open-apis/drive/v1/files/:file_token/copy\n```\n\n```json\n{ \"type\": \"bitable\", \"folder_token\": \"fldcn...\", \"name\": \"副本名称\" }\n```\n\n**实测心法**：适用于从模板快速克隆多维表格、文档等。\n\n---\n\n## 六、文件查询\n\n### 7. 获取文件元数据（批量）\n\n```\nPOST /open-apis/drive/metadata/batch_query\n```\n\n```json\n{\n  \"metadatas\": [\n    { \"token\": \"...\", \"type\": \"docx\" }\n  ]\n}\n```\n\n**实测心法**：支持批量查询，效率更高。可获取文件所有者、创建时间等。\n\n### 8. 搜索文件\n\n```\nPOST /open-apis/drive/v1/files/search\n```\n\n```json\n{ \"search_word\": \"关键词\" }\n```\n\n**实测心法**：搜索结果包含文档、表格及文件夹。\n\n---\n\n## 七、安全与审计\n\n### 9. 获取文件下载记录\n\n```\nGET /open-apis/drive/v1/files/:file_token/view_records\n```\n\n**实测心法**：用于监控敏感文件的流向，建立内部合规审计流。\n\n### 10. 管理安全标签\n\n```\nPOST /open-apis/drive/v1/files/:file_token/security_labels\n```\n\n**实测心法**：为核心文档打上\"绝密\"标签，限制二次转发。飞书企业版的核心安全能力。\n\n---\n\n## 八、权限管理矩阵 (协作流核心)\n\n**关键教训 (2026-02-10)**：机器人创建的文件默认对用户不可见。必须在每个写操作后手动补齐权限。\n\n| 目标权限 | `external_access_entity` | `link_share_entity` | `security_entity` |\n| :--- | :--- | :--- | :--- |\n| **组织内可阅读** | `closed` | `tenant_readable` | `anyone_can_view` |\n| **组织内可编辑** | `closed` | `tenant_editable` | `anyone_can_edit` |\n| **互联网公开阅读** | `open` | `anyone_readable` | `anyone_can_view` |\n| **互联网公开编辑** | `open` | `anyone_editable` | `anyone_can_edit` |\n\n**AI Agent 准则**：\n1. **文件夹优先**：严禁在机器人的根目录创建孤立文件。必须指定一个用户可见的 `parent_node`（如共享文件夹）。\n2. **写后必授**：调用 `upload_all`、`copy` 或 `create_docx` 后，**必须紧接着调用权限接口**，将请求者添加为 `full_access` 协作者，否则用户在云盘主目录无法管理该资产。\n3. **冒烟先行**：在执行任何 Drive 写入指令前，AI Agent 应先静默校验 `ROOT_FOLDER_TOKEN` 的可用性。若失效，应立即推送“配置引导”卡片而非报错。\n\n---\n\n## 九、错误处理\n\n| 错误码 | 含义 | 解决方案 |\n|--------|------|---------|\n| 0 | 成功 | — |\n| 1061001 | 文件不存在 | 检查 file_token |\n| 1061002 | 无权限 | 检查应用权限和文件夹授权 |\n| 1061045 | 文件大小超限 | 使用分片上传 |\n| 99991663 | token 过期 | 重新获取 tenant_access_token |\n\n\n---\n\n\n# feishu-drive 技能总结 (教程脱敏版)\n\n### 一、 核心功能清单\n\n| 功能维度 | 具体能力 | 说明 |\n| :--- | :--- | :--- |\n| **空间管理** | 文件夹自动化 | 支持在指定的共享空间内自动创建多级子文件夹，实现资产的结构化组织。 |\n| **资产同步** | 跨空间克隆与上传 | 支持将本地文件（如 PPT/PDF）一键上传，或将云端标准模版（如 PRD）跨目录克隆到目标空间。 |\n| **感知与检索** | 智能元数据查询 | 提供高效的文件元数据批量查询与关键词模糊搜索能力，解决资产定位难题。 |\n| **协作安全性** | 权限自愈逻辑 | 在文件生成后自动同步指定用户的管理权限，打通“机器人-人类”之间的空间可见性隔阂。 |\n\n---\n\n### 二、 典型业务场景\n\n**新项目资产中心自动构建：**\n*   **场景**：当公司启动新业务线（如：海外市场调研）时，AI 自动根据项目名称在团队云盘创建对应的资料库，并将预设的调研模版、汇报 PPT 等基础物料自动分发至该目录下。\n*   **价值**：确保项目启动初期资产不乱放，实现“开箱即用”的项目环境。\n\n**营销物料自动化分发与归档：**\n*   **场景**：内容团队完成设计稿后，AI 自动将物料同步至外包共享文件夹，并一键开启“互联网公开编辑”权限，方便供应商即刻查阅。\n*   **价值**：省去手动修改成百上千个文件权限的繁琐，极大缩短协作链路。\n\n**财务/法务文档智能备份：**\n*   **场景**：系统自动汇总所有支付凭证或合同初稿，按月度/年度分门别类地归档至云空间，并自动对关键人员开放管理权限。\n*   **价值**：实现数字化审计痕迹的自动留存，确保存档的完整性。\n\n---\n\n### 三、 实测注意事项（教程必写 · 尽量详细）\n\n**权限“黑盒”隔阂 (Critical)：**\n*   **风险**：飞书机器人通过 API 创建的文件，默认所有者是“机器人”，用户在“我的空间”或“主目录”中无法看到，导致资产“失踪”。\n*   **对策**：教程必须强调 **“写后必授”** 原则。即在上传或克隆操作后，必须紧跟一个 `permissions` 接口调用，将相关负责人添加为 `full_access` 协作者。只有这样，文件才会出现在用户的「与我共享」列表中。\n\n**指定“空间锚点”原则：**\n*   **坑点**：严禁让机器人在根目录（root）随意创建文件，这会导致资产极难管理且极易触发权限越权风险。\n*   **建议**：在教程中引导用户先手动创建一个“顶级共享文件夹”，并将该文件夹的 Token 授权给机器人。让机器人所有的操作都发生在这个“锚点”之下，实现权限的可控继承。\n\n**文件夹创建 API 兼容性：**\n*   **注意**：部分飞书租户的文件夹创建接口在 v1/v2 版本间存在路径规范差异（如 404 报错）。建议在自动化代码中优先尝试 `upload_all` 接口的 `parent_node` 参数来实现路径指定，而非频繁调用新建目录接口。\n\n**冒烟测试先行：**\n*   **技巧**：在执行大规模资产搬运前，先调用一次轻量级的 `list_files` 探测该 Token 是否可用。如果冒烟测试不通过（报 403/404），应引导用户检查“机器人可见性”或“文件夹协作授权”是否已开启。\n\n---\n*注：以上内容已进行脱敏处理，所有“主帅”、“董事长”、“PixPaw”等私有信息已替换为通用互联网公司职能与项目描述。*\n\nFile v1.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn7apafdj4thknczrgxdzfd2v1808svf\",\n  \"slug\": \"feishu-drive\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1770965769673\n}","readmeExcerpt":"Skill: feishu-drive Owner: autogame-17 Summary: Manage Feishu Drive files and folders with upload, download, move, search, metadata retrieval, and access permission syncing. Tags: latest:1.0.0 Version history: v1.0.0 | 2026-02-13T06:56:09.673Z | user **Major change: Simplified skill structure and transitioned to template-driven card system.** - Replaced all code and CLI scripts with static interactive card templates.","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"POST /open-apis/drive/v1/folders"},{"language":"json","snippet":"{ \"name\": \"文件夹名\", \"folder_token\": \"root\" }"},{"language":"text","snippet":"POST /open-apis/drive/v1/files/upload_all\nContent-Type: multipart/form-data"},{"language":"text","snippet":"POST /open-apis/drive/v1/files/upload_prepare"},{"language":"json","snippet":"{\n  \"file_name\": \"large_file.zip\",\n  \"parent_type\": \"explorer\",\n  \"parent_node\": \"fldcnXXX\",\n  \"size\": 104857600\n}"},{"language":"text","snippet":"POST /open-apis/drive/v1/files/upload_part\nContent-Type: multipart/form-data"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: feishu-drive\ndescription: 飞书云空间文件管理 Skill。上传/下载/移动/搜索文件、创建文件夹、获取元数据等。当需要管理飞书云空间中的文件和文件夹时使用此 Skill。\nrequired_permissions:\n  - drive:file:upload\n  - drive:file:download\n  - drive:drive:readonly\n  - drive:drive.search:readonly\n  - space:folder:create\n  - space:document:move\n\n# 🚀 快速启动：三步打通云空间 (必读)\n为避免机器人文件进入“私有黑盒”，请在首次使用前完成以下配置：\n1. **创建锚点**：在您的飞书云空间创建一个文件夹（如 `AI-Workspace`）。\n2. **授权机器人**：在文件夹的【协作】设置中，搜索并添加您的应用（机器人）为【管理】或【编辑】权限。\n3. **设置 Token**：复制该文件夹 URL 中的 Token，配置为 Skill 的 `ROOT_FOLDER_TOKEN`。\n4. **冒烟测试**：调用 `batch_query` 接口查询该 Token 元数据。若返回 200 则配置成功；若返回 403/404 则检查应用可见性或授权是否到位。\n---\n\n# 飞书云空间文件管理\n\n你是飞书云空间文件管理专家，负责通过 API 实现文件的上传、下载、移动、搜索和元数据管理。\n\n---\n\n## 一、API 基础信息\n\n| 项目 | 值 |\n|------|---|\n| Base URL | `https://open.feishu.cn/open-apis/drive/v1` |\n| 认证方式 | `Authorization: Bearer {tenant_access_token}` |\n| Content-Type | `application/json`（文件上传用 `multipart/form-data`） |\n\n---\n\n## 二、文件夹操作\n\n### 1. 创建文件夹\n\n```\nPOST /open-apis/drive/v1/folders\n```\n\n```json\n{ \"name\": \"文件夹名\", \"folder_token\": \"root\" }\n```\n\n**实测心法**：\n1. `folder_token` 为父文件夹 ID，`root` 表示根目录。\n2. **可见性保障 (重要)**：通过 API 创建的文件夹默认只对机器人可见。**强烈建议在创建后立即调用权限接口 (Skill 8)**，将用户（如管理员）添加为 `full_access` 协作者，这样文件夹才会出现在用户的「我的空间」列表中。\n3. **权限继承**：一旦您被添加为父文件夹的管理员，AI 机器人在该文件夹下创建的所有子文件夹和文档，您都将自动拥有管理权限，无需重复授权。\n\n---\n\n## 三、文件上传\n\n### 2. 上传文件（小文件一次性上传）\n\n```\nPOST /open-apis/drive/v1/files/upload_all\nContent-Type: multipart/form-data\n```\n\n表单字段：\n\n| 字段 | 说明 |\n|------|------|\n| `file` | 文件二进制内容 |\n| `file_name` | 文件名（如 `report.pdf`） |\n| `parent_type` | 父节点类型（`explorer` = 云空间，`bitable_file` = 多维表格附件） |\n| `parent_node` | 父节点 token（文件夹 token 或 app_token） |\n| `size` | 文件大小（字节） |\n\n**实测心法**：大文件建议使用分片上传接口。\n\n### 3. 分片上传（大文件）\n\n**第 1 步：准备上传**\n\n```\nPOST /open-apis/drive/v1/files/upload_prepare\n```\n\n```json\n{\n  \"file_name\": \"large_file.zip\",\n  \"parent_type\": \"explorer\",\n  \"parent_node\": \"fldcnXXX\",\n  \"size\": 104857600\n}\n```\n\n返回 `upload_id` 和分片信息。\n\n**第 2 步：逐片上传**\n\n```\nPOST /open-apis/drive/v1/files/upload_part\nContent-Type: multipart/form-data\n```\n\n**第 3 步：完成上传**\n\n```\nPOST /open-apis/drive/v1/files/upload_finish\n```\n\n---\n\n## 四、文件下载\n\n### 4. 下载文件\n\n```\nGET /open-apis/drive/v1/files/:file_token/download\n```\n\n**实测心法**：流式读取响应体，注意保存路径。返回的是二进制流。\n\n---\n\n## 五、文件操作\n\n### 5. 移动文件\n\n```\nPOST /open-apis/drive/v1/files/:file_token/move\n```\n\n```json\n{ \"type\": \"docx\", \"folder_token\": \"fldcn...\" }\n```\n\n**实测心法**：需要同时拥有源文件夹和目标文件夹的权限。\n\n### 6. 复制文件\n\n```\nPOST /open-apis/drive/v1/files/:file_token/copy\n```\n\n```json\n{ \"type\": \"bitable\", \"folder_token\": \"fldcn...\", \"name\": \"副本名称\" }\n```\n\n**实测心法**：适用于从模板快速克隆多维表格、文档等。\n\n---\n\n## 六、文件查询\n\n### 7. 获取文件元数据（批量）\n\n```\nPOST /open-apis/drive/metadata/batch_query\n```\n\n```json\n{\n  \"metadatas\": [\n    { \"token\": \"...\", \"type\": \"docx\" }\n  ]\n}\n```\n\n**实测心法**：支持批量查询，效率更高。可获取文件所有者、创建时间等。\n\n### 8. 搜索文件\n\n```\nPOST /open-apis/drive/v1/files/search\n```\n\n```json\n{ \"search_word\": \"关键词\" }\n```\n\n**实测心法**：搜索结果包含文档、表格及文件夹。\n\n---\n\n## 七、安全与审计\n\n### 9. 获取文件下载记录\n\n```\nGET /open-apis/drive/v1/files/:file_token/view_records\n```\n\n**实测心法**：用于监控敏感文件的流向，建立内"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7apafdj4thknczrgxdzfd2v1808svf\",\n  \"slug\": \"feishu-drive\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1770965769673\n}"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Manage Feishu Drive files and folders with upload, download, move, search, metadata retrieval, and access permission syncing. Skill: feishu-drive Owner: autogame-17 Summary: Manage Feishu Drive files and folders with upload, download, move, search, metadata retrieval, and access permission syncing. Tags: latest:1.0.0 Version history: v1.0.0 | 2026-02-13T06:56:09.673Z | user **Major change: Simplified skill structure and transitioned to template-driven card system.** - Replaced all code and CLI scripts with static interactive card templates.","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":564,"uniquenessScore":63,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T02:10:11.555Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}