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 requested actions align with a HomeKit controller: it discovers, pairs, and controls local HomeKit accessories and stores pairing info locally; nothing in the provided files indicates hidden exfiltration or unrelated credential access, but the script was truncated in the listing so full review is recommended.

Purpose & Capability

Name and description match the included Python script and README: the skill uses the homekit / HAP-python libraries to discover, pair, list, and control HomeKit accessories on the local network. There are no unrelated credentials, binaries, or cloud services requested.

Instruction Scope

SKILL.md and scripts instruct only local network operations (mDNS/Bonjour discovery, pairing, characteristic writes) and recommend installing HAP-python/homekit. The script reads an optional env var HOMEKIT_DEFAULT_HOME and writes pairings to ~/.config/homekit/pairings.json — both are within scope but the env var is not declared in requires.env. The SKILL.md contains example scene scripts that reference an agent workspace path (~/.openclaw) which is a usability detail but not a secret-exfiltration vector by itself.

Install Mechanism

No install spec is embedded; SKILL.md recommends installing HAP-python and homekit via pip from PyPI (pip3 install HAP-python homekit). This is a standard mechanism for Python libraries and proportionate to the skill's function. No downloads from unknown URLs or archive extraction are present.

Credentials

The skill declares no required environment variables or secrets, which matches expected usage. The code does read HOMEKIT_DEFAULT_HOME from the environment (optional) but that variable is not documented in SKILL.md. The script stores pairing data (sensitive control credentials for HomeKit devices) in ~/.config/homekit/pairings.json — storing these secrets locally is expected for a HomeKit controller but is a sensitive action users should be aware of.

Persistence & Privilege

always:false and the skill is user-invocable and allowed to run autonomously (default). The script persistently writes pairing state to the user's config directory (~/.config/homekit), which is necessary for functionality but means the skill will keep sensitive device credentials on disk. The skill does not request system-wide or other-skills configuration changes in the provided files.

Assessment

This skill appears to do what it says: discover, pair, and control HomeKit devices on your local network. Before installing, consider: 1) Review the entire scripts/homekit.py file (the provided listing was truncated) to confirm there's no unexpected network calls or telemetry. 2) Install dependencies from trusted sources (pip from PyPI) and consider using a virtualenv. 3) Be aware pairing data (control credentials) will be saved to ~/.config/homekit/pairings.json — treat this file as sensitive and restrict its permissions. 4) If you prefer extra isolation, run the tool on a dedicated machine or VM on the same LAN. 5) If you rely on agents/autonomous invocation, note the skill can be invoked automatically by the agent (default); only enable that if you trust the skill and its source.

HomeKit Smart Home Controller

Control Apple HomeKit smart home devices using Python scripts.

Features

• 🔍 Discover unpaired devices
• 🔗 Pair/Unpair devices
• 📱 List all paired devices
• 💡 Control light switches and brightness
• 🔌 Control outlets and switches
• 🌡️ View device status

Prerequisites

1. Install Dependencies

pip3 install HAP-python homekit --user

2. Pair Devices

Pair your devices before first use:

# Discover devices
python3 scripts/homekit.py discover

# Pair a device
python3 scripts/homekit.py pair "Device Name" "XXX-XX-XXX" "alias"

The pairing code is usually found in the device manual or on the device itself (format: XXX-XX-XXX).

Usage

List All Devices

python3 scripts/homekit.py list

Example output:

📱 Found 3 devices:

Alias           Name                      Type            Status
----------------------------------------------------------------------
💡 living-light  Living Room Light         Lightbulb       on (80%)
🔌 desk-outlet   Desk Outlet               Outlet          off
💡 bedroom-lamp  Bedside Lamp              Lightbulb       off

Control Devices

Turn on:

python3 scripts/homekit.py on living-light

Turn off:

python3 scripts/homekit.py off living-light

Set brightness (0-100):

python3 scripts/homekit.py brightness living-light 50

View Device Status

python3 scripts/homekit.py status living-light

Device Management

Discover new devices:

python3 scripts/homekit.py discover --timeout 10

Unpair a device:

python3 scripts/homekit.py unpair living-light

Supported Device Types

Type	Supported Operations
💡 Lightbulb	On/Off, Brightness
🔌 Outlet	On/Off
🔲 Switch	On/Off
🌡️ Thermostat	View temp, Set target temp
🌀 Fan	On/Off, Speed

Troubleshooting

Error: homekit library not installed → Run: pip3 install HAP-python homekit --user

Error: Device not found → Ensure the device and computer are on the same WiFi network.

Error: Pairing failed → Check if the pairing code is correct and the device is in pairing mode.

Device shows offline → Try re-pairing or check device power.

Advanced Usage

Batch Control

# Turn off all lights
for device in living-light bedroom-lamp kitchen-light; do
    python3 scripts/homekit.py off $device
done

Scene Script Example

Create ~/scripts/goodnight.sh:

#!/bin/bash
# Goodnight Scene: Turn off all lights except a dim bedside lamp

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 "Goodnight 😴"

References

• HomeKit Official Docs: https://developer.apple.com/homekit/
• Library Docs: https://github.com/jlusiardi/homekit_python