{
  "schemaVersion": "1.0",
  "item": {
    "slug": "imessage-voice-reply",
    "name": "iMessage Voice Reply",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/bolander72/imessage-voice-reply",
    "canonicalUrl": "https://clawhub.ai/bolander72/imessage-voice-reply",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/imessage-voice-reply",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=imessage-voice-reply",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "_meta.json",
      "scripts/generate_voice_reply.py",
      "scripts/setup.sh"
    ],
    "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/imessage-voice-reply"
    },
    "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/imessage-voice-reply",
    "agentPageUrl": "https://openagent3.xyz/skills/imessage-voice-reply/agent",
    "manifestUrl": "https://openagent3.xyz/skills/imessage-voice-reply/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/imessage-voice-reply/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": "iMessage Voice Reply",
        "body": "Generate and send native iMessage voice messages using local Kokoro TTS. Voice messages appear as inline playable bubbles with waveforms — identical to voice messages recorded in Messages.app."
      },
      {
        "title": "How It Works",
        "body": "Your text response → Kokoro TTS (local) → afconvert (native Apple encoder) → CAF/Opus → BlueBubbles → iMessage voice bubble"
      },
      {
        "title": "Setup",
        "body": "bash ${baseDir}/scripts/setup.sh\n\nInstalls: kokoro-onnx, soundfile, numpy. Downloads Kokoro models (~136MB) to ~/.cache/kokoro-onnx/.\n\nRequires: BlueBubbles channel configured in OpenClaw (channels.bluebubbles)."
      },
      {
        "title": "Step 1: Generate audio",
        "body": "Write the response text to a temp file, then pass it via --text-file to avoid shell injection:\n\necho \"Your response text here\" > /tmp/voice_text.txt\n${baseDir}/.venv/bin/python ${baseDir}/scripts/generate_voice_reply.py --text-file /tmp/voice_text.txt --output /tmp/voice_reply.caf\n\nAlternatively, pass text directly (ensure proper shell escaping):\n\n${baseDir}/.venv/bin/python ${baseDir}/scripts/generate_voice_reply.py --text \"Your response text here\" --output /tmp/voice_reply.caf\n\nOptions:\n\n--voice af_heart — Kokoro voice (default: af_heart)\n--speed 1.15 — Playback speed (default: 1.15)\n--lang en-us — Language code (default: en-us)\n\nSecurity note: The Python script uses argparse and subprocess.run with list arguments (no shell=True). Input is handled safely within the script. When calling from a shell, prefer --text-file for untrusted input to avoid shell metacharacter issues."
      },
      {
        "title": "Step 2: Send via BlueBubbles",
        "body": "Use the message tool:\n\n{\n  \"action\": \"sendAttachment\",\n  \"channel\": \"bluebubbles\",\n  \"target\": \"+1XXXXXXXXXX\",\n  \"path\": \"/tmp/voice_reply.caf\",\n  \"filename\": \"Audio Message.caf\",\n  \"contentType\": \"audio/x-caf\",\n  \"asVoice\": true\n}\n\nCritical parameters for native voice bubble:\n\nfilename must be \"Audio Message.caf\"\ncontentType must be \"audio/x-caf\"\nasVoice must be true\n\nAll three are required for iMessage to render the message as an inline voice bubble with waveform instead of a file attachment."
      },
      {
        "title": "Voice Options",
        "body": "LanguageFemaleMaleEnglishaf_heart ⭐am_puckSpanishef_doraem_alexFrenchff_siwis—Japanesejf_alphajm_betaChinesezf_xiaobeizm_yunjian"
      },
      {
        "title": "When to Reply with Voice",
        "body": "Reply with a voice message when:\n\nThe user sent you a voice message (voice-for-voice)\nThe user explicitly asks for an audio/voice response\n\nAlways include a text reply alongside the voice message for accessibility."
      },
      {
        "title": "Audio Format",
        "body": "macOS: CAF container, Opus codec, 48kHz mono, 32kbps — encoded by Apple's native afconvert. Identical to what Messages.app produces.\nFallback: MP3 via ffmpeg (works but may not render as native voice bubble on all iMessage versions)."
      },
      {
        "title": "Cost",
        "body": "$0. Kokoro TTS runs entirely locally. No API calls for voice generation."
      },
      {
        "title": "Troubleshooting",
        "body": "Voice message shows as file attachment — Ensure all three parameters are set: filename=\"Audio Message.caf\", contentType=\"audio/x-caf\", asVoice=true.\n\nFirst word clipped — The script prepends 150ms silence automatically. If still clipped, increase the silence pad in the script.\n\nKokoro model not found — Run bash ${baseDir}/scripts/setup.sh.\n\nafconvert not found — Only available on macOS. Script falls back to ffmpeg/MP3 on Linux."
      }
    ],
    "body": "iMessage Voice Reply\n\nGenerate and send native iMessage voice messages using local Kokoro TTS. Voice messages appear as inline playable bubbles with waveforms — identical to voice messages recorded in Messages.app.\n\nHow It Works\nYour text response → Kokoro TTS (local) → afconvert (native Apple encoder) → CAF/Opus → BlueBubbles → iMessage voice bubble\n\nSetup\nbash ${baseDir}/scripts/setup.sh\n\n\nInstalls: kokoro-onnx, soundfile, numpy. Downloads Kokoro models (~136MB) to ~/.cache/kokoro-onnx/.\n\nRequires: BlueBubbles channel configured in OpenClaw (channels.bluebubbles).\n\nGenerating and Sending a Voice Reply\nStep 1: Generate audio\n\nWrite the response text to a temp file, then pass it via --text-file to avoid shell injection:\n\necho \"Your response text here\" > /tmp/voice_text.txt\n${baseDir}/.venv/bin/python ${baseDir}/scripts/generate_voice_reply.py --text-file /tmp/voice_text.txt --output /tmp/voice_reply.caf\n\n\nAlternatively, pass text directly (ensure proper shell escaping):\n\n${baseDir}/.venv/bin/python ${baseDir}/scripts/generate_voice_reply.py --text \"Your response text here\" --output /tmp/voice_reply.caf\n\n\nOptions:\n\n--voice af_heart — Kokoro voice (default: af_heart)\n--speed 1.15 — Playback speed (default: 1.15)\n--lang en-us — Language code (default: en-us)\n\nSecurity note: The Python script uses argparse and subprocess.run with list arguments (no shell=True). Input is handled safely within the script. When calling from a shell, prefer --text-file for untrusted input to avoid shell metacharacter issues.\n\nStep 2: Send via BlueBubbles\n\nUse the message tool:\n\n{\n  \"action\": \"sendAttachment\",\n  \"channel\": \"bluebubbles\",\n  \"target\": \"+1XXXXXXXXXX\",\n  \"path\": \"/tmp/voice_reply.caf\",\n  \"filename\": \"Audio Message.caf\",\n  \"contentType\": \"audio/x-caf\",\n  \"asVoice\": true\n}\n\n\nCritical parameters for native voice bubble:\n\nfilename must be \"Audio Message.caf\"\ncontentType must be \"audio/x-caf\"\nasVoice must be true\n\nAll three are required for iMessage to render the message as an inline voice bubble with waveform instead of a file attachment.\n\nVoice Options\nLanguage\tFemale\tMale\nEnglish\taf_heart ⭐\tam_puck\nSpanish\tef_dora\tem_alex\nFrench\tff_siwis\t—\nJapanese\tjf_alpha\tjm_beta\nChinese\tzf_xiaobei\tzm_yunjian\nWhen to Reply with Voice\n\nReply with a voice message when:\n\nThe user sent you a voice message (voice-for-voice)\nThe user explicitly asks for an audio/voice response\n\nAlways include a text reply alongside the voice message for accessibility.\n\nAudio Format\nmacOS: CAF container, Opus codec, 48kHz mono, 32kbps — encoded by Apple's native afconvert. Identical to what Messages.app produces.\nFallback: MP3 via ffmpeg (works but may not render as native voice bubble on all iMessage versions).\nCost\n\n$0. Kokoro TTS runs entirely locally. No API calls for voice generation.\n\nTroubleshooting\n\nVoice message shows as file attachment — Ensure all three parameters are set: filename=\"Audio Message.caf\", contentType=\"audio/x-caf\", asVoice=true.\n\nFirst word clipped — The script prepends 150ms silence automatically. If still clipped, increase the silence pad in the script.\n\nKokoro model not found — Run bash ${baseDir}/scripts/setup.sh.\n\nafconvert not found — Only available on macOS. Script falls back to ffmpeg/MP3 on Linux."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/bolander72/imessage-voice-reply",
    "publisherUrl": "https://clawhub.ai/bolander72/imessage-voice-reply",
    "owner": "bolander72",
    "version": "1.0.3",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/imessage-voice-reply",
    "downloadUrl": "https://openagent3.xyz/downloads/imessage-voice-reply",
    "agentUrl": "https://openagent3.xyz/skills/imessage-voice-reply/agent",
    "manifestUrl": "https://openagent3.xyz/skills/imessage-voice-reply/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/imessage-voice-reply/agent.md"
  }
}