Xiaoai Speaker

Xiaomi AI Speaker (小爱音箱) Integration

Samantha can speak through your 小爱音箱 — not just send text, but actually talk to you out loud.

How It Works

Uses miservice to authenticate with Xiaomi account and call the MiNA (小爱) TTS API directly.

Core call:

await mina_service.text_to_speech(device_id, text)

That's it. Xiaomi handles the voice synthesis on-device.

Setup

1. Install dependencies

pip install miservice

2. Configure credentials

Create data/xiaoai_config.json:

{
  "mi_user": "your_xiaomi_account@email.com",
  "mi_pass": "your_password",
  "device_name": "小爱音箱",
  "use_command": false
}

Or use environment variables:

export MI_USER="your_xiaomi_account"
export MI_PASS="your_password"

3. Find your device ID

Run the discovery script:

python3 skills/xiaoai-speaker/scripts/discover_devices.py

This lists all your Xiaomi devices with their IDs. Copy the one for your 小爱音箱 into config.

Scripts

scripts/tts_bridge.py — Xiaomi TTS connection layer

# Discover devices
python3 skills/xiaoai-speaker/scripts/tts_bridge.py --discover --config .env

# Test connection
python3 skills/xiaoai-speaker/scripts/tts_bridge.py --test

# Speak directly
python3 skills/xiaoai-speaker/scripts/tts_bridge.py --speak "你到家了呀"

scripts/voice_assistant.py — Smart text filtering + async TTS

Automatically skips code blocks, URLs, and text that's too short/long.

python3 skills/xiaoai-speaker/scripts/voice_assistant.py --speak "今天累吗？"
python3 skills/xiaoai-speaker/scripts/voice_assistant.py --test

scripts/speak.py — Simple one-shot TTS

python3 skills/xiaoai-speaker/scripts/speak.py "早安"

Integration with Samantha

Location Events

When Samantha detects you've arrived home:

# In location awareness heartbeat
if zone_changed_to == "home":
    message = random.choice(home_arrival_messages)
    await xiaoai_speak(message)  # speaks through speaker
    # also send text message if Discord/WeChat connected

Shortcut Triggers

When iOS Shortcut fires "Leaving Work":

await xiaoai_speak("下班了？路上小心。")

Morning Routine

await xiaoai_speak("早安。今天有什么计划？")

Usage from OpenClaw

When Samantha wants to speak through the speaker, call:

python3 ~/.openclaw/workspace/skills/xiaoai-speaker/scripts/speak.py "<text>"

Or use the helper function in scripts/speak.py:

from skills.xiaoai_speaker.scripts.speak import xiaoai_speak
await xiaoai_speak("你到家了呀")

Config Reference

data/xiaoai_config.json:

{
  "mi_user": "xiaomi account email or phone",
  "mi_pass": "password",
  "device_name": "小爱音箱",
  "device_id": "optional, auto-discovered if omitted",
  "use_command": false,
  "mi_did": "optional, for miio_command fallback",
  "tts_command": "5-1"
}

use_command: true uses miio command fallback (older devices).

Trigger Phrases

• "通过小爱说..."
• "让小爱说..."
• "speak via xiaoai"
• "小爱播报"
• Location arrival/departure events
• Shortcut triggers with speak: true