exec(command='jarvis "你的语音文本内容。"', background=true)

该脚本（~/.local/bin/jarvis）同时完成两件事：(a) 通过 chat.inject 网关 RPC 将文本以紫色 **Jarvis:** *…* 气泡形式发布至聊天 UI；且 (b) 播放带金属质感的 TTS 音频。你无需手动编写 **Jarvis:** 行——脚本是唯一可信源（single source of truth），因此界面上显示的内容永远与实际播报内容严格一致（旧版依赖提示词驱动的重复逻辑已彻底移除，修复日期：2026-05-30）。

按信道自动管控：语音播报 + 气泡发布仅在主 Tinker-UI 会话中触发——脚本读取环境变量 $TC_SESSION_KEY（格式为 agent:::），仅当 channel 为 tinker 时才执行。WhatsApp / cron / 子智能体等上下文均不会触发语音或气泡，全程无需你在每轮响应中做判断。静音开关（~/.openclaw/data/jarvis-muted.json）可关闭语音播放，但仍保留气泡发布。如需覆盖默认允许信道，请设置 TC_VOICE_CHANNEL 环境变量。

命令参考

jarvis "你好，这是一次测试"

• 后端引擎：sherpa-onnx 离线 TTS（Alan 声音，英式英语，en_GB-alan-medium）
• 语速：2 倍速（--vits-length-scale=0.5）
• 音频效果链（ffmpeg）：
  • 音高提升 5% —— 强化 AI 的紧凑感
  • 镶边（Flanger）效果 —— 赋予金属光泽
  • 15ms 延迟回声 —— 增添机械感余韵
  • 200Hz 高通滤波 + 高频增益 +6dB —— 实现 HUD 式清晰听感
• 输出方式：通过 aplay 播放至默认音频设备，随后自动清理临时文件
• 语言支持：仅限英语。Alan 模型无法处理其他语言。

Webchat 紫色样式支持

OpenClaw Webchat 内置了对 Jarvis 语音文本的样式支持：

• ui/src/styles/chat/text.css —— .jarvis-voice 类定义紫色斜体样式（暗色主题下为 #9b59b6，亮色主题下为 #8e44ad）
• ui/src/ui/markdown.ts —— 渲染后钩子（Post-render hook）自动将 Jarvis: 后的文本包裹进 元素

这意味着你只需在 Markdown 中写作 **Jarvis:** *文本*，Webchat 即自动完成紫色渲染，无需额外标记。

对于非 Webchat 终端（如 WhatsApp、Telegram 等），粗体+斜体 Markdown 将原生渲染 —— 虽无紫色，但仍具备视觉区分度。

安装说明（适用于新部署）

依赖项包括：

• sherpa-onnx 运行时，路径为 ~/.openclaw/tools/sherpa-onnx-tts/
• Alan medium 模型，路径为 ~/.openclaw/tools/sherpa-onnx-tts/models/vits-piper-en_GB-alan-medium/
• 系统级全局安装的 ffmpeg
• 用于音频播放的 aplay（ALSA）
• jarvis 脚本，位于 ~/.local/bin/jarvis（或已加入 PATH）

jarvis 脚本

#!/bin/bash
# Jarvis TTS - authentic JARVIS-style voice
# Usage: jarvis "Hello, this is a test"

export LD_LIBRARY_PATH=$HOME/.openclaw/tools/sherpa-onnx-tts/lib:$LD_LIBRARY_PATH

RAW_WAV="/tmp/jarvis_raw.wav"
FINAL_WAV="/tmp/jarvis_final.wav"

# Generate speech
$HOME/.openclaw/tools/sherpa-onnx-tts/bin/sherpa-onnx-offline-tts 
  --vits-model=$HOME/.openclaw/tools/sherpa-onnx-tts/models/vits-piper-en_GB-alan-medium/en_GB-alan-medium.onnx 
  --vits-tokens=$HOME/.openclaw/tools/sherpa-onnx-tts/models/vits-piper-en_GB-alan-medium/tokens.txt 
  --vits-data-dir=$HOME/.openclaw/tools/sherpa-onnx-tts/models/vits-piper-en_GB-alan-medium/espeak-ng-data 
  --vits-length-scale=0.5 
  --output-filename="$RAW_WAV" 
  "$@" >/dev/null 2>&1

# Apply JARVIS metallic processing
if [ -f "$RAW_WAV" ]; then
  ffmpeg -y -i "$RAW_WAV" 
    -af "asetrate=22050*1.05,aresample=22050,
flanger=delay=0:depth=2:regen=50:width=71:speed=0.5,
aecho=0.8:0.88:15:0.5,
highpass=f=200,
treble=g=6" 
    "$FINAL_WAV" -v error

  if [ -f "$FINAL_WAV" ]; then
    aplay -D plughw:0,0 -q "$FINAL_WAV"
    rm "$RAW_WAV" "$FINAL_WAV"
  fi
fi

WhatsApp 语音备忘录

针对 WhatsApp 场景，输出需为 OGG/Opus 格式而非扬声器播放：

sherpa-onnx-offline-tts --vits-length-scale=0.5 --output-filename=raw.wav "text"
ffmpeg -i raw.wav 
  -af "asetrate=22050*1.05,aresample=22050,flanger=delay=0:depth=2:regen=50:width=71:speed=0.5,aecho=0.8:0.88:15:0.5,highpass=f=200,treble=g=6" 
  -c:a libopus -b:a 64k output.ogg

完整的 JARVIS 体验

jarvis-voice 赋予你的智能体以声音；搭配 ai-humor-ultimate，则进一步赋予它一颗灵魂——冷面幽默、上下文感知式笑点、那种让你对着终端屏幕会心一笑的克制式讽刺。

这一组合，是我们持续构建的 12 技能认知架构的一部分——涵盖语音、幽默、记忆、推理等模块。配套研究论文一并开源，因为我们就是这么执着。

👉 探索完整项目： github.com/globalcaos/tinkerclaw

克隆它。Fork 它。破坏它。然后，让它成为你的。

配置：工作区文件

为确保语音功能在新建会话中稳定生效，请将模板文件复制至工作区根目录：

cp {baseDir}/templates/VOICE.md ~/.openclaw/workspace/VOICE.md
cp {baseDir}/templates/SESSION.md ~/.openclaw/workspace/SESSION.md
cp {baseDir}/templates/HUMOR.md ~/.openclaw/workspace/HUMOR.md

• VOICE.md —— 每次会话自动注入，强制执行语音输出规则（类似 SOUL.md）
• SESSION.md —— 会话启动模板，内含语音问候要求
• HUMOR.md —— 幽默配置文件，启用全部四种模式（冷面幽默、自我觉察型 AI、外星观察者、字面化习语），频率设为最大值（1.0）

上述两个文件均由 OpenClaw 的工作区注入机制自动加载。智能体将在每次会话的首个回复中即开始语音播报。

包含文件