{
  "schemaVersion": "1.0",
  "item": {
    "slug": "telegram-offline-voice",
    "name": "Telegram Offline Voice",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/sanwecn/telegram-offline-voice",
    "canonicalUrl": "https://clawhub.ai/sanwecn/telegram-offline-voice",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/telegram-offline-voice",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=telegram-offline-voice",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      ".clawhub/origin.json",
      "README.md",
      "SKILL.md",
      "_meta.json",
      "scripts/voice_gen.py"
    ],
    "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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-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/telegram-offline-voice"
    },
    "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/telegram-offline-voice",
    "agentPageUrl": "https://openagent3.xyz/skills/telegram-offline-voice/agent",
    "manifestUrl": "https://openagent3.xyz/skills/telegram-offline-voice/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/telegram-offline-voice/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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "telegram-offline-voice 🎙️",
        "body": "本地生成，一键封装 — 使用 Microsoft Edge-TTS 生成高质量中文语音，完全离线处理。"
      },
      {
        "title": "💡 为什么需要这个升级？",
        "body": "原生的 TTS 方案通常只能生成 MP3 附件，且无法处理 Markdown 标记和超长文本。本项目通过工程化封装，将“语音合成”进化为“语音交互”：\n\n告别标记音：自动识别并清洗 **, #, [link] 等 Markdown 符号，避免 AI 读出这些“代码噪音”。\n智能对话流：超长文本不再是一读到底，而是按句号、感叹号自动切分为多个语音气泡，听感更像真人在发语音。\n并发安全：针对多代理/子代理并行调用的场景，使用 UUID 隔离临时文件，彻底杜绝文件读写冲突。\n零token消耗：完全基于 Edge-TTS 本地生成，无需 OpenAI/Azure 的付费 Token。"
      },
      {
        "title": "✨ 特性",
        "body": "🔒 隐私保护：100% 本地音频处理，不经过任何额外云端 TTS 提供商。\n💰 零token消耗：使用免费的 Edge-TTS 引擎，省下昂贵的 API 额度。\n🎯 一键生成：内置 voice_gen.py 脚本，自动完成“文本->MP3->OGG”的全过程。\n🧹 自动清洗：自动剔除 Markdown 符号和 URL 链接，让朗读更自然。\n✂️ 智能分段：超长文本自动按标点符号切分为多个语音气泡。\n🛡️ 安全并发：使用 UUID 命名临时文件，支持多代理同时调用。"
      },
      {
        "title": "🛠️ 安装依赖",
        "body": "# 需要 Python 环境和 FFmpeg\nsudo apt update && sudo apt install ffmpeg python3-pip -y\n\n# 推荐安装 uv 以极速运行封装脚本\ncurl -LsSf https://astral.sh/uv/install.sh | sh"
      },
      {
        "title": "🚀 使用方法 (推荐)",
        "body": "直接调用封装脚本，一键生成 Telegram 原生语音气泡路径：\n\nuv run {baseDir}/scripts/voice_gen.py --text \"您的待播报内容\""
      },
      {
        "title": "参数说明",
        "body": "--text / -t: 待生成的文本（必填）。\n--voice: 声线选择，默认 zh-CN-XiaoxiaoNeural（晓晓）。\n--rate: 语速调节，默认 +5%。\n--outdir: 临时文件存放目录，默认 /tmp。"
      },
      {
        "title": "自动化清洗规则",
        "body": "脚本会自动移除以下内容以确保朗读流畅：\n\nMarkdown 符号：**, *, _, `, #\n链接逻辑：[文本](url) 以及所有 http/https 开头的链接\n分割线：---, *** 等"
      },
      {
        "title": "👨💻 关于作者",
        "body": "由 @sanwe 调优并维护。\n欢迎关注我的推特获取更多 OpenClaw 进阶玩法：https://x.com/sanwe"
      }
    ],
    "body": "telegram-offline-voice 🎙️\n\n本地生成，一键封装 — 使用 Microsoft Edge-TTS 生成高质量中文语音，完全离线处理。\n\n💡 为什么需要这个升级？\n\n原生的 TTS 方案通常只能生成 MP3 附件，且无法处理 Markdown 标记和超长文本。本项目通过工程化封装，将“语音合成”进化为“语音交互”：\n\n告别标记音：自动识别并清洗 **, #, [link] 等 Markdown 符号，避免 AI 读出这些“代码噪音”。\n智能对话流：超长文本不再是一读到底，而是按句号、感叹号自动切分为多个语音气泡，听感更像真人在发语音。\n并发安全：针对多代理/子代理并行调用的场景，使用 UUID 隔离临时文件，彻底杜绝文件读写冲突。\n零token消耗：完全基于 Edge-TTS 本地生成，无需 OpenAI/Azure 的付费 Token。\n✨ 特性\n🔒 隐私保护：100% 本地音频处理，不经过任何额外云端 TTS 提供商。\n💰 零token消耗：使用免费的 Edge-TTS 引擎，省下昂贵的 API 额度。\n🎯 一键生成：内置 voice_gen.py 脚本，自动完成“文本->MP3->OGG”的全过程。\n🧹 自动清洗：自动剔除 Markdown 符号和 URL 链接，让朗读更自然。\n✂️ 智能分段：超长文本自动按标点符号切分为多个语音气泡。\n🛡️ 安全并发：使用 UUID 命名临时文件，支持多代理同时调用。\n🛠️ 安装依赖\n# 需要 Python 环境和 FFmpeg\nsudo apt update && sudo apt install ffmpeg python3-pip -y\n\n# 推荐安装 uv 以极速运行封装脚本\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n🚀 使用方法 (推荐)\n\n直接调用封装脚本，一键生成 Telegram 原生语音气泡路径：\n\nuv run {baseDir}/scripts/voice_gen.py --text \"您的待播报内容\"\n\n⚙️ 技术细节\n参数说明\n--text / -t: 待生成的文本（必填）。\n--voice: 声线选择，默认 zh-CN-XiaoxiaoNeural（晓晓）。\n--rate: 语速调节，默认 +5%。\n--outdir: 临时文件存放目录，默认 /tmp。\n自动化清洗规则\n\n脚本会自动移除以下内容以确保朗读流畅：\n\nMarkdown 符号：**, *, _, `, #\n链接逻辑：[文本](url) 以及所有 http/https 开头的链接\n分割线：---, *** 等\n👨💻 关于作者\n\n由 @sanwe 调优并维护。 欢迎关注我的推特获取更多 OpenClaw 进阶玩法：https://x.com/sanwe"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/sanwecn/telegram-offline-voice",
    "publisherUrl": "https://clawhub.ai/sanwecn/telegram-offline-voice",
    "owner": "sanwecn",
    "version": "0.1.3",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/telegram-offline-voice",
    "downloadUrl": "https://openagent3.xyz/downloads/telegram-offline-voice",
    "agentUrl": "https://openagent3.xyz/skills/telegram-offline-voice/agent",
    "manifestUrl": "https://openagent3.xyz/skills/telegram-offline-voice/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/telegram-offline-voice/agent.md"
  }
}