# Send WebChat Voice Full Stack to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- 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.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "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": {
    "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",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/architecture.md",
      "scripts/deploy.sh",
      "scripts/rehash.sh",
      "scripts/status.sh"
    ],
    "downloadMode": "redirect",
    "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."
      ]
    }
  },
  "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"
  }
}
```
## Documentation

### WebChat Voice Full Stack

Meta-installer that orchestrates three standalone skills in the correct order:

faster-whisper-local-service — local STT backend (HTTP on 127.0.0.1:18790)
webchat-https-proxy — HTTPS/WSS reverse proxy for Control UI + WebSocket + transcription
webchat-voice-gui — mic button, VU meter, keyboard shortcuts, i18n for WebChat

### Prerequisites

All three skills must be installed before running this meta-installer:

npx clawhub install faster-whisper-local-service
npx clawhub install webchat-https-proxy
npx clawhub install webchat-voice-gui

Additionally required on the system:

Python 3.10+
gst-launch-1.0 (GStreamer, from OS packages)
Internet access on first run (model download ~1.5 GB for medium)

### Deploy

bash scripts/deploy.sh

Optional overrides (passed through to downstream scripts):

VOICE_HOST=10.0.0.42 VOICE_HTTPS_PORT=8443 TRANSCRIBE_PORT=18790 WHISPER_LANGUAGE=auto bash scripts/deploy.sh

### What this does (via downstream scripts)

This skill does not contain deployment logic itself. It calls deploy.sh from each sub-skill:

### Step 1: faster-whisper-local-service

Creates Python venv, installs faster-whisper==1.1.1
Writes transcribe-server.py with input validation (magic-byte check, size limit)
Creates systemd user service openclaw-transcribe.service
Downloads model weights on first run (~1.5 GB for medium)

### Step 2: webchat-https-proxy

Copies https-server.py to workspace
Adds HTTPS origin to gateway.controlUi.allowedOrigins
Creates systemd user service openclaw-voice-https.service
Auto-generates self-signed TLS cert (TLS 1.2+ enforced)

### Step 3: webchat-voice-gui

Copies voice-input.js and injects <script> tag into Control UI
Installs gateway startup hook for update safety
Optional interactive language selection

For full details, security notes, and uninstall instructions, see each skill's SKILL.md.

### Security posture (why these changes are expected)

This is a meta-installer, so it coordinates downstream skills and applies only the minimum required local changes:

Persistence: creates user-level systemd services so STT/proxy survive reboot (openclaw-transcribe, openclaw-voice-https)
UI enablement: injects one explicit <script> tag for voice-input.js in Control UI
Gateway compatibility: appends one HTTPS origin to gateway.controlUi.allowedOrigins

Safety characteristics:

all changes are documented and reversible via uninstall scripts
no root/sudo required (user scope only)
no hidden background tasks beyond documented services
no outbound telemetry or data exfiltration behavior

### Integrity verification

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.

Workflow:

npx clawhub install <sub-skill> — fetch from registry
Audit the scripts manually or via code review
bash scripts/rehash.sh — record trusted checksums
bash scripts/deploy.sh — verify checksums, then deploy

Dry-run verification (no deployment):

VERIFY_ONLY=true bash scripts/deploy.sh

After a sub-skill update:

Review the changed scripts
bash scripts/rehash.sh to update the trusted baseline
Commit the updated checksums.sha256

### Verify

bash scripts/status.sh

### Uninstall

Uninstall each skill separately (in reverse order):

# 1. Voice GUI (hook, UI injection, workspace files)
bash skills/webchat-voice-gui/scripts/uninstall.sh

# 2. HTTPS Proxy (service, gateway config, certs)
bash skills/webchat-https-proxy/scripts/uninstall.sh

# 3. STT Backend (service, venv)
systemctl --user stop openclaw-transcribe.service
systemctl --user disable openclaw-transcribe.service
rm -f ~/.config/systemd/user/openclaw-transcribe.service
systemctl --user daemon-reload

### Notes

This meta-skill is a convenience wrapper. All actual logic lives in the three sub-skills.
Review each sub-skill's scripts and security notes before running.
The WORKSPACE and SKILLS_DIR paths are configurable via environment variables.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: neldar
- Version: 0.4.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-10T23:52:40.934Z
- Expires at: 2026-05-17T23:52:40.934Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/webchat-voice-full-stack)
- [Send to Agent page](https://openagent3.xyz/skills/webchat-voice-full-stack/agent)
- [JSON manifest](https://openagent3.xyz/skills/webchat-voice-full-stack/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/webchat-voice-full-stack/agent.md)
- [Download page](https://openagent3.xyz/downloads/webchat-voice-full-stack)