senseaudio-voice

---

name: senseaudio-voice

version: 2.1.0

description: SenseAudio Voice - 语音合成 (TTS) + 语音识别 (ASR)，支持语言自动切换

metadata: {"openclaw":{"emoji":"🎤"}}

tags: [tts, asr, voice, senseaudio, edge, speech, audio, chinese, english, japanese, http]

---

# senseaudio-voice

> **SenseAudio Voice** - 语音合成 (TTS) + 语音识别 (ASR)，完整语音交互能力

基于 SenseAudio HTTP API + Edge TTS 实现，根据语言自动选择最佳方案。

✨ 特点

🎤 完整语音能力

🌍 语言支持策略

| 语言 | TTS 方案 | ASR 方案 | 说明 |

|------|---------|---------|------|

| **中文** | SenseAudio | SenseAudio | 需要大陆手机号 + 身份认证，免费使用 |

| **英语** | Edge TTS | SenseAudio | 海外友好，无需认证 |

| **日语** | Edge TTS | SenseAudio | 海外友好，无需认证 |

| **其他** | Edge TTS | SenseAudio | 默认降级方案 |

🔧 技术优势

🚀 快速使用

# 基础用法（自动检测语言）
python {baseDir}/scripts/tts.py "你好，这是语音测试"
python {baseDir}/scripts/tts.py "Hello, this is a test"
python {baseDir}/scripts/tts.py "こんにちは、テストです"

# 指定声音（仅 SenseAudio）
python {baseDir}/scripts/tts.py --voice male_0004_a "你好呀"

# 指定输出文件
python {baseDir}/scripts/tts.py -o output.wav "语音内容"

# 生成并播放
python {baseDir}/scripts/tts.py --play "宝贝，该写作业啦"

# 强制使用 Edge TTS（英语/日语推荐）
python {baseDir}/scripts/tts.py --engine edge "Hello, how are you?"

# 强制使用 SenseAudio（仅中文）
python {baseDir}/scripts/tts.py --engine senseaudio "你好，今天天气不错"

# 检查系统播放器
python {baseDir}/scripts/tts.py --check-players

📁 文件存储

**音频文件保存位置**: `{workspace}/audio/YYYY-MM-DD/`

/home/wang/.openclaw/agents/kids-study/workspace/audio/
└── 2026-03-14/
    ├── 095221_male0004a_测试完成，文件应该在.mp3
    └── 095158_male0004a_你好，音频文件现在保.mp3

🎤 可用语音

SenseAudio 声音（中文）

| 声音 ID | 性别 | 描述 |

|--------|------|------|

| `child_0001_a` | 童声 | ✅ 默认，亲切活泼，适合学习场景 |

| `male_0004_a` | 男 | 温暖男声 |

| `male_0001_a` | 男 | 成熟男声 |

| `female_0001_a` | 女 | 温柔女声 |

| `female_0002_a` | 女 | 活泼女声 |

Edge TTS 声音（英语/日语）

| 语言 | 声音代码 | 描述 |

|------|---------|------|

| **英语 (en-US)** | `en-US-JennyNeural` | 女声，清晰友好（默认） |

| | `en-US-GuyNeural` | 男声，温暖专业 |

| | `en-US-AriaNeural` | 女声，活泼自然 |

| **日语 (ja-JP)** | `ja-JP-NanamiNeural` | 女声，温柔清晰（默认） |

| | `ja-JP-KeitaNeural` | 男声，成熟稳重 |

📋 选项

| 选项 | 说明 | 默认值 |

|------|------|--------|

| `--voice, -v` | 语音 ID | child_0001_a (中文) / en-US-JennyNeural (英语) / ja-JP-NanamiNeural (日语) |

| `--output, -o` | 输出文件 | audio/YYYY-MM-DD/*.wav |

| `--play, -p` | 生成后自动播放 | true |

| `--format` | 音频格式 (wav/mp3) | wav |

| `--speed` | 语速 (0.5-2.0) | 1.0 |

| `--volume` | 音量 (0-10) | 1.0 |

| `--engine, -e` | 引擎 (senseaudio/edge/auto) | auto (自动检测) |

| `--lang, -l` | 语言 (zh/en/ja/auto) | auto (自动检测) |

🔧 配置

**SenseAudio API Key**: 从 `~/.openclaw/openclaw.json` 的 `env.SENSE_API_KEY` 读取

**Edge TTS**: 无需 API Key，直接调用 Microsoft Edge 服务

⚙️ 使用建议

📝 使用示例

中文场景（使用 SenseAudio）

# 默认童声（适合学习场景）
python {baseDir}/scripts/tts.py --play "宝贝，该写作业啦"

# 日常问候
python {baseDir}/scripts/tts.py --play "早上好呀，今天天气不错"

# 切换声音（男声）
python {baseDir}/scripts/tts.py --voice male_0004_a --play "该去上班啦"

# 调节语速
python {baseDir}/scripts/tts.py --speed 1.2 --play "这是快一点的语音"
python {baseDir}/scripts/tts.py --speed 0.8 --play "这是慢一点的语音"

英语场景（自动使用 Edge TTS）

# 英语问候（自动检测，使用 Edge TTS）
python {baseDir}/scripts/tts.py --play "Hello! How are you today?"

# 强制使用 Edge TTS
python {baseDir}/scripts/tts.py --engine edge --play "Good morning, everyone!"

# 使用男声
python {baseDir}/scripts/tts.py --voice en-US-GuyNeural --play "Let's start learning!"

日语场景（自动使用 Edge TTS）

# 日语问候（自动检测，使用 Edge TTS）
python {baseDir}/scripts/tts.py --play "こんにちは、お元気ですか？"

# 使用男声
python {baseDir}/scripts/tts.py --voice ja-JP-KeitaNeural --play "一緒に勉強しましょう！"

语言检测

# 自动检测语言并选择合适的引擎
python {baseDir}/scripts/tts.py --lang auto --play "Hello 你好 こんにちは"

🔌 API 接口

SenseAudio（中文）

Edge TTS（英语/日语）

⚠️ 注意事项

SenseAudio（中文）

Edge TTS（英语/日语）

通用

- 包含中文字符 → SenseAudio

- 包含日文字符（假名/汉字）→ Edge TTS

- 纯拉丁字母 → Edge TTS

- 混合语言 → 按主要字符类型判断

🔧 播放器检测

# 检查系统支持的播放器
python {baseDir}/scripts/tts.py --check-players

**输出示例**:

🔊 系统音频播放器检测
============================================================
✅ 找到 2 个可用播放器:

1. ALSA (WAV 原生支持)
   命令：aplay -q
   支持格式：wav

2. PulseAudio
   命令：paplay
   支持格式：wav, mp3, flac, ogg

💡 推荐:
   播放 WAV: ALSA (WAV 原生支持) (优先级最高)
   播放 MP3: PulseAudio

**播放流程**:

1. 验证文件存在性和完整性

2. 检测系统可用的播放器

3. 按优先级尝试播放

4. 失败时自动降级到下一个播放器

5. 所有播放器失败时给出详细错误日志和建议