[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77FP613GQTM0377AV8C0JFY":3,"skill-same:01M77FP613GQTM0377AV8C0JFY":66},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":43,"commitSha":44,"skillDirectory":45,"forksCount":46,"repositoryHtmlUrl":47,"repositoryHomepageUrl":48,"ownerHtmlUrl":49,"ownerBlogUrl":6,"ownerDescription":50,"updatedAt":51,"install":52,"resources":65},"01M77FP613GQTM0377AV8C0JFY","feishu-voice",null,"飞书语音消息发送技能。将文本转换为语音并发送到飞书，支持 TTS 生成、格式转换、语速调整、时长读取、文件上传和消息发送。","Lord1Egypt\u002Fawesome-skill-forge","Lord1Egypt","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F99746359?v=4","01M7592YDNT0XK9WJ0T2MQVPDN","Mohamed Mounir Ali AL Keshita","01M75GRFNHC8VZNWEB8DKDE433",3,"MIT","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Ff\u002Ffeishu-voice\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: feishu-voice\ndescription: 飞书语音消息发送技能。将文本转换为语音并发送到飞书，支持 TTS 生成、格式转换、语速调整、时长读取、文件上传和消息发送。\nmetadata: {\n  \"openclaw\": {\n    \"requires\": {\n      \"bins\": [\"ffmpeg\", \"ffprobe\", \"jq\"],\n      \"env\": [\"FEISHU_APP_ID\", \"FEISHU_APP_SECRET\", \"COZE_API_KEY\"],\n      \"optional_env\": [\"FEISHU_RECEIVER\", \"FEISHU_APP_ID_B\", \"FEISHU_APP_SECRET_B\", \"FEISHU_RECEIVER_B\", \"OPENCLAW_WORKSPACE\"],\n      \"skills\": [\"coze-tts\"]\n    }\n  }\n}\n---\n\n# 飞书语音消息发送技能\n\n将文本转换为语音消息发送到飞书，支持在飞书聊天窗口直接播放。\n\n## 功能特性\n\n- ✅ TTS 文字转语音（使用 **coze-tts**）\n- ✅ 支持语速调整（0.5-2.0x）\n- ✅ 自动转换为 opus 格式（飞书要求）\n- ✅ 读取音频时长\n- ✅ 上传到飞书服务器\n- ✅ 发送可播放的语音消息\n\n## 前置要求\n\n### 环境变量\n\n**必需变量：**\n\n```bash\n# 飞书配置（必需）\nexport FEISHU_APP_ID=\"cli_xxx\"              # 飞书应用 ID\nexport FEISHU_APP_SECRET=\"your_secret\"      # 飞书应用密钥\n\n# Coze 配置（用于 TTS）\nexport COZE_API_KEY=\"your_coze_key\"         # Coze API 密钥\n```\n\n**可选变量：**\n\n```bash\n# 接收者配置\nexport FEISHU_RECEIVER=\"ou_xxx\"             # 默认接收者 Open ID\n\n# 多应用配置（用于支持多个飞书应用）\nexport FEISHU_APP_ID_B=\"cli_xxx\"            # 应用 B 的 ID\nexport FEISHU_APP_SECRET_B=\"your_secret\"    # 应用 B 的密钥\nexport FEISHU_RECEIVER_B=\"ou_xxx\"           # 应用 B 的接收者\n\n# 工作区路径（用于定位依赖技能）\nexport OPENCLAW_WORKSPACE=\"\u002Fpath\u002Fto\u002Fworkspace\"  # OpenClaw 工作区目录\n```\n\n### 必需工具\n\n- `ffmpeg` - 音频格式转换、语速调整\n- `ffprobe` - 读取音频信息\n- `jq` - JSON 处理\n\n### 依赖技能\n\n- `coze-tts` - 文字转语音\n\n## 使用方法\n\n### 基本用法\n\n```bash\n# 发送语音消息\nbash scripts\u002Fsend_voice.sh \"你好，这是一条语音消息\"\n```\n\n### 高级选项\n\n```bash\n# 指定 voice_id 和语速\nbash scripts\u002Fsend_voice.sh \"你好\" 2 1.2\n\n# 参数说明：\n# - voice_id: Coze 音色 ID（默认 1）\n# - 语速: 0.5-2.0（默认 1.0）\n```\n\n## 脚本说明\n\n### send_voice.sh\n\n主脚本，完整的语音消息发送流程。\n\n**用法：**\n```bash\nbash scripts\u002Fsend_voice.sh \u003C文本> [voice_id] [语速] [接收者]\n```\n\n**参数：**\n- `文本` (必需): 要转换为语音的文字\n- `voice_id` (可选): Coze 音色 ID（默认：1）\n- `语速` (可选): 0.5-2.0（默认：1.0）\n- `接收者` (可选): 飞书 open_id\n\n**环境变量：**\n- `FEISHU_APP_ID`: 飞书应用 ID\n- `FEISHU_APP_SECRET`: 飞书应用密钥\n- `FEISHU_RECEIVER`: 接收者 Open ID（可选）\n- `COZE_API_KEY`: Coze API 密钥\n\n### 流程说明\n\n1. **TTS 生成**: 使用 coze-tts 生成 MP3 格式音频\n2. **语速调整**（可选）: 使用 ffmpeg atempo 滤镜调整语速\n3. **格式转换**: 使用 ffmpeg 转换为 opus 格式\n4. **读取时长**: 使用 ffprobe 获取音频时长（毫秒）\n5. **上传文件**: 上传到飞书，指定 `file_type=opus` 和 `duration`\n6. **发送消息**: 发送 `msg_type=audio` 消息\n\n## 技术细节\n\n### 音频格式要求\n\n飞书语音消息要求：\n- **格式**: opus (OGG 容器)\n- **编码**: libopus\n- **比特率**: 24k\n- **采样率**: 24000 Hz\n- **声道**: 单声道\n\n### Duration 参数\n\n**关键**: 必须在上传时提供 `duration` 参数（整数毫秒），否则时长显示为 0。\n\n```bash\n# 正确的上传方式\ncurl -X POST \"https:\u002F\u002Fopen.feishu.cn\u002Fopen-apis\u002Fim\u002Fv1\u002Ffiles\" \\\n  -F \"file=@voice.opus\" \\\n  -F \"file_type=opus\" \\\n  -F \"duration=6000\"          # ← 关键参数（毫秒）\n```\n\n### API 端点\n\n| 端点 | 用途 |\n|------|------|\n| `\u002Fauth\u002Fv3\u002Ftenant_access_token\u002Finternal` | 获取访问令牌 |\n| `\u002Fim\u002Fv1\u002Ffiles` | 上传文件 |\n| `\u002Fim\u002Fv1\u002Fmessages` | 发送消息 |\n\n## 故障排查\n\n### 语音没有时长\n\n**问题**: 发送的语音消息时长显示为 0\n\n**解决**: 确保在上传时传递了 `duration` 参数（整数毫秒）\n\n```bash\n# 获取时长（转换为毫秒）\nDURATION_MS=$(ffprobe -v error -show_entries format=duration \\\n  -of default=noprint_wrappers=1:nokey=1 voice.opus | awk '{printf \"%.0f\", $1 * 1000}')\n\n# 上传时带上 duration（毫秒）\ncurl ... -F \"duration=$DURATION_MS\"\n```\n\n### 无法播放\n\n**问题**: 语音消息无法播放\n\n**可能原因**:\n1. 格式不是 opus\n2. `file_type` 参数错误\n3. 文件损坏\n\n**解决**:\n```bash\n# 检查格式\nffprobe voice.opus\n\n# 重新转换\nffmpeg -i input.mp3 -c:a libopus -b:a 24k voice.opus\n```\n\n### API 权限错误\n\n**问题**: 上传时返回权限错误\n\n**解决**: 确保飞书应用有以下权限：\n- `im:message`\n- `im:message:send_as_bot`\n\n## 完整示例\n\n```bash\n# 设置环境变量\nexport FEISHU_APP_ID=\"your_app_id_here\"\nexport FEISHU_APP_SECRET=\"your_app_secret_here\"\nexport COZE_API_KEY=\"your_coze_key_here\"\n\n# 发送语音（默认设置）\nbash scripts\u002Fsend_voice.sh \\\n  \"你好，这是一条测试语音消息。\"\n\n# 发送语音（指定 voice_id=2，语速 1.2x）\nbash scripts\u002Fsend_voice.sh \\\n  \"你好，这是一条测试语音消息。\" 2 1.2\n```\n\n## 注意事项\n\n1. **Coze TTS 限制**: 单次文本长度请参考 Coze 文档\n2. **整数时长**: duration 必须是整数毫秒\n3. **opus 格式**: 飞书只接受 opus 格式的音频消息\n4. **语速范围**: 支持 0.5-2.0x，使用 ffmpeg atempo 实现\n5. **文件清理**: 临时文件会自动清理\n\n## 相关技能\n\n- `coze-tts`: 文字转语音\n- `coze-asr`: 语音转文字\n\n## 更新日志\n\n**2026-03-24**: 从 zhipu-tts 迁移到 coze-tts，新增语速调整功能\n","# 飞书语音消息发送技能\n\n将文本转换为语音消息发送到飞书，支持在飞书聊天窗口直接播放。\n\n## 功能特性\n\n- ✅ TTS 文字转语音（使用 **coze-tts**）\n- ✅ 支持语速调整（0.5-2.0x）\n- ✅ 自动转换为 opus 格式（飞书要求）\n- ✅ 读取音频时长\n- ✅ 上传到飞书服务器\n- ✅ 发送可播放的语音消息\n\n## 前置要求\n\n### 环境变量\n\n**必需变量：**\n\n```bash\n# 飞书配置（必需）\nexport FEISHU_APP_ID=\"cli_xxx\"              # 飞书应用 ID\nexport FEISHU_APP_SECRET=\"your_secret\"      # 飞书应用密钥\n\n# Coze 配置（用于 TTS）\nexport COZE_API_KEY=\"your_coze_key\"         # Coze API 密钥\n```\n\n**可选变量：**\n\n```bash\n# 接收者配置\nexport FEISHU_RECEIVER=\"ou_xxx\"             # 默认接收者 Open ID\n\n# 多应用配置（用于支持多个飞书应用）\nexport FEISHU_APP_ID_B=\"cli_xxx\"            # 应用 B 的 ID\nexport FEISHU_APP_SECRET_B=\"your_secret\"    # 应用 B 的密钥\nexport FEISHU_RECEIVER_B=\"ou_xxx\"           # 应用 B 的接收者\n\n# 工作区路径（用于定位依赖技能）\nexport OPENCLAW_WORKSPACE=\"\u002Fpath\u002Fto\u002Fworkspace\"  # OpenClaw 工作区目录\n```\n\n### 必需工具\n\n- `ffmpeg` - 音频格式转换、语速调整\n- `ffprobe` - 读取音频信息\n- `jq` - JSON 处理\n\n### 依赖技能\n\n- `coze-tts` - 文字转语音\n\n## 使用方法\n\n### 基本用法\n\n```bash\n# 发送语音消息\nbash scripts\u002Fsend_voice.sh \"你好，这是一条语音消息\"\n```\n\n### 高级选项\n\n```bash\n# 指定 voice_id 和语速\nbash scripts\u002Fsend_voice.sh \"你好\" 2 1.2\n\n# 参数说明：\n# - voice_id: Coze 音色 ID（默认 1）\n# - 语速: 0.5-2.0（默认 1.0）\n```\n\n## 脚本说明\n\n### send_voice.sh\n\n主脚本，完整的语音消息发送流程。\n\n**用法：**\n```bash\nbash scripts\u002Fsend_voice.sh \u003C文本> [voice_id] [语速] [接收者]\n```\n\n**参数：**\n- `文本` (必需): 要转换为语音的文字\n- `voice_id` (可选): Coze 音色 ID（默认：1）\n- `语速` (可选): 0.5-2.0（默认：1.0）\n- `接收者` (可选): 飞书 open_id\n\n**环境变量：**\n- `FEISHU_APP_ID`: 飞书应用 ID\n- `FEISHU_APP_SECRET`: 飞书应用密钥\n- `FEISHU_RECEIVER`: 接收者 Open ID（可选）\n- `COZE_API_KEY`: Coze API 密钥\n\n### 流程说明\n\n1. **TTS 生成**: 使用 coze-tts 生成 MP3 格式音频\n2. **语速调整**（可选）: 使用 ffmpeg atempo 滤镜调整语速\n3. **格式转换**: 使用 ffmpeg 转换为 opus 格式\n4. **读取时长**: 使用 ffprobe 获取音频时长（毫秒）\n5. **上传文件**: 上传到飞书，指定 `file_type=opus` 和 `duration`\n6. **发送消息**: 发送 `msg_type=audio` 消息\n\n## 技术细节\n\n### 音频格式要求\n\n飞书语音消息要求：\n- **格式**: opus (OGG 容器)\n- **编码**: libopus\n- **比特率**: 24k\n- **采样率**: 24000 Hz\n- **声道**: 单声道\n\n### Duration 参数\n\n**关键**: 必须在上传时提供 `duration` 参数（整数毫秒），否则时长显示为 0。\n\n```bash\n# 正确的上传方式\ncurl -X POST \"https:\u002F\u002Fopen.feishu.cn\u002Fopen-apis\u002Fim\u002Fv1\u002Ffiles\" \\\n  -F \"file=@voice.opus\" \\\n  -F \"file_type=opus\" \\\n  -F \"duration=6000\"          # ← 关键参数（毫秒）\n```\n\n### API 端点\n\n| 端点 | 用途 |\n|------|------|\n| `\u002Fauth\u002Fv3\u002Ftenant_access_token\u002Finternal` | 获取访问令牌 |\n| `\u002Fim\u002Fv1\u002Ffiles` | 上传文件 |\n| `\u002Fim\u002Fv1\u002Fmessages` | 发送消息 |\n\n## 故障排查\n\n### 语音没有时长\n\n**问题**: 发送的语音消息时长显示为 0\n\n**解决**: 确保在上传时传递了 `duration` 参数（整数毫秒）\n\n```bash\n# 获取时长（转换为毫秒）\nDURATION_MS=$(ffprobe -v error -show_entries format=duration \\\n  -of default=noprint_wrappers=1:nokey=1 voice.opus | awk '{printf \"%.0f\", $1 * 1000}')\n\n# 上传时带上 duration（毫秒）\ncurl ... -F \"duration=$DURATION_MS\"\n```\n\n### 无法播放\n\n**问题**: 语音消息无法播放\n\n**可能原因**:\n1. 格式不是 opus\n2. `file_type` 参数错误\n3. 文件损坏\n\n**解决**:\n```bash\n# 检查格式\nffprobe voice.opus\n\n# 重新转换\nffmpeg -i input.mp3 -c:a libopus -b:a 24k voice.opus\n```\n\n### API 权限错误\n\n**问题**: 上传时返回权限错误\n\n**解决**: 确保飞书应用有以下权限：\n- `im:message`\n- `im:message:send_as_bot`\n\n## 完整示例\n\n```bash\n# 设置环境变量\nexport FEISHU_APP_ID=\"your_app_id_here\"\nexport FEISHU_APP_SECRET=\"your_app_secret_here\"\nexport COZE_API_KEY=\"your_coze_key_here\"\n\n# 发送语音（默认设置）\nbash scripts\u002Fsend_voice.sh \\\n  \"你好，这是一条测试语音消息。\"\n\n# 发送语音（指定 voice_id=2，语速 1.2x）\nbash scripts\u002Fsend_voice.sh \\\n  \"你好，这是一条测试语音消息。\" 2 1.2\n```\n\n## 注意事项\n\n1. **Coze TTS 限制**: 单次文本长度请参考 Coze 文档\n2. **整数时长**: duration 必须是整数毫秒\n3. **opus 格式**: 飞书只接受 opus 格式的音频消息\n4. **语速范围**: 支持 0.5-2.0x，使用 ffmpeg atempo 实现\n5. **文件清理**: 临时文件会自动清理\n\n## 相关技能\n\n- `coze-tts`: 文字转语音\n- `coze-asr`: 语音转文字\n\n## 更新日志\n\n**2026-03-24**: 从 zhipu-tts 迁移到 coze-tts，新增语速调整功能\n",{"name":5,"metadata":24,"description":7},{"openclaw":25},{"requires":26},{"env":27,"bins":31,"skills":35,"optional_env":37},[28,29,30],"FEISHU_APP_ID","FEISHU_APP_SECRET","COZE_API_KEY",[32,33,34],"ffmpeg","ffprobe","jq",[36],"coze-tts",[38,39,40,41,42],"FEISHU_RECEIVER","FEISHU_APP_ID_B","FEISHU_APP_SECRET_B","FEISHU_RECEIVER_B","OPENCLAW_WORKSPACE","master","4aa004da461d820f4ea5499e58eb8d196cf99016","community\u002Fclawhub\u002Ff\u002Ffeishu-voice",0,"https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge","https:\u002F\u002Fskill-explorer-rho.vercel.app","https:\u002F\u002Fgithub.com\u002FLord1Egypt","Unbreakable. Unstoppable. Unmatched⚡.\r\n Speaker of machine tongues 🤖  | World-builder of decentralized dreams 🌐 | Defender of the digital realm🛡️.","2026-06-10 08:21:01",{"source":8,"skillName":5,"commands":53,"prompt":63,"zipAvailable":64},[54,57,60],{"tool":55,"command":56},"npx","npx skills add Lord1Egypt\u002Fawesome-skill-forge --skill feishu-voice",{"tool":58,"command":59},"bunx","bunx skills add Lord1Egypt\u002Fawesome-skill-forge --skill feishu-voice",{"tool":61,"command":62},"pnpm","pnpm dlx skills add Lord1Egypt\u002Fawesome-skill-forge --skill feishu-voice","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Ff\u002Ffeishu-voice\u002FSKILL.md",true,[],[67,74,81,88,95,102],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M785WKJB99G3STR1NF9NRTJW","youtube-content","YouTube transcripts to summaries, threads, blogs.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fyoutube-content\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M785WEFHB0G2S9YA6EPR3H0E","xurl","X\u002FTwitter via xurl CLI: post, search, DM, media, v2 API.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fxurl\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M785W98EDN4EFJXJPMQEHCRC","touchdesigner-mcp","Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftouchdesigner-mcp\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M785W5S9FP3QBH2V191E025P","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":19},"01M785W2AS08NSSH9YATCV6FJB","teams-meeting-pipeline","Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fteams-meeting-pipeline\u002FSKILL.md",[],[],{"skillNo":103,"name":104,"nameZh":6,"description":105,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":106,"categories":107,"keywords":108,"publishedAt":19},"01M785VXKW4T34BTP1SCHW1R7F","systematic-debugging","4-phase root cause debugging: understand bugs before fixing.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fsystematic-debugging\u002FSKILL.md",[],[]]