核心用法
webchat-voice-full-stack 是一个元安装器（meta-installer），通过编排三个独立技能实现 OpenClaw WebChat 的完整语音输入能力：
1. `faster-whisper-local-service` — 本地 STT 后端，基于 faster-whisper 在 127.0.0.1:18790 提供 HTTP 转写服务
2. `webchat-https-proxy` — HTTPS/WSS 反向代理，为 Control UI 和 WebSocket 提供 TLS 加密通道
3. `webchat-voice-gui` — 语音交互界面，包含麦克风按钮、VU 音量表、Push-to-Talk 快捷键、多语言支持（EN/DE/ZH）
部署流程：先安装三个子技能，执行 bash scripts/deploy.sh 即可自动完成环境配置、服务注册与 UI 注入。
显著优点
- 零后续成本：模型首次下载后（~1.5GB medium 模型），无 API 调用费用，无订阅
- 完全本地运行：语音数据不离本机，隐私可控
- 完整性校验：SHA256 校验所有子技能脚本，篡改即中止部署
- 用户级隔离：仅使用 systemd user 服务，无需 root 权限
- 可逆部署：提供明确卸载脚本，所有变更可追溯还原
- 现代 Web 体验：支持 PTT（Push-to-Talk）、连续录音、音量可视化、键盘快捷键
潜在缺点与局限性
- 硬件门槛：需 Python 3.10+、GStreamer、约 2GB 磁盘空间；medium 模型在 CPU 上实时性一般
- 首次联网：模型下载需互联网，无法完全离线初始化
- 自签名证书：HTTPS 代理使用自签名 TLS 证书，浏览器首次访问需手动信任
- 平台限制：当前仅支持 systemd 的 Linux 发行版
- 维护复杂度：三技能协同，更新时需逐个审查并重新生成校验和
适合人群
- 注重隐私、希望语音数据完全本地处理的 WebChat 用户
- 愿意投入初始配置时间以换取零订阅成本的自托管爱好者
- 需要离线环境或内网部署的企业/机构场景
常规风险
- 模型供应链风险：faster-whisper 及模型权重来自 PyPI/Hugging Face，需信任上游
- 自签名证书信任问题：用户需手动处理 TLS 证书警告
- 脚本完整性依赖：校验和机制依赖用户正确执行
rehash.sh，误操作可能导致预期外执行 - 服务持久化：systemd user 服务默认随用户会话启动，多用户系统需注意资源隔离