# Send Homebridge to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "clawdbot-skill-homebridge",
    "name": "Homebridge",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/JiasenL/clawdbot-skill-homebridge",
    "canonicalUrl": "https://clawhub.ai/JiasenL/clawdbot-skill-homebridge",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/clawdbot-skill-homebridge",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawdbot-skill-homebridge",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/homebridge_api.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/clawdbot-skill-homebridge"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/clawdbot-skill-homebridge",
    "downloadUrl": "https://openagent3.xyz/downloads/clawdbot-skill-homebridge",
    "agentUrl": "https://openagent3.xyz/skills/clawdbot-skill-homebridge/agent",
    "manifestUrl": "https://openagent3.xyz/skills/clawdbot-skill-homebridge/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/clawdbot-skill-homebridge/agent.md"
  }
}
```
## Documentation

### Homebridge Control

Control smart home devices through Homebridge Config UI X's REST API.

### Prerequisites

Homebridge with Config UI X installed and running
Credentials file at ~/.clawdbot/credentials/homebridge.json:
{
  "url": "https://homebridge.local:8581",
  "username": "admin",
  "password": "your-password"
}

### API Overview

Homebridge Config UI X exposes a REST API. View full documentation at {HOMEBRIDGE_URL}/swagger.

### Authentication

All API calls require a Bearer token. Obtain it first:

# Get auth token
TOKEN=$(curl -s -X POST "${HOMEBRIDGE_URL}/api/auth/login" \\
  -H "Content-Type: application/json" \\
  -d "{\\"username\\":\\"${HOMEBRIDGE_USERNAME}\\",\\"password\\":\\"${HOMEBRIDGE_PASSWORD}\\"}" \\
  | jq -r '.access_token')

### List All Accessories

curl -s "${HOMEBRIDGE_URL}/api/accessories" \\
  -H "Authorization: Bearer ${TOKEN}" | jq

Response includes accessory uniqueId, serviceName, type, and current values.

### Get Accessory Layout (Rooms)

curl -s "${HOMEBRIDGE_URL}/api/accessories/layout" \\
  -H "Authorization: Bearer ${TOKEN}" | jq

### Control an Accessory

Use PUT to update accessory characteristics:

# Turn on a light/switch
curl -s -X PUT "${HOMEBRIDGE_URL}/api/accessories/{uniqueId}" \\
  -H "Authorization: Bearer ${TOKEN}" \\
  -H "Content-Type: application/json" \\
  -d '{"characteristicType": "On", "value": true}'

# Turn off
curl -s -X PUT "${HOMEBRIDGE_URL}/api/accessories/{uniqueId}" \\
  -H "Authorization: Bearer ${TOKEN}" \\
  -H "Content-Type: application/json" \\
  -d '{"characteristicType": "On", "value": false}'

# Set brightness (0-100)
curl -s -X PUT "${HOMEBRIDGE_URL}/api/accessories/{uniqueId}" \\
  -H "Authorization: Bearer ${TOKEN}" \\
  -H "Content-Type: application/json" \\
  -d '{"characteristicType": "Brightness", "value": 50}'

# Set color (Hue: 0-360, Saturation: 0-100)
curl -s -X PUT "${HOMEBRIDGE_URL}/api/accessories/{uniqueId}" \\
  -H "Authorization: Bearer ${TOKEN}" \\
  -H "Content-Type: application/json" \\
  -d '{"characteristicType": "Hue", "value": 240}'

# Set thermostat target temperature
curl -s -X PUT "${HOMEBRIDGE_URL}/api/accessories/{uniqueId}" \\
  -H "Authorization: Bearer ${TOKEN}" \\
  -H "Content-Type: application/json" \\
  -d '{"characteristicType": "TargetTemperature", "value": 22}'

### Common Characteristic Types

TypeValuesDescriptionOntrue/falsePower stateBrightness0-100Light brightness %Hue0-360Color hue in degreesSaturation0-100Color saturation %ColorTemperature140-500Color temp in MiredTargetTemperature10-38Thermostat target °CTargetHeatingCoolingState0-30=Off, 1=Heat, 2=Cool, 3=AutoRotationSpeed0-100Fan speed %Active0/1Active state (fans, etc.)

### Using the Scripts

For convenience, use the provided scripts:

### List Accessories

scripts/homebridge_api.py list
scripts/homebridge_api.py list --room "Living Room"
scripts/homebridge_api.py list --type Lightbulb

### Control Devices

# Turn on/off
scripts/homebridge_api.py set <uniqueId> On true
scripts/homebridge_api.py set <uniqueId> On false

# Adjust brightness
scripts/homebridge_api.py set <uniqueId> Brightness 75

# Set color
scripts/homebridge_api.py set <uniqueId> Hue 120
scripts/homebridge_api.py set <uniqueId> Saturation 100

### Get Accessory Status

scripts/homebridge_api.py get <uniqueId>

### Tips

Find your accessory's uniqueId by listing all accessories first
The API documentation at /swagger shows all available endpoints
Characteristic names are case-sensitive (use On not on)
Some accessories may have multiple services; check the response for service types
Token expires after some time; re-authenticate if you get 401 errors
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: JiasenL
- Version: 0.1.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/clawdbot-skill-homebridge)
- [Send to Agent page](https://openagent3.xyz/skills/clawdbot-skill-homebridge/agent)
- [JSON manifest](https://openagent3.xyz/skills/clawdbot-skill-homebridge/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/clawdbot-skill-homebridge/agent.md)
- [Download page](https://openagent3.xyz/downloads/clawdbot-skill-homebridge)