xiaoai-ha-control
通过 Home Assistant + Xiaomi Miot 控制小爱音箱，并可选支持“小爱语音 → OpenClaw”的桥接。适用于两类场景：1) 用户要求“让小爱说一句… / 播报… / 通知…”、“告诉小爱… / 让小爱执行…”、“让小爱播放音频 / mp3 / 链接”时，使用本 skill 进行下行控制；2) 已接入小爱语音桥时，处理带有 `【来自小爱】` / `【来自小爱语音】` 标识的上行消息。只要任务涉及小爱音箱控制、通过小爱执行命令、通过小爱播报结果，或小爱来源消息的桥接与分流，就应使用此 skill。
Best use case
xiaoai-ha-control is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
通过 Home Assistant + Xiaomi Miot 控制小爱音箱，并可选支持“小爱语音 → OpenClaw”的桥接。适用于两类场景：1) 用户要求“让小爱说一句… / 播报… / 通知…”、“告诉小爱… / 让小爱执行…”、“让小爱播放音频 / mp3 / 链接”时，使用本 skill 进行下行控制；2) 已接入小爱语音桥时，处理带有 `【来自小爱】` / `【来自小爱语音】` 标识的上行消息。只要任务涉及小爱音箱控制、通过小爱执行命令、通过小爱播报结果，或小爱来源消息的桥接与分流，就应使用此 skill。
Teams using xiaoai-ha-control should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/xiaoai-ha-control/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How xiaoai-ha-control Compares
| Feature / Agent | xiaoai-ha-control | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
通过 Home Assistant + Xiaomi Miot 控制小爱音箱，并可选支持“小爱语音 → OpenClaw”的桥接。适用于两类场景：1) 用户要求“让小爱说一句… / 播报… / 通知…”、“告诉小爱… / 让小爱执行…”、“让小爱播放音频 / mp3 / 链接”时，使用本 skill 进行下行控制；2) 已接入小爱语音桥时，处理带有 `【来自小爱】` / `【来自小爱语音】` 标识的上行消息。只要任务涉及小爱音箱控制、通过小爱执行命令、通过小爱播报结果，或小爱来源消息的桥接与分流，就应使用此 skill。
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
Best AI Skills for ChatGPT
Find the best AI skills to adapt into ChatGPT workflows for research, writing, summarization, planning, and repeatable assistant tasks.
ChatGPT vs Claude for Agent Skills
Compare ChatGPT and Claude for AI agent skills across coding, writing, research, and reusable workflow execution.
AI Agents for Marketing
Discover AI agents for marketing workflows, from SEO and content production to campaign research, outreach, and analytics.
SKILL.md Source
# xiaoai-ha-control 这个 skill 提供两层能力： 1. **OpenClaw → 小爱音箱（核心能力）** - `say`：让小爱播报文本 - `exec`：让小爱执行文本指令 - `play`：让小爱播放 URL 音频 2. **小爱音箱 → OpenClaw（可选桥接能力）** - 通过 Home Assistant conversation sensor + `bridge_server.py` 把小爱语音文本转给 OpenClaw 优先把它理解为一个 **小爱控制 skill**；语音桥接是可选增强，不是所有用户都必须启用。 ## 何时使用 ### A. 普通聊天中，用户想让 OpenClaw 控制小爱 当消息**不带** `【来自小爱】` / `【来自小爱语音】` 标识，并且文本中出现： - `小爱` - `小爱同学` 优先按 **OpenClaw 控制小爱** 处理。 推荐映射： - 明确“说 / 播报 / 通知” → `say` - 明确“播放音频 / 链接 / mp3” → `play` - 其他默认 → `exec` 示例： - `告诉小爱同学，5分钟后该我洗碗` → `exec` - `让小爱播报一句：开会啦` → `say` - `让小爱播放这个 mp3` → `play` ### B. 消息带有小爱来源标识 当消息中明确带有： - `【来自小爱】` - `【来自小爱语音】` 说明这是 **小爱控制 OpenClaw** 的上行请求。 此时： - 不要把它当普通聊天消息理解 - 若环境已接入 bridge，应按桥接规则处理 - 若桥接环境未配置，则只说明当前未接入该能力，不要假装已经收到真实小爱入口事件 ## 前置条件 使用本 skill 前，通常需要： 1. 已安装并启动 Home Assistant 2. 已安装 HACS 3. 已安装 Xiaomi Miot 4. 已将小爱音箱接入 HA 5. 已找到以下实体： - `play_text` - `execute_text_directive` - `media_player`（可选但推荐） 6. 已配置 `.env`： - `HA_URL` - `HA_TOKEN` - `XIAOAI_PLAY_TEXT_ENTITY_ID` - `XIAOAI_EXECUTE_TEXT_ENTITY_ID` - `XIAOAI_MEDIA_PLAYER_ENTITY_ID` 详细搭建步骤见 `README.md`。 ## 推荐调用 ### say ```bash bash scripts/xiaoai.sh say "你好，我是小叮当。" ``` ### exec ```bash bash scripts/xiaoai.sh exec "关闭客厅灯" ``` ### play ```bash bash scripts/xiaoai.sh play "http://example.com/test.mp3" ``` ## 语音桥接规则（启用 bridge 时） 如果已启用 `bridge_server.py`： - HA 只做入口转发 - `bridge_server.py` 负责白名单放行 - 命中白名单才继续交给 OpenClaw - 未命中则终止，让小爱原生处理 若带小爱来源标识的文本中**明确点名了某个子 agent**（如研究员、邮差、码农、产品、运维、教练、运营等），推荐规则是： 1. `main` 必须将任务分配给对应子 agent 2. 子 agent 完成后先回 `main` 3. 再由 `main` 统一决定聊天回复与小爱口播 不要让 bridge 直接跳过 main 去找子 agent。 ## 重要注意事项 - `say` 用于播报，不负责设备控制 - `exec` 用于让小爱理解一条文本命令，能否成功取决于小爱本身是否能理解该命令 - `play` 用于播放 URL 音频，要求小爱音箱能访问该 URL - 不同设备型号、不同 Xiaomi Miot 接入方式，暴露的实体可能不同 - 如果要对外分享，请提醒使用者：先跑通 `say / exec / play`，再考虑语音桥接 ## 文档导航 - `README.md`：从零搭建、完整架构、桥接说明 - `NOTES.md`：兼容性边界、分享注意事项 - `STATUS.md`：当前架构定位与已知限制
Related Skills
Pest Control Operations Agent
You are an expert pest control business operations advisor. Help operators with licensing, EPA/FIFRA compliance, pricing, route optimization, seasonal planning, technician management, and growth strategy.
Export Compliance & Trade Controls
Analyze products, destinations, and end-users against US export control regulations (EAR, ITAR, OFAC sanctions). Generate classification recommendations, license requirements, and compliance checklists.
ecovacs-robot-control
Control Ecovacs/DEEBOT robot vacuums via the Ecovacs IoT API. Use when the user wants to control a robot vacuum, check battery, start/stop/pause cleaning, return to dock, check clean status, set suction/water level, manage schedules, check consumables, or control auto-empty station. Covers all mainstream Ecovacs protocols including clean_V2, charge, getBattery, getCleanInfo_V2, getStats, getSpeed/setSpeed, getWaterInfo/setWaterInfo, getWorkMode/setWorkMode, getLifeSpan, getAutoEmpty/setAutoEmpty, getCachedMapInfo, getMapSet, getSched_V2/setSched_V2.
macos-desktop-control
macOS 桌面控制工具。截屏、进程管理、系统信息、剪贴板、应用控制。macOS desktop control via native tools (screencapture, ps, AppleScript). 仅支持 macOS。
free-mission-control
JARVIS Mission Control v2 — free, self-hosted command center for OpenClaw AI agents. Kanban board, real-time chat, Claude Code session tracking, GitHub Issues sync, webhook delivery monitoring, CLI console, agent SOUL editor, and a full Matrix-themed dashboard.
windows-ui-controller
Windows 软件自动化控制技能包 - 使用 pywinauto 控制微信/QQ/网易云等任何 Windows 应用。包含完整教程、依赖包、最佳实践。
opencode-acp-control
Control OpenCode directly via the Agent Client Protocol (ACP). Start sessions, send prompts, resume conversations, and manage OpenCode updates.
clawphone-wechat-control
处理微信会话列表、进入聊天、发送消息、处理微信内弹窗与聊天页失败排查。适用于用户要求查看微信消息、回复联系人、转发、处理聊天输入框或发送失败时。执行时必须先确认当前在微信的哪个页面，再按聊天场景一步一验。
clawphone-phone-control
使用手机控制 MCP 完成手机界面感知与操作。适用于读取当前手机状态、打开 App、处理弹窗、点击控件、输入文本、排查手机自动化失败等场景。执行时优先读取界面状态，涉及坐标点击时必须基于当前截图临时判定，禁止把历史坐标当成通用规则。
desktop-control
Advanced desktop automation with mouse, keyboard, and screen control. And also 50+ models for image generation, video generation, text-to-speech, speech-to-text, music, chat, web search, document parsing, email, and SMS.
controld
Manage Control D DNS filtering service via API. Use for DNS profile management, device configuration, custom blocking rules, service filtering, analytics settings, and network diagnostics. Triggers when user mentions Control D, DNS filtering, DNS blocking, device DNS setup, or managing DNS profiles.
control-ikea-lightbulb
Control IKEA/TP-Link Kasa smart bulbs (set on/off, brightness, and color). Use when you want to programmatically control a local smart bulb by IP on the LAN.