HomeKit Smart Home Control

Control Apple HomeKit smart home devices. Supports listing, discovering, pairing devices, and controlling lights, switches, outlets, thermostats. Use when th...

Security Scan

The skill's code, instructions, and requirements are consistent with a HomeKit controller: it operates on the local network, uses the homekit Python libraries, and stores pairings locally — no unrelated credentials or external endpoints are requested.

Purpose & Capability

Name and description match the included scripts and docs. The script uses the homekit/HAP-Python libraries to discover, pair, list, and control HomeKit accessories — these capabilities are appropriate for a HomeKit control skill.

Instruction Scope

SKILL.md and the Python script stick to HomeKit operations (discover, pair, control, save pairings). Instructions require installing HAP-python/homekit and using the provided script; they do not direct the agent to read unrelated files, exfiltrate data to external endpoints, or access unrelated system state.

Install Mechanism

No automated install spec is provided; the README instructs the user to pip-install well-known Python packages. There are no downloads from unknown URLs or archive extraction steps in the skill bundle.

Credentials

The skill requests no environment variables or external credentials. The script reads a single optional env var HOMEKIT_DEFAULT_HOME (harmless) and stores pairing data under ~/.config/homekit — this is proportional to its purpose.

Persistence & Privilege

The skill saves pairing state to ~/.config/homekit/pairings.json (expected). It does not request always:true or modify other skills or global agent settings. Users should be aware that saved pairings grant control over paired devices from the host.

Assessment

This skill appears to do what it says: control HomeKit devices on your local network. Before installing, verify you trust the skill source (the package includes a Python script you will run). Note it will ask you to pip-install HAP-python/homekit and will save pairing credentials at ~/.config/homekit/pairings.json — protect that file because anyone with it and network access may control your accessories. Only pair devices you own and keep pairing codes private. If you plan to run the included script, inspect its full source and run pip installs in a controlled environment (virtualenv) if you prefer. Autonomous invocation is allowed by default but the skill is not configured as always-on.

HomeKit 智能家居控制器

通过 Python 脚本控制苹果 HomeKit 智能家居设备。

功能特性

• 🔍 发现未配对设备
• 🔗 配对/取消配对设备
• 📱 列出所有已配对设备
• 💡 控制灯光开关和亮度
• 🔌 控制插座和开关
• 🌡️ 查看设备状态

前提条件

1. 安装依赖

pip3 install HAP-python homekit --user

2. 配对设备

首次使用前需要配对设备：

# 发现设备
python3 scripts/homekit.py discover

# 配对设备
python3 scripts/homekit.py pair "设备名称" "XXX-XX-XXX" "别名"

配对码通常在设备说明书或设备本体上（格式：XXX-XX-XXX）。

使用方法

列出所有设备

python3 scripts/homekit.py list

输出示例：

📱 找到 3 个设备:

Alias           Name                      Type            Status
----------------------------------------------------------------------
💡 living-light  客厅主灯                  Lightbulb       on (80%)
🔌 desk-outlet   桌面插座                  Outlet          off
💡 bedroom-lamp  床头灯                    Lightbulb       off

控制设备

打开设备：

python3 scripts/homekit.py on living-light

关闭设备：

python3 scripts/homekit.py off living-light

调节亮度（0-100）：

python3 scripts/homekit.py brightness living-light 50

查看设备状态

python3 scripts/homekit.py status living-light

设备管理

发现新设备：

python3 scripts/homekit.py discover --timeout 10

取消配对：

python3 scripts/homekit.py unpair living-light

支持的设备类型

类型	支持操作
💡 Lightbulb	开关、亮度调节
🔌 Outlet	开关
🔲 Switch	开关
🌡️ Thermostat	查看温度、设置目标温度
🌀 Fan	开关、风速调节

常见问题

错误：homekit 库未安装 → 运行: pip3 install HAP-python homekit --user

错误：未找到设备 → 确保设备和电脑在同一 WiFi 网络

错误：配对失败 → 检查配对码是否正确，设备是否处于配对模式

设备显示离线 → 尝试重新配对或检查设备电源

高级用法

批量控制

# 关闭所有灯
for device in living-light bedroom-lamp kitchen-light; do
    python3 scripts/homekit.py off $device
done

场景脚本示例

创建 ~/scripts/goodnight.sh：

#!/bin/bash
# 晚安场景：关闭所有灯，保留床头灯微光

python3 ~/.openclaw/workspace/homekit/scripts/homekit.py off living-light
python3 ~/.openclaw/workspace/homekit/scripts/homekit.py off kitchen-light
python3 ~/.openclaw/workspace/homekit/scripts/homekit.py brightness bedroom-lamp 10

echo "晚安 😴"

参考

• HomeKit 官方文档: https://developer.apple.com/homekit/
• 库文档: https://github.com/jlusiardi/homekit_python