{
  "schemaVersion": "1.0",
  "item": {
    "slug": "feishu-media",
    "name": "飞书媒体发送",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/godzff/feishu-media",
    "canonicalUrl": "https://clawhub.ai/godzff/feishu-media",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/feishu-media",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=feishu-media",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/feishu-media"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/feishu-media",
    "agentPageUrl": "https://openagent3.xyz/skills/feishu-media/agent",
    "manifestUrl": "https://openagent3.xyz/skills/feishu-media/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/feishu-media/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "飞书媒体发送技能",
        "body": "通过 message 工具向飞书发送各类媒体文件。"
      },
      {
        "title": "核心用法",
        "body": "所有媒体发送都通过 message 工具的 action=send，关键参数：\n\nchannel: feishu\ntarget: chat:群ID 或 user:open_id（省略则回复当前会话）\nmessage: 附带的文字说明（可选）\nfilePath: 本地文件路径\nmedia: URL 地址（网络图片/文件）"
      },
      {
        "title": "1. 发送本地文件（PDF/DOC/XLS/PPT/TXT等）",
        "body": "message action=send channel=feishu filePath=/path/to/file.pdf message=\"文件说明\"\n\n支持格式：pdf, doc/docx, xls/xlsx, ppt/pptx, txt, csv, zip, tar.gz 等。"
      },
      {
        "title": "2. 发送本地图片",
        "body": "message action=send channel=feishu filePath=/path/to/image.png message=\"图片说明\"\n\n支持格式：jpg, jpeg, png, gif, webp, bmp。"
      },
      {
        "title": "3. 发送 URL 图片",
        "body": "message action=send channel=feishu media=https://example.com/image.png message=\"网络图片\""
      },
      {
        "title": "4. 发送视频",
        "body": "message action=send channel=feishu filePath=/path/to/video.mp4 message=\"视频说明\"\n\n视频以文件附件形式发送（飞书 msg_type: file）。支持 mp4, mov, avi。"
      },
      {
        "title": "5. 发送音频（非语音）",
        "body": "MP3 等音频文件作为普通文件发送：\n\nmessage action=send channel=feishu filePath=/path/to/audio.mp3 message=\"音频文件\""
      },
      {
        "title": "6. 发送语音消息（可播放的语音条）",
        "body": "语音消息需要 Ogg/Opus 格式。飞书会显示为可播放的语音条。"
      },
      {
        "title": "6.1 直接发送 opus/ogg 文件",
        "body": "message action=send channel=feishu filePath=/path/to/voice.opus message=\"语音消息\""
      },
      {
        "title": "6.2 从 MP3 转换后发送",
        "body": "先用 ffmpeg 转换格式：\n\nffmpeg -i input.mp3 -ar 16000 -ac 1 -acodec libopus output.ogg -y\n\n然后发送 output.ogg。"
      },
      {
        "title": "6.3 技术细节",
        "body": "语音消息的底层流程：\n\n上传：im.file.create，file_type: \"opus\"，需带 duration（毫秒）\n发送：msg_type: \"audio\"，content: {\"file_key\":\"xxx\",\"duration\":3007}\nduration 由 ffprobe 自动获取，无需手动指定"
      },
      {
        "title": "7. 打压缩包后发送",
        "body": "当需要发送多个文件或不支持的格式时，先打包再发送："
      },
      {
        "title": "7.1 打 zip 包",
        "body": "zip -j /tmp/archive.zip /path/to/file1 /path/to/file2"
      },
      {
        "title": "7.2 打 tar.gz 包",
        "body": "tar czf /tmp/archive.tar.gz -C /path/to/dir ."
      },
      {
        "title": "7.3 发送压缩包",
        "body": "message action=send channel=feishu filePath=/tmp/archive.zip message=\"打包文件\""
      },
      {
        "title": "格式支持速查表",
        "body": "类型格式发送方式飞书显示图片jpg/png/gif/webpfilePath 或 media(URL)内嵌图片文档pdf/doc/xls/pptfilePath文件卡片视频mp4/mov/avifilePath文件卡片音频mp3/wav/flacfilePath文件卡片语音opus/oggfilePath可播放语音条压缩包zip/tar.gzfilePath文件卡片网络图片URLmedia内嵌图片"
      },
      {
        "title": "注意事项",
        "body": "文件大小限制：默认 30MB\n语音必须是 Ogg/Opus 格式才能显示为语音条，其他音频格式只能作为文件发送\n需要 ffmpeg/ffprobe 支持语音格式转换和时长检测\n飞书应用需要 im:message、im:resource 权限"
      }
    ],
    "body": "飞书媒体发送技能\n\n通过 message 工具向飞书发送各类媒体文件。\n\n核心用法\n\n所有媒体发送都通过 message 工具的 action=send，关键参数：\n\nchannel: feishu\ntarget: chat:群ID 或 user:open_id（省略则回复当前会话）\nmessage: 附带的文字说明（可选）\nfilePath: 本地文件路径\nmedia: URL 地址（网络图片/文件）\n1. 发送本地文件（PDF/DOC/XLS/PPT/TXT等）\nmessage action=send channel=feishu filePath=/path/to/file.pdf message=\"文件说明\"\n\n\n支持格式：pdf, doc/docx, xls/xlsx, ppt/pptx, txt, csv, zip, tar.gz 等。\n\n2. 发送本地图片\nmessage action=send channel=feishu filePath=/path/to/image.png message=\"图片说明\"\n\n\n支持格式：jpg, jpeg, png, gif, webp, bmp。\n\n3. 发送 URL 图片\nmessage action=send channel=feishu media=https://example.com/image.png message=\"网络图片\"\n\n4. 发送视频\nmessage action=send channel=feishu filePath=/path/to/video.mp4 message=\"视频说明\"\n\n\n视频以文件附件形式发送（飞书 msg_type: file）。支持 mp4, mov, avi。\n\n5. 发送音频（非语音）\n\nMP3 等音频文件作为普通文件发送：\n\nmessage action=send channel=feishu filePath=/path/to/audio.mp3 message=\"音频文件\"\n\n6. 发送语音消息（可播放的语音条）\n\n语音消息需要 Ogg/Opus 格式。飞书会显示为可播放的语音条。\n\n6.1 直接发送 opus/ogg 文件\nmessage action=send channel=feishu filePath=/path/to/voice.opus message=\"语音消息\"\n\n6.2 从 MP3 转换后发送\n\n先用 ffmpeg 转换格式：\n\nffmpeg -i input.mp3 -ar 16000 -ac 1 -acodec libopus output.ogg -y\n\n\n然后发送 output.ogg。\n\n6.3 技术细节\n\n语音消息的底层流程：\n\n上传：im.file.create，file_type: \"opus\"，需带 duration（毫秒）\n发送：msg_type: \"audio\"，content: {\"file_key\":\"xxx\",\"duration\":3007}\nduration 由 ffprobe 自动获取，无需手动指定\n7. 打压缩包后发送\n\n当需要发送多个文件或不支持的格式时，先打包再发送：\n\n7.1 打 zip 包\nzip -j /tmp/archive.zip /path/to/file1 /path/to/file2\n\n7.2 打 tar.gz 包\ntar czf /tmp/archive.tar.gz -C /path/to/dir .\n\n7.3 发送压缩包\nmessage action=send channel=feishu filePath=/tmp/archive.zip message=\"打包文件\"\n\n格式支持速查表\n类型\t格式\t发送方式\t飞书显示\n图片\tjpg/png/gif/webp\tfilePath 或 media(URL)\t内嵌图片\n文档\tpdf/doc/xls/ppt\tfilePath\t文件卡片\n视频\tmp4/mov/avi\tfilePath\t文件卡片\n音频\tmp3/wav/flac\tfilePath\t文件卡片\n语音\topus/ogg\tfilePath\t可播放语音条\n压缩包\tzip/tar.gz\tfilePath\t文件卡片\n网络图片\tURL\tmedia\t内嵌图片\n注意事项\n文件大小限制：默认 30MB\n语音必须是 Ogg/Opus 格式才能显示为语音条，其他音频格式只能作为文件发送\n需要 ffmpeg/ffprobe 支持语音格式转换和时长检测\n飞书应用需要 im:message、im:resource 权限"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/godzff/feishu-media",
    "publisherUrl": "https://clawhub.ai/godzff/feishu-media",
    "owner": "godzff",
    "version": "1.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/feishu-media",
    "downloadUrl": "https://openagent3.xyz/downloads/feishu-media",
    "agentUrl": "https://openagent3.xyz/skills/feishu-media/agent",
    "manifestUrl": "https://openagent3.xyz/skills/feishu-media/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/feishu-media/agent.md"
  }
}