WebChat Voice Full Stack

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

1. faster-whisper-local-service — local STT backend (HTTP on 127.0.0.1:18790)
2. webchat-https-proxy — HTTPS/WSS reverse proxy for Control UI + WebSocket + transcription
3. 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

  Skill工具集 © 2026