小爱音箱控制器 🎵

优雅地控制你的小米智能音箱

功能特性

• 🎯 智能设备名匹配 - 说"小爱"即可，自动识别音箱
• 🔊 完整媒体控制 - 播放/暂停/切歌/音量调节
• 🗣️ TTS 语音播报 - 让音箱说话，适合提醒和通知
• ⏰ 定时任务支持 - 自动提醒，无需人工值守
• 💾 本地缓存 - 设备信息持久化，响应更快

设备要求

• 小米/米家智能音箱（如小爱音箱Pro）
• 设备需绑定到小米账号并联网

快速开始

1. 安装依赖

pip3 install mijiaAPI

2. 首次登录

python3 -m mijiaAPI --list_homes

扫描显示的二维码，用米家 APP 完成登录。

3. 查看设备

python3 scripts/xiaomi-speaker.py list

输出示例：

🎵 找到 1 个音箱设备:

  1. 小爱音箱Pro (xiaomi.wifispeaker.lx06)
     DID: 936030139...

命令参考

基础控制

# 播放/暂停
python3 scripts/xiaomi-speaker.py play 小爱
python3 scripts/xiaomi-speaker.py pause 小爱

# 切歌
python3 scripts/xiaomi-speaker.py next 小爱
python3 scripts/xiaomi-speaker.py prev 小爱

# 音量调节 (0-100)
python3 scripts/xiaomi-speaker.py volume 小爱 50

# 查看状态
python3 scripts/xiaomi-speaker.py status 小爱

TTS 语音播报

python3 scripts/xiaomi-speaker.py say 小爱 "该起床啦"
python3 scripts/xiaomi-speaker.py say 小爱 "晚上八点开家庭会议"

刷新设备列表

当新增设备或修改设备名称后：

python3 scripts/xiaomi-speaker.py refresh

定时提醒（Cron 任务）

添加定时提醒

# 一次性提醒
openclaw cron add --at "2026-02-21T11:30:00+08:00" \
  --message "让小爱音箱播报：中午啦，全家人一起去吃涮羊肉吧！"

# 每日重复提醒
openclaw cron add --cron "30 21 * * *" \
  --message "让小爱音箱播报：九点半啦，哥哥和弟弟都要去刷牙睡觉啦！"

常用时间格式

自然语言使用

在 OpenClaw 中直接描述你的需求：

• "把客厅音箱音量调到 50"
• "小爱播放音乐"
• "让小爱播报北京天气"
• "设置明天早上 8 点提醒哥哥上作文课"

故障排除

登录失效

rm ~/.config/mijia-api/auth.json
python3 -m mijiaAPI --list_homes  # 重新登录

找不到设备

1. 确认设备在米家 APP 中在线
2. 运行 python3 scripts/xiaomi-speaker.py refresh 刷新列表
3. 检查设备名称是否包含 "音箱"、"小爱" 等关键词

TTS 播报失败

部分音箱型号可能不支持 play-text 动作，可通过以下命令检查：

python3 -m mijiaAPI --get_device_info xiaomi.wifispeaker.lx06

查看 actions 列表中是否包含 play-text。

技术说明

• 基于 mijiaAPI 调用小米云端 API
• 设备信息缓存在 ~/.config/xiaomi-speaker/devices.json
• 登录状态保存在 ~/.config/mijia-api/auth.json
• TTS 功能通过 play-text action（siid=5, aiid=1）实现

更新日志

v1.0 (2026-02-21)

• ✅ 设备发现和智能名称匹配
• ✅ 播放/暂停/切歌/音量控制
• ✅ TTS 语音播报
• ✅ 本地设备缓存
• ✅ 定时提醒集成

路线图

• 支持更多音箱型号
• 音乐播放列表控制
• 智能家居场景联动
• 语音唤醒词设置

优雅的不是技术，是体验。 🦐