小爱音箱语音播报。一句话让小爱说话,无需编写代码,支持定时提醒、远程喊话、家庭传话。
一句话控制小爱音箱,把智能音箱变成你的私人助理
export MI_USER="你的小米账号"
export MI_PASS="你的小米密码"
xiaoai say "饭做好了,快来吃!"
git clone https://github.com/zkfan/xiaoai-speaker.git
cd xiaoai-speaker
export MI_USER="你的小米账号"
export MI_PASS="你的小米密码"
export MI_DEVICE_NAME="客厅" # 可选
# 添加到 ~/.zshrc 永久生效
echo 'export MI_USER="你的小米账号"' >> ~/.zshrc
echo 'export MI_PASS="你的小米密码"' >> ~/.zshrc
source ~/.zshrc
# 测试连接
python3 xiaoai_cli.py test
# 基础播报
python3 xiaoai_cli.py say "该喝水啦"
# 指定房间播报
python3 xiaoai_cli.py say --device "儿童房" "该写作业了"
# 查看设备
python3 xiaoai_cli.py list
| 功能 | 说明 |
|---|---|
| 🎯 零代码 | 无需 Python,一句话即可使用 |
| 🏠 多设备 | 支持选择不同房间的小爱音箱 |
| ⏰ 定时任务 | 可配合 cron 使用 |
| 🌐 远程控制 | 不在家也能让小爱喊话 |
| 🔒 安全 | 账号信息通过环境变量传入,不存储 |
export MI_USER="136xxxxxxxx" # 小米账号
export MI_PASS="yourpassword" # 小米密码
export MI_DEVICE_NAME="客厅" # 默认设备名(可选)
# 查看帮助
python3 xiaoai_cli.py help
# 查看配置说明
python3 xiaoai_cli.py setup
# 测试连接
python3 xiaoai_cli.py test
# 列出设备
python3 xiaoai_cli.py list
# 简单播报
python3 xiaoai_cli.py say "你好小爱"
# 指定设备播报
python3 xiaoai_cli.py say --device "客厅" "欢迎回家"
小爱播报速度有限,建议控制在20字以内:
✅ 推荐:
❌ 避免:
# 编辑 crontab
crontab -e
# 每小时提醒喝水
0 * * * * export MI_USER="xxx" MI_PASS="xxx" && /usr/bin/python3 /path/to/xiaoai-speaker/xiaoai_cli.py say "该喝水了"
# 每天8点早安
0 8 * * * export MI_USER="xxx" MI_PASS="xxx" && /usr/bin/python3 /path/to/xiaoai-speaker/xiaoai_cli.py say "早上好"
# 每小时提醒喝水
openclaw cron add \
--name "喝水提醒" \
--schedule "0 * * * *" \
--command "export MI_USER='xxx' MI_PASS='xxx' && python3 /path/to/xiaoai_cli.py say '该喝水了'"
❌ 登录验证失败
解决步骤:
# 确保环境变量已设置
export MI_USER="你的小米账号"
export MI_PASS="你的小米密码"
# 验证
python3 xiaoai_cli.py setup
# 查看账号下所有设备
python3 xiaoai_cli.py list
# 确认小爱音箱已绑定到该小米账号
当前版本不支持直接调音量,可以通过消息暗示:
python3 xiaoai_cli.py say "大声提醒:该起床了!"
# 查看所有设备
python3 xiaoai_cli.py list
# 输出示例:
# 🎵 找到 2 个设备:
# 🔊 bc7e8679-xxxx 客厅的小爱音箱mini
# a1b2c3d4-xxxx 卧室的小爱音箱
# 指定设备播报(支持模糊匹配)
python3 xiaoai_cli.py say --device "客厅" "消息"
python3 xiaoai_cli.py say --device "卧室" "消息"
# 添加到 ~/.zshrc
echo 'alias xiaoai="python3 ~/.openclaw/skills/xiaoai-speaker/xiaoai_cli.py"' >> ~/.zshrc
source ~/.zshrc
# 然后可以直接使用
xiaoai say "该喝水啦"
xiaoai list
首次运行时会自动从 GitHub 克隆小米官方 SDK:
git clone https://github.com/Yonsm/MiService.git /tmp/MiService
这是小米云服务 API 的必要依赖,非本项目的安全风险。
| 依赖 | 用途 | 安装方式 |
|---|---|---|
aiohttp | HTTP 客户端 | pip install aiohttp |
MiService | 小米云服务 SDK | 运行时自动安装 |
ZIP package — ready to use