mcpField
X
xiaomi-speaker

xiaomi-speaker

github.com/qingliu1617-art其他887 次安装38 周前更新
代码仓库

关于 xiaomi-speaker

用于通过小米云端 API 控制小米智能音箱的 Python 工具，适合需要管理播放和语音播报的米家用户。它支持设备名称匹配、本地设备缓存及定时提醒集成。

主要功能

  1. 01按名称匹配音箱设备
  2. 02播放、暂停、切歌和调音量
  3. 03通过 TTS 播报文本
  4. 04缓存设备信息
  5. 05集成 Cron 定时提醒

适用场景

  1. 01远程控制音箱播放和音量
  2. 02让音箱播报提醒或通知
  3. 03按计划安排每日语音提醒

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/qingliu1617-art/openclaw-xiaomi-speaker --skill xiaomi-speaker

安装后在 Claude Code 中输入/xiaomi-speaker确认已加载。

附带文件README.mdxiaomi-speaker.py

详细介绍

来自项目 README

小爱音箱控制器 🎵

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

功能特性

  • 🎯 智能设备名匹配 - 说"小爱"即可，自动识别音箱
  • 🔊 完整媒体控制 - 播放/暂停/切歌/音量调节
  • 🗣️ 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 "让小爱音箱播报：九点半啦，哥哥和弟弟都要去刷牙睡觉啦！"
常用时间格式
需求Cron 表达式
每天早上 8:3030 8 * * *
每天下午 2:3030 14 * * *
每天晚上 9:3030 21 * * *
工作日早上 7:000 7 * * 1-5

自然语言使用

在 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 语音播报
  • ✅ 本地设备缓存
  • ✅ 定时提醒集成

路线图

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

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

评论

支持 Markdown