{
  "schemaVersion": "1.0",
  "item": {
    "slug": "whisper-cpp",
    "name": "Local Whisper",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/TrueNight/whisper-cpp",
    "canonicalUrl": "https://clawhub.ai/TrueNight/whisper-cpp",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/whisper-cpp",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=whisper-cpp",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "bin/openclaw-whisper-stt.sh",
      "scripts/patch_openclaw_audio.sh",
      "scripts/cleanup_build.sh",
      "scripts/install_wrapper.sh",
      "scripts/install_whisper_cpp.sh",
      "scripts/download_models.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/whisper-cpp"
    },
    "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/whisper-cpp",
    "agentPageUrl": "https://openagent3.xyz/skills/whisper-cpp/agent",
    "manifestUrl": "https://openagent3.xyz/skills/whisper-cpp/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/whisper-cpp/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": "whisper-cpp (Local Whisper STT for OpenClaw)",
        "body": "This skill sets up local whisper.cpp STT for inbound Telegram voice notes."
      },
      {
        "title": "Dependencies",
        "body": "You need build tools (git, cmake, compiler toolchain) + curl and ffmpeg (to decode Telegram OGG/Opus → WAV)."
      },
      {
        "title": "Install",
        "body": "From this skill directory:\n\nbash scripts/install_whisper_cpp.sh\nbash scripts/download_models.sh\nbash scripts/install_wrapper.sh\nbash scripts/patch_openclaw_audio.sh\n\nSend a Telegram voice note to test."
      },
      {
        "title": "Model choice",
        "body": "This setup uses ggml Whisper models stored in ~/.cache/whisper.\n\nCommon model names you can download:\n\ntiny, base, small, medium\nlarge-v1, large-v2, large-v3 (bigger/slower, usually more accurate)\n\nBy default we download: base + small.\n\nTo download specific models:\n\nbash scripts/download_models.sh tiny base small\n\nFor the OpenClaw wrapper, you can select:\n\nOPENCLAW_WHISPER_MODEL=small openclaw-whisper-stt /path/to/audio\n\nDefault language: auto-detect (OPENCLAW_WHISPER_LANG=auto)\nForce a language (example):\nOPENCLAW_WHISPER_LANG=en openclaw-whisper-stt /path/to/audio\n\nModels are stored in: ~/.cache/whisper."
      },
      {
        "title": "Cleanup (optional)",
        "body": "After install (whisper-cli + libs are in ~/.local/):\n\nbash scripts/cleanup_build.sh"
      },
      {
        "title": "Troubleshooting",
        "body": "Confirm OpenClaw is using the wrapper:\n\nwhich openclaw-whisper-stt\nopenclaw config get tools.media.audio.models\n\nTest the wrapper directly:\n\nopenclaw-whisper-stt /path/to/audio.ogg\nOPENCLAW_WHISPER_MODEL=small openclaw-whisper-stt /path/to/audio.ogg\n\nFollow gateway logs while sending a Telegram voice note:\n\nopenclaw logs --follow"
      },
      {
        "title": "Files",
        "body": "Wrapper source: bin/openclaw-whisper-stt.sh (linked to ~/.local/bin/openclaw-whisper-stt)\nOpenClaw config patcher: scripts/patch_openclaw_audio.sh"
      }
    ],
    "body": "whisper-cpp (Local Whisper STT for OpenClaw)\n\nThis skill sets up local whisper.cpp STT for inbound Telegram voice notes.\n\nDependencies\n\nYou need build tools (git, cmake, compiler toolchain) + curl and ffmpeg (to decode Telegram OGG/Opus → WAV).\n\nInstall\n\nFrom this skill directory:\n\nbash scripts/install_whisper_cpp.sh\nbash scripts/download_models.sh\nbash scripts/install_wrapper.sh\nbash scripts/patch_openclaw_audio.sh\n\n\nSend a Telegram voice note to test.\n\nTuning\nModel choice\n\nThis setup uses ggml Whisper models stored in ~/.cache/whisper.\n\nCommon model names you can download:\n\ntiny, base, small, medium\nlarge-v1, large-v2, large-v3 (bigger/slower, usually more accurate)\n\nBy default we download: base + small.\n\nTo download specific models:\n\nbash scripts/download_models.sh tiny base small\n\n\nFor the OpenClaw wrapper, you can select:\n\nOPENCLAW_WHISPER_MODEL=small openclaw-whisper-stt /path/to/audio\n\nDefault language: auto-detect (OPENCLAW_WHISPER_LANG=auto)\nForce a language (example):\nOPENCLAW_WHISPER_LANG=en openclaw-whisper-stt /path/to/audio\n\n\nModels are stored in: ~/.cache/whisper.\n\nCleanup (optional)\n\nAfter install (whisper-cli + libs are in ~/.local/):\n\nbash scripts/cleanup_build.sh\n\nTroubleshooting\n\nConfirm OpenClaw is using the wrapper:\n\nwhich openclaw-whisper-stt\nopenclaw config get tools.media.audio.models\n\n\nTest the wrapper directly:\n\nopenclaw-whisper-stt /path/to/audio.ogg\nOPENCLAW_WHISPER_MODEL=small openclaw-whisper-stt /path/to/audio.ogg\n\n\nFollow gateway logs while sending a Telegram voice note:\n\nopenclaw logs --follow\n\nFiles\nWrapper source: bin/openclaw-whisper-stt.sh (linked to ~/.local/bin/openclaw-whisper-stt)\nOpenClaw config patcher: scripts/patch_openclaw_audio.sh"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/TrueNight/whisper-cpp",
    "publisherUrl": "https://clawhub.ai/TrueNight/whisper-cpp",
    "owner": "TrueNight",
    "version": "1.0.2",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/whisper-cpp",
    "downloadUrl": "https://openagent3.xyz/downloads/whisper-cpp",
    "agentUrl": "https://openagent3.xyz/skills/whisper-cpp/agent",
    "manifestUrl": "https://openagent3.xyz/skills/whisper-cpp/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/whisper-cpp/agent.md"
  }
}