{
  "schemaVersion": "1.0",
  "item": {
    "slug": "webchat-voice-full-stack",
    "name": "WebChat Voice Full Stack",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/neldar/webchat-voice-full-stack",
    "canonicalUrl": "https://clawhub.ai/neldar/webchat-voice-full-stack",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/webchat-voice-full-stack",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=webchat-voice-full-stack",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "references/architecture.md",
      "scripts/deploy.sh",
      "scripts/rehash.sh",
      "scripts/status.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",
      "slug": "webchat-voice-full-stack",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-10T23:52:40.934Z",
      "expiresAt": "2026-05-17T23:52:40.934Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=webchat-voice-full-stack",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=webchat-voice-full-stack",
        "contentDisposition": "attachment; filename=\"webchat-voice-full-stack-0.4.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "webchat-voice-full-stack"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/webchat-voice-full-stack"
    },
    "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/webchat-voice-full-stack",
    "agentPageUrl": "https://openagent3.xyz/skills/webchat-voice-full-stack/agent",
    "manifestUrl": "https://openagent3.xyz/skills/webchat-voice-full-stack/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/webchat-voice-full-stack/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": "WebChat Voice Full Stack",
        "body": "Meta-installer that orchestrates three standalone skills in the correct order:\n\nfaster-whisper-local-service — local STT backend (HTTP on 127.0.0.1:18790)\nwebchat-https-proxy — HTTPS/WSS reverse proxy for Control UI + WebSocket + transcription\nwebchat-voice-gui — mic button, VU meter, keyboard shortcuts, i18n for WebChat"
      },
      {
        "title": "Prerequisites",
        "body": "All three skills must be installed before running this meta-installer:\n\nnpx clawhub install faster-whisper-local-service\nnpx clawhub install webchat-https-proxy\nnpx clawhub install webchat-voice-gui\n\nAdditionally required on the system:\n\nPython 3.10+\ngst-launch-1.0 (GStreamer, from OS packages)\nInternet access on first run (model download ~1.5 GB for medium)"
      },
      {
        "title": "Deploy",
        "body": "bash scripts/deploy.sh\n\nOptional overrides (passed through to downstream scripts):\n\nVOICE_HOST=10.0.0.42 VOICE_HTTPS_PORT=8443 TRANSCRIBE_PORT=18790 WHISPER_LANGUAGE=auto bash scripts/deploy.sh"
      },
      {
        "title": "What this does (via downstream scripts)",
        "body": "This skill does not contain deployment logic itself. It calls deploy.sh from each sub-skill:"
      },
      {
        "title": "Step 1: faster-whisper-local-service",
        "body": "Creates Python venv, installs faster-whisper==1.1.1\nWrites transcribe-server.py with input validation (magic-byte check, size limit)\nCreates systemd user service openclaw-transcribe.service\nDownloads model weights on first run (~1.5 GB for medium)"
      },
      {
        "title": "Step 2: webchat-https-proxy",
        "body": "Copies https-server.py to workspace\nAdds HTTPS origin to gateway.controlUi.allowedOrigins\nCreates systemd user service openclaw-voice-https.service\nAuto-generates self-signed TLS cert (TLS 1.2+ enforced)"
      },
      {
        "title": "Step 3: webchat-voice-gui",
        "body": "Copies voice-input.js and injects <script> tag into Control UI\nInstalls gateway startup hook for update safety\nOptional interactive language selection\n\nFor full details, security notes, and uninstall instructions, see each skill's SKILL.md."
      },
      {
        "title": "Security posture (why these changes are expected)",
        "body": "This is a meta-installer, so it coordinates downstream skills and applies only the minimum required local changes:\n\nPersistence: creates user-level systemd services so STT/proxy survive reboot (openclaw-transcribe, openclaw-voice-https)\nUI enablement: injects one explicit <script> tag for voice-input.js in Control UI\nGateway compatibility: appends one HTTPS origin to gateway.controlUi.allowedOrigins\n\nSafety characteristics:\n\nall changes are documented and reversible via uninstall scripts\nno root/sudo required (user scope only)\nno hidden background tasks beyond documented services\nno outbound telemetry or data exfiltration behavior"
      },
      {
        "title": "Integrity verification",
        "body": "Before executing any sub-skill script, deploy.sh verifies SHA256 checksums of all sub-skill scripts against scripts/checksums.sha256. If any script was modified after installation (e.g. by a registry update or tampering), deployment aborts with a clear error.\n\nWorkflow:\n\nnpx clawhub install <sub-skill> — fetch from registry\nAudit the scripts manually or via code review\nbash scripts/rehash.sh — record trusted checksums\nbash scripts/deploy.sh — verify checksums, then deploy\n\nDry-run verification (no deployment):\n\nVERIFY_ONLY=true bash scripts/deploy.sh\n\nAfter a sub-skill update:\n\nReview the changed scripts\nbash scripts/rehash.sh to update the trusted baseline\nCommit the updated checksums.sha256"
      },
      {
        "title": "Verify",
        "body": "bash scripts/status.sh"
      },
      {
        "title": "Uninstall",
        "body": "Uninstall each skill separately (in reverse order):\n\n# 1. Voice GUI (hook, UI injection, workspace files)\nbash skills/webchat-voice-gui/scripts/uninstall.sh\n\n# 2. HTTPS Proxy (service, gateway config, certs)\nbash skills/webchat-https-proxy/scripts/uninstall.sh\n\n# 3. STT Backend (service, venv)\nsystemctl --user stop openclaw-transcribe.service\nsystemctl --user disable openclaw-transcribe.service\nrm -f ~/.config/systemd/user/openclaw-transcribe.service\nsystemctl --user daemon-reload"
      },
      {
        "title": "Notes",
        "body": "This meta-skill is a convenience wrapper. All actual logic lives in the three sub-skills.\nReview each sub-skill's scripts and security notes before running.\nThe WORKSPACE and SKILLS_DIR paths are configurable via environment variables."
      }
    ],
    "body": "WebChat Voice Full Stack\n\nMeta-installer that orchestrates three standalone skills in the correct order:\n\nfaster-whisper-local-service — local STT backend (HTTP on 127.0.0.1:18790)\nwebchat-https-proxy — HTTPS/WSS reverse proxy for Control UI + WebSocket + transcription\nwebchat-voice-gui — mic button, VU meter, keyboard shortcuts, i18n for WebChat\nPrerequisites\n\nAll three skills must be installed before running this meta-installer:\n\nnpx clawhub install faster-whisper-local-service\nnpx clawhub install webchat-https-proxy\nnpx clawhub install webchat-voice-gui\n\n\nAdditionally required on the system:\n\nPython 3.10+\ngst-launch-1.0 (GStreamer, from OS packages)\nInternet access on first run (model download ~1.5 GB for medium)\nDeploy\nbash scripts/deploy.sh\n\n\nOptional overrides (passed through to downstream scripts):\n\nVOICE_HOST=10.0.0.42 VOICE_HTTPS_PORT=8443 TRANSCRIBE_PORT=18790 WHISPER_LANGUAGE=auto bash scripts/deploy.sh\n\nWhat this does (via downstream scripts)\n\nThis skill does not contain deployment logic itself. It calls deploy.sh from each sub-skill:\n\nStep 1: faster-whisper-local-service\nCreates Python venv, installs faster-whisper==1.1.1\nWrites transcribe-server.py with input validation (magic-byte check, size limit)\nCreates systemd user service openclaw-transcribe.service\nDownloads model weights on first run (~1.5 GB for medium)\nStep 2: webchat-https-proxy\nCopies https-server.py to workspace\nAdds HTTPS origin to gateway.controlUi.allowedOrigins\nCreates systemd user service openclaw-voice-https.service\nAuto-generates self-signed TLS cert (TLS 1.2+ enforced)\nStep 3: webchat-voice-gui\nCopies voice-input.js and injects <script> tag into Control UI\nInstalls gateway startup hook for update safety\nOptional interactive language selection\n\nFor full details, security notes, and uninstall instructions, see each skill's SKILL.md.\n\nSecurity posture (why these changes are expected)\n\nThis is a meta-installer, so it coordinates downstream skills and applies only the minimum required local changes:\n\nPersistence: creates user-level systemd services so STT/proxy survive reboot (openclaw-transcribe, openclaw-voice-https)\nUI enablement: injects one explicit <script> tag for voice-input.js in Control UI\nGateway compatibility: appends one HTTPS origin to gateway.controlUi.allowedOrigins\n\nSafety characteristics:\n\nall changes are documented and reversible via uninstall scripts\nno root/sudo required (user scope only)\nno hidden background tasks beyond documented services\nno outbound telemetry or data exfiltration behavior\nIntegrity verification\n\nBefore executing any sub-skill script, deploy.sh verifies SHA256 checksums of all sub-skill scripts against scripts/checksums.sha256. If any script was modified after installation (e.g. by a registry update or tampering), deployment aborts with a clear error.\n\nWorkflow:\n\nnpx clawhub install <sub-skill> — fetch from registry\nAudit the scripts manually or via code review\nbash scripts/rehash.sh — record trusted checksums\nbash scripts/deploy.sh — verify checksums, then deploy\n\nDry-run verification (no deployment):\n\nVERIFY_ONLY=true bash scripts/deploy.sh\n\n\nAfter a sub-skill update:\n\nReview the changed scripts\nbash scripts/rehash.sh to update the trusted baseline\nCommit the updated checksums.sha256\nVerify\nbash scripts/status.sh\n\nUninstall\n\nUninstall each skill separately (in reverse order):\n\n# 1. Voice GUI (hook, UI injection, workspace files)\nbash skills/webchat-voice-gui/scripts/uninstall.sh\n\n# 2. HTTPS Proxy (service, gateway config, certs)\nbash skills/webchat-https-proxy/scripts/uninstall.sh\n\n# 3. STT Backend (service, venv)\nsystemctl --user stop openclaw-transcribe.service\nsystemctl --user disable openclaw-transcribe.service\nrm -f ~/.config/systemd/user/openclaw-transcribe.service\nsystemctl --user daemon-reload\n\nNotes\nThis meta-skill is a convenience wrapper. All actual logic lives in the three sub-skills.\nReview each sub-skill's scripts and security notes before running.\nThe WORKSPACE and SKILLS_DIR paths are configurable via environment variables."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/neldar/webchat-voice-full-stack",
    "publisherUrl": "https://clawhub.ai/neldar/webchat-voice-full-stack",
    "owner": "neldar",
    "version": "0.4.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/webchat-voice-full-stack",
    "downloadUrl": "https://openagent3.xyz/downloads/webchat-voice-full-stack",
    "agentUrl": "https://openagent3.xyz/skills/webchat-voice-full-stack/agent",
    "manifestUrl": "https://openagent3.xyz/skills/webchat-voice-full-stack/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/webchat-voice-full-stack/agent.md"
  }
}