用于OpenClaw WebChat语音输入的本地语音转文本一步式全栈安装程序。按顺序协调三个专注技能:本地STT后端(快速...
WebChat Voice Full Stack.是一项面向实际任务的技能,主要用于Meta-installer 以正确的顺序指挥三种独立技能: . faster-whiper-local-service — 本地STT后端(HTTP on 127.0.0.1:18790).webchat-https-.。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;
涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
元安装器,按正确顺序编排三个独立技能:
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
系统还需满足以下要求:
gst-launch-1.0(GStreamer,需通过操作系统包管理器安装)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 脚本:
faster-whisper-local-servicefaster-whisper==1.1.1transcribe-server.py,内含输入校验逻辑(魔数检查、大小限制)openclaw-transcribe.servicemedium 模型约 1.5 GB)webchat-https-proxyhttps-server.py 复制到 workspace 目录gateway.controlUi.allowedOrigins 配置项追加 HTTPS 协议的来源地址openclaw-voice-https.servicewebchat-voice-guivoice-input.js 并向 Control UI 注入一个 标签如需完整说明、安全注意事项及卸载指南,请参阅各子技能的 SKILL.md 文件。
本项目为元安装器,其作用仅为协调下游技能,并仅应用最小必需的本地变更:
openclaw-transcribe、openclaw-voice-https) 标签以加载 voice-input.jsgateway.controlUi.allowedOrigins 配置项追加一个 HTTPS 协议的来源地址安全性特征:
执行任一子技能脚本前,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 路径可通过环境变量配置。相关专题
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 133.9万人学习
共49课时 | 82.5万人学习