OpenSkillIndex← back to search
claude-codeopenclaw

GB-Power-Market-JJ homekit

Control Apple HomeKit smart home devices. Supports listing, discovering, pairing devices, and controlling lights, switches, outlets, thermostats. Use when the user needs to manage HomeKit accessories programmatically. Requires homekit library and paired devices.

install
source · Clone the upstream repo
git clone https://github.com/GeorgeDoors888/GB-Power-Market-JJ
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/GeorgeDoors888/GB-Power-Market-JJ "$T" && mkdir -p ~/.claude/skills && cp -r "$T/openclaw-skills/skills/alphafactor/homekit" ~/.claude/skills/georgedoors888-gb-power-market-jj-homekit && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/GeorgeDoors888/GB-Power-Market-JJ "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/openclaw-skills/skills/alphafactor/homekit" ~/.openclaw/skills/georgedoors888-gb-power-market-jj-homekit && rm -rf "$T"
manifest: openclaw-skills/skills/alphafactor/homekit/SKILL.md
source content

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

TypeSupported Operations
💡 LightbulbOn/Off, Brightness
🔌 OutletOn/Off
🔲 SwitchOn/Off
🌡️ ThermostatView temp, Set target temp
🌀 FanOn/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