Alexa:智能家居控制与技能开发 - Openclaw Skills

作者:互联网

2026-03-29

AI教程

什么是 Alexa 技能管理器?

Alexa 技能使用户和开发者能够通过包括 Matter、Zigbee 和 Wi-Fi 在内的结构化协议层级来指挥庞大的物联网 (IoT) 设备生态系统。通过使用 Openclaw Skills,您可以实现精确的基于房间的命令,管理复杂的设备组,并确保家庭自动化的可靠性。

除了基础控制,此技能还为创建自定义语音优先体验提供了技术基础。它弥合了 AI 智能体与物理硬件之间的鸿沟,为意图开发、认证要求和高级隐私管理提供了系统化方法。

下载入口:https://github.com/openclaw/skills/tree/main/skills/ivangdavila/alexa

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install alexa

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 alexa。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

Alexa 技能管理器 应用场景

  • 使用基于位置的分组来编排智能家居设备,以实现可靠的房间控制。
  • 创建由语音、日程或设备状态变化触发的多阶段自动化例程。
  • 开发具有合规意图结构和示例语句的自定义 Alexa 技能。
  • 通过守卫 (Guard) 模式管理家庭安全,并审核语音历史记录以确保隐私合规。
Alexa 技能管理器 工作原理
  1. 使用“位置 + 类型”命名规范组织设备,以确保高发现准确性。
  2. 通过协议层级建立连接,优先考虑 Matter 和 Zigbee 以保证稳定性。
  3. 在 Alexa 应用中配置触发器,范围从地理围栏到特定语音短语。
  4. 将设备状态、通知或顺序等待等操作映射到定义的触发器。
  5. 通过例程历史记录监控执行情况,并使用 CloudWatch 日志排除基于 Lambda 的技能问题。

Alexa 技能管理器 配置指南

要将此技能集成到您的环境中,请按照以下步骤操作:

  1. 在 Alexa 应用中启用相关的制造商技能并关联您的账户。
  2. 执行设备发现:
# 通过语音或应用触发设备发现
alexa discover devices
  1. 将设备分配到特定房间以启用房间感知命令。
  2. 对于开发者,初始化用于 Lambda 部署的本地环境:
# 检查日志以解决技能超时问题
aws logs get-log-events --log-group-name /aws/lambda/your-skill-function

Alexa 技能管理器 数据架构与分类体系

该技能根据设备层级和交互历史组织数据:

组件 数据类型 描述
设备注册表 实体映射 将设备名称链接到位置和协议类型
意图模式 JSON 定义所需的意图,如 AMAZON.HelpIntent 和 StopIntent
例程逻辑 工作流 存储触发器-动作序列和例程历史记录
隐私日志 时序数据 记录具有自动删除配置的语音交互
name: Alexa
description: Control devices, run automations, and help users get more from Alexa with smart home, routines, and skill development guidance.

Device Control

Naming for reliable control: Location + device type. "Kitchen light", "Bedroom fan". Avoid model numbers.

Room-based commands:

  • "Turn off the bedroom" (all devices in room)
  • "Turn on downstairs lights" (group)
  • "Set living room to 72" (thermostat)

Protocol hierarchy: Matter > Zigbee > Wi-Fi. Built-in Zigbee hubs: Echo Plus, Echo 4th gen, Echo Show 10.

Device not responding? Check Alexa app → Devices → find device → verify online status. Re-discover if needed.

Routines

Create via: Alexa app → More → Routines

Triggers:

  • Voice phrase (unique, not similar to built-in commands)
  • Schedule (time, sunrise/sunset)
  • Device state (door unlocks, motion detected)
  • Location (geofence enter/exit)
  • Alarm dismissed

Actions: Device control, scenes, announcements, music, wait (sequencing), custom speech.

Routine fails? Check trigger phrase uniqueness, verify all devices online, review routine history in app.

Shortcuts Integration

Quick voice shortcuts: Alexa app → More → Voice → Custom → create phrase that triggers existing command.

Skills as automations: Enable third-party skills that expose actions to routines (IFTTT, smart home brands).

Announcements: "Alexa, announce dinner is ready" → broadcasts to all Echo devices. Useful in routines.

Smart Home Setup

Adding devices:

  1. Enable brand's skill in Alexa app
  2. Link account if required
  3. "Alexa, discover devices" or Devices → + → Add Device
  4. Assign to room (critical for room-based commands)

Groups vs Scenes:

  • Groups: multiple devices, same action ("turn off downstairs")
  • Scenes: multiple devices, preset states ("movie time" → dim lights, close blinds)

Multi-room audio: Create speaker groups, then "Play music on [group name]" or "Play everywhere".

Skill Development

When building custom skills:

  • Required intents: AMAZON.HelpIntent, AMAZON.StopIntent, AMAZON.CancelIntent, AMAZON.FallbackIntent
  • Test in simulator AND on physical device (simulator misses edge cases)
  • 10-20 sample utterances per intent minimum
  • Voice-first: users don't see a screen

Certification blockers: Example phrases that don't work exactly as written, generic help intent, missing privacy policy.

Troubleshooting

Problem Fix
"Device not responding" Check Wi-Fi, verify in Alexa app, re-discover
Routine doesn't trigger Rename trigger phrase, check routine history
Wrong device activates Rename devices to be more distinct
Skill timeout Check Lambda CloudWatch logs, increase timeout
"I don't know that" Add more sample utterances to intent

Privacy Controls

Voice history: Alexa app → Privacy → Review Voice History. Enable auto-delete (3 or 18 months).

Quick delete: "Alexa, delete what I just said" or "delete everything I said today".

Guard mode: "Alexa, I'm leaving" → monitors for sounds (glass break, smoke alarm).


When to Load More

Situation Reference
Full command list by category commands.md
Smart home protocols, setup, troubleshooting smart-home.md
Building custom skills, Lambda, certification development.md