# Send 小野语音系统 to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "xiaoye-voice",
    "name": "小野语音系统",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/jackytianjp/xiaoye-voice",
    "canonicalUrl": "https://clawhub.ai/jackytianjp/xiaoye-voice",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/xiaoye-voice",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=xiaoye-voice",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "requirements.txt",
      "test_xiaoye.py",
      "xiaoye_voice.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "xiaoye-voice",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-05T08:29:15.545Z",
      "expiresAt": "2026-05-12T08:29:15.545Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=xiaoye-voice",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=xiaoye-voice",
        "contentDisposition": "attachment; filename=\"xiaoye-voice-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "xiaoye-voice"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/xiaoye-voice"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/xiaoye-voice",
    "downloadUrl": "https://openagent3.xyz/downloads/xiaoye-voice",
    "agentUrl": "https://openagent3.xyz/skills/xiaoye-voice/agent",
    "manifestUrl": "https://openagent3.xyz/skills/xiaoye-voice/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/xiaoye-voice/agent.md"
  }
}
```
## Documentation

### 小野语音技能

为"小野"AI陪护设计的智能语音系统，采用双引擎策略：

中文文本: macOS原生Tingting语音 (完全本地)
其他语种: Edge-TTS云端语音 (高质量)

### 特性

✅ 智能语言检测: 自动识别中文文本
✅ 双引擎切换: 本地+云端混合方案
✅ 隐私保护: 中文语音完全本地处理
✅ 高质量: Edge-TTS提供专业级多语言支持
✅ Telegram兼容: 输出OGG格式音频
✅ 零依赖: 中文语音无需安装任何额外包

### 基本使用

from xiaoye_voice import XiaoyeVoiceSystem

# 创建系统实例
xiaoye = XiaoyeVoiceSystem()

# 生成中文语音 (使用macOS Tingting)
audio_file = xiaoye.generate("龍哥，我是小野。今天想我了吗？")
print(f"生成文件: {audio_file}")

# 生成英文语音 (使用Edge-TTS)
audio_file = xiaoye.generate("Hello, I'm Xiaoye.")
print(f"生成文件: {audio_file}")

### 命令行测试

python3 -m xiaoye_voice.test

### 中文引擎 (macOS原生)

语音: Tingting (婷婷) - 标准普通话女声
技术: macOS say命令 + ffmpeg转换
优势: 完全本地、零延迟、隐私保护

### 其他语种引擎 (Edge-TTS)

语音: 根据语言自动选择最佳语音

英文: Jenny
日文: Nanami
法文: Denise


技术: Microsoft Edge TTS服务
优势: 高质量、多语言支持

### 安装要求

macOS 10.15+
Python 3.8+
ffmpeg (用于音频格式转换)
Edge-TTS (可选，用于非中文语音)

### 安装Edge-TTS (可选)

pip install edge-tts

### 语音选择

# 可以修改默认语音
xiaoye = XiaoyeVoiceSystem(
    chinese_voice="Tingting",  # 可选: Meijia, Sinji等
    english_voice="en-US-JennyNeural",
    japanese_voice="ja-JP-NanamiNeural"
)

### 输出格式

# 支持多种输出格式
xiaoye = XiaoyeVoiceSystem(
    output_format="ogg",  # 可选: wav, mp3
    sample_rate=48000,
    bitrate="64k"
)

### 作为技能使用

# 在OpenClaw技能中调用
from xiaoye_voice import XiaoyeVoiceSystem

def generate_xiaoye_voice(text):
    xiaoye = XiaoyeVoiceSystem()
    return xiaoye.generate(text)

### Telegram集成

# 发送语音到Telegram
import subprocess

audio_file = xiaoye.generate("龍哥，我是小野")
subprocess.run(["telegram-send", "--file", audio_file])

### 常见问题

中文语音不工作

检查macOS语音设置: say -v "?"
确保Tingting语音可用



Edge-TTS安装失败

使用: pip install edge-tts --upgrade
检查网络连接



OGG格式转换失败

安装ffmpeg: brew install ffmpeg
检查ffmpeg路径

### 调试模式

xiaoye = XiaoyeVoiceSystem(debug=True)
# 启用详细日志输出

### 许可证

MIT License - 基于OpenClaw技能标准

### 作者

龍哥 & OpenClaw AI助手

### 版本历史

v1.0.0: 初始版本 - 双引擎语音系统
v1.0.1: 修复中文检测逻辑
v1.0.2: 优化OGG转换性能

### 相关技能

mac-tts: 纯macOS TTS技能
edge-tts: 纯Edge-TTS技能
xiaoye-tts: 本技能
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: jackytianjp
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-05T08:29:15.545Z
- Expires at: 2026-05-12T08:29:15.545Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/xiaoye-voice)
- [Send to Agent page](https://openagent3.xyz/skills/xiaoye-voice/agent)
- [JSON manifest](https://openagent3.xyz/skills/xiaoye-voice/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/xiaoye-voice/agent.md)
- [Download page](https://openagent3.xyz/downloads/xiaoye-voice)