必须同时打通硬件权限、本地语音模型、多端通道配置三道关卡:①确认音频设备与系统权限就绪;②安装验证Whisper(STT)+Edge TTS(TTS)本地引擎;③按桌面/微信/Discord/安卓Termux场景分别启用语音通道,并通过hermes doctor --voice验证闭环。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让Hermes Agent真正听清你说的每一句话、用自然语音回应、还能在微信/Discord/手机Termux等不同场景下持续稳定工作,必须同时打通硬件权限、本地语音模型、多端通道配置三道关卡,缺一不可。
确认音频设备与系统权限就绪
90%的语音失败源于麦克风被系统静默拦截——哪怕物理设备正常,权限未开就等于没接线。
在Windows中:打开“设置”→“隐私和安全性”→“麦克风”,确保全局开关开启,并在下方应用列表中找到HermesAgent,将其右侧滑块设为“开”。【若列表中无HermesAgent,需先运行一次hermes agentstart命令,触发系统注册】
在macOS中:前往“系统设置”→“隐私与安全性”→“麦克风”,点击左下角“+”号,手动添加路径/Applications/HermesAgent.app/Contents/MacOS/HermesAgent。
安卓Termux用户:执行hermes doctor --audio,确认output: ok;如失败,检查是否已安装ffmpeg及Python 3.11+。
安装并验证本地STT/TTS引擎
语音交互不能依赖云端API——延迟高、隐私弱、离线即瘫痪。Hermes默认推荐Whisper(STT)+ Edge TTS(TTS)组合,全部本地运行。
方法一:一键安装TTS
运行hermes tools install edge-tts,完成后执行hermes tts test "你好",听到语音即表示TTS就绪。
方法二:部署Whisper STT
执行hermes tools install whisper,模型自动下载至~/.hermes/models/whisper;首次运行hermes voice start时会加载tiny模型,5秒内完成冷启动。
注意:不要手动替换models目录下的whisper.bin文件——模型哈希校验失败会导致语音监听直接跳过识别阶段,界面无报错但始终沉默。
按场景启用语音通道
语音不是全局常驻功能,每个使用场景需独立激活,且触发方式完全不同。
第一步:桌面客户端语音监听
启动HermesAgent,点击主界面右上角麦克风图标,图标由灰色变为蓝色即表示语音监听已就绪。
第二步:微信通道语音接入
在微信中向HermesBot发送指令/hermes voice enable,收到“✅ 语音输入已启用”回复后,后续语音消息将自动转文字进入对话流。
第三步:Discord双向语音
回OAuth2授权页勾选“Connect”和“Speak”权限,重新走一遍授权URL;用户进入语音频道后,在文字频道输入/voice → 选择tts选项,AI语音将直接在频道内播放。
第四步:安卓Termux离线语音
在Termux中执行hermes voice start,听到“滴”提示音后开始说话;说完停顿约3秒,识别文本自动提交,响应语音随即合成播放——全程不联网。
验证端到端闭环是否生效
执行hermes doctor --voice,观察输出是否同时包含stt: ok、tts: ok、channel: active三项均为ok状态。
若任意一项failed,返回对应小节重检:stt failed优先查whisper安装路径与模型完整性;tts failed优先重跑hermes tts test;channel failed需确认当前所在平台是否已完成该场景的语音开关指令。
说一句“把刚才的会议要点整理成 bullet point”,观察是否触发text_to_speech工具调用、生成结构化摘要、再以语音播报完整结果。
