用于OpenClaw WebChat语音输入的本地语音转文本一步式全栈安装程序。按顺序协调三个专注技能:本地STT后端(快速...
WebChat Voice Full Stack.
功能概述
WebChat Voice Full Stack.是一项面向实际任务的技能,主要用于Meta-installer 以正确的顺序指挥三种独立技能: . faster-whiper-local-service — 本地STT后端(HTTP on 127.0.0.1:18790).webchat-https-.。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
核心要点
- 使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。
- 从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
- 实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
使用与执行
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;
结果检查与注意事项
涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
WebChat 语音全栈
元安装器,按正确顺序编排三个独立技能:
faster-whisper-local-service— 本地 STT 后端(HTTP,监听 127.0.0.1:18790)webchat-https-proxy— 面向 Control UI、WebSocket 及语音转录功能的 HTTPS/WSS 反向代理webchat-voice-gui— 麦克风按钮、VU 表、键盘快捷键、WebChat 的国际化(i18n)支持
前提条件
运行此元安装器前,必须已安装全部三个技能:
npx clawhub install faster-whisper-local-service npx clawhub install webchat-https-proxy npx clawhub install webchat-voice-gui
系统还需满足以下要求:
- Python 3.10+
gst-launch-1.0(GStreamer,需通过操作系统包管理器安装)- 首次运行时需联网(下载模型约 1.5 GB,对应
medium模型)
部署
bash scripts/deploy.sh
可选参数覆盖(将透传至下游脚本):
VOICE_HOST=10.0.0.42 VOICE_HTTPS_PORT=8443 TRANSCRIBE_PORT=18790 WHISPER_LANGUAGE=auto bash scripts/deploy.sh
该操作的具体内容(通过下游脚本实现)
本技能本身不包含**任何部署逻辑。它仅依次调用各子技能中的 deploy.sh 脚本:
步骤 1:faster-whisper-local-service
- 创建 Python 虚拟环境,并安装
faster-whisper==1.1.1 - 生成
transcribe-server.py,内含输入校验逻辑(魔数检查、大小限制) - 创建用户级 systemd 服务
openclaw-transcribe.service - 首次运行时自动下载模型权重(
medium模型约 1.5 GB)
步骤 2:webchat-https-proxy
- 将
https-server.py复制到 workspace 目录 - 向
gateway.controlUi.allowedOrigins配置项追加 HTTPS 协议的来源地址 - 创建用户级 systemd 服务
openclaw-voice-https.service - 自动生成自签名 TLS 证书(强制启用 TLS 1.2+)
步骤 3:webchat-voice-gui
- 复制
voice-input.js并向 Control UI 注入一个标签 - 安装 gateway 启动钩子(确保升级安全)
- 支持可选的交互式语言选择
如需完整说明、安全注意事项及卸载指南,请参阅各子技能的 SKILL.md 文件。
安全策略(为何这些变更属预期行为)
本项目为元安装器,其作用仅为协调下游技能,并仅应用最小必需的本地变更:
- 持久化:创建用户级 systemd 服务,确保 STT 和反向代理在系统重启后仍能运行(
openclaw-transcribe、openclaw-voice-https) - UI 启用:在 Control UI 中显式注入一个
标签以加载voice-input.js - 网关兼容性:向
gateway.controlUi.allowedOrigins配置项追加一个 HTTPS 协议的来源地址
安全性特征:
- 所有变更均已文档化,并可通过卸载脚本完全回退
- 无需 root 或 sudo 权限(仅限用户空间)
- 除明确文档中列出的服务外,无其他隐藏后台任务
- 无任何外发遥测或数据外泄行为
完整性校验
执行任一子技能脚本前,deploy.sh 均会依据 scripts/checksums.sha256 文件,对所有子技能脚本进行 SHA256 校验。若任一脚本在安装后被修改(例如因注册表更新或恶意篡改),部署流程将立即中止并输出明确错误提示。
标准工作流:
npx clawhub install— 从注册表拉取技能- 手动审计脚本,或通过代码审查确认其安全性
bash scripts/rehash.sh— 记录可信校验和基准值bash scripts/deploy.sh— 先校验再部署
仅校验模式(不执行部署):
VERIFY_ONLY=true bash scripts/deploy.sh
子技能更新后操作:
- 审阅变更后的脚本
- 运行
bash scripts/rehash.sh更新可信校验和基准值 - 提交更新后的
checksums.sha256文件
验证状态
bash scripts/status.sh
卸载
请按逆序分别卸载各技能:
# 1. 语音 GUI(钩子、UI 注入、workspace 文件) bash skills/webchat-voice-gui/scripts/uninstall.sh # 2. HTTPS 反向代理(服务、网关配置、证书) bash skills/webchat-https-proxy/scripts/uninstall.sh # 3. STT 后端(服务、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
备注
- 本元技能仅为便捷封装,所有实际逻辑均位于三个子技能中。
- 运行前请务必审阅各子技能的脚本及其安全说明。
WORKSPACE和SKILLS_DIR路径可通过环境变量配置。
热门AI工具
相关专题
本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。
0
2026.10.22
本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。
0
2026.10.22
本专题整理Golangci-lint常用Linters的用途与配置方法,覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查,帮助项目合理选规则。
0
2026.10.22
本专题介绍Gradle Java项目构建方法,涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查,帮助你理解各阶段的任务关系,逐步完成项目构建。
0
2026.10.22
本专题汇总PHP常见时间戳漏洞,包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等,并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案,帮助开发者快速排查和加固时间相关代码。
0
2026.10.22
本专题聚焦Golangci-lint YAML配置文件,讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置,便于团队统一检查标准。
0
2026.10.22
本专题讲解Golangci-lint的安装、初始化、基础命令和首次代码检查,覆盖本地环境、Docker及多平台用法,帮助Go开发者快速上手。
0
2026.10.22
PHP2Shell漏洞是什么,哪些PHP版本和运行环境会受到影响,服务器应该如何检测与修复?本专题提供版本自查脚本、Linux与Docker升级命令、PHP-FPM和Apache排查步骤,以及修复验证、临时缓解和应急响应方案。
0
2026.10.22
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.5万人学习
共6课时 | 54.7万人学习
