{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/clawdbot-skill-homebridge",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawdbot-skill-homebridge",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "scripts/homebridge_api.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/clawdbot-skill-homebridge",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Homebridge Control",
        "body": "Control smart home devices through Homebridge Config UI X's REST API."
      },
      {
        "title": "Prerequisites",
        "body": "Homebridge with Config UI X installed and running\nCredentials file at ~/.clawdbot/credentials/homebridge.json:\n{\n  \"url\": \"https://homebridge.local:8581\",\n  \"username\": \"admin\",\n  \"password\": \"your-password\"\n}"
      },
      {
        "title": "API Overview",
        "body": "Homebridge Config UI X exposes a REST API. View full documentation at {HOMEBRIDGE_URL}/swagger."
      },
      {
        "title": "Authentication",
        "body": "All API calls require a Bearer token. Obtain it first:\n\n# Get auth token\nTOKEN=$(curl -s -X POST \"${HOMEBRIDGE_URL}/api/auth/login\" \\\n  -H \"Content-Type: application/json\" \\\n  -d \"{\\\"username\\\":\\\"${HOMEBRIDGE_USERNAME}\\\",\\\"password\\\":\\\"${HOMEBRIDGE_PASSWORD}\\\"}\" \\\n  | jq -r '.access_token')"
      },
      {
        "title": "List All Accessories",
        "body": "curl -s \"${HOMEBRIDGE_URL}/api/accessories\" \\\n  -H \"Authorization: Bearer ${TOKEN}\" | jq\n\nResponse includes accessory uniqueId, serviceName, type, and current values."
      },
      {
        "title": "Get Accessory Layout (Rooms)",
        "body": "curl -s \"${HOMEBRIDGE_URL}/api/accessories/layout\" \\\n  -H \"Authorization: Bearer ${TOKEN}\" | jq"
      },
      {
        "title": "Control an Accessory",
        "body": "Use PUT to update accessory characteristics:\n\n# Turn on a light/switch\ncurl -s -X PUT \"${HOMEBRIDGE_URL}/api/accessories/{uniqueId}\" \\\n  -H \"Authorization: Bearer ${TOKEN}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"characteristicType\": \"On\", \"value\": true}'\n\n# Turn off\ncurl -s -X PUT \"${HOMEBRIDGE_URL}/api/accessories/{uniqueId}\" \\\n  -H \"Authorization: Bearer ${TOKEN}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"characteristicType\": \"On\", \"value\": false}'\n\n# Set brightness (0-100)\ncurl -s -X PUT \"${HOMEBRIDGE_URL}/api/accessories/{uniqueId}\" \\\n  -H \"Authorization: Bearer ${TOKEN}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"characteristicType\": \"Brightness\", \"value\": 50}'\n\n# Set color (Hue: 0-360, Saturation: 0-100)\ncurl -s -X PUT \"${HOMEBRIDGE_URL}/api/accessories/{uniqueId}\" \\\n  -H \"Authorization: Bearer ${TOKEN}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"characteristicType\": \"Hue\", \"value\": 240}'\n\n# Set thermostat target temperature\ncurl -s -X PUT \"${HOMEBRIDGE_URL}/api/accessories/{uniqueId}\" \\\n  -H \"Authorization: Bearer ${TOKEN}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"characteristicType\": \"TargetTemperature\", \"value\": 22}'"
      },
      {
        "title": "Common Characteristic Types",
        "body": "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.)"
      },
      {
        "title": "Using the Scripts",
        "body": "For convenience, use the provided scripts:"
      },
      {
        "title": "List Accessories",
        "body": "scripts/homebridge_api.py list\nscripts/homebridge_api.py list --room \"Living Room\"\nscripts/homebridge_api.py list --type Lightbulb"
      },
      {
        "title": "Control Devices",
        "body": "# Turn on/off\nscripts/homebridge_api.py set <uniqueId> On true\nscripts/homebridge_api.py set <uniqueId> On false\n\n# Adjust brightness\nscripts/homebridge_api.py set <uniqueId> Brightness 75\n\n# Set color\nscripts/homebridge_api.py set <uniqueId> Hue 120\nscripts/homebridge_api.py set <uniqueId> Saturation 100"
      },
      {
        "title": "Get Accessory Status",
        "body": "scripts/homebridge_api.py get <uniqueId>"
      },
      {
        "title": "Tips",
        "body": "Find your accessory's uniqueId by listing all accessories first\nThe API documentation at /swagger shows all available endpoints\nCharacteristic names are case-sensitive (use On not on)\nSome accessories may have multiple services; check the response for service types\nToken expires after some time; re-authenticate if you get 401 errors"
      }
    ],
    "body": "Homebridge Control\n\nControl smart home devices through Homebridge Config UI X's REST API.\n\nPrerequisites\nHomebridge with Config UI X installed and running\nCredentials file at ~/.clawdbot/credentials/homebridge.json:\n{\n  \"url\": \"https://homebridge.local:8581\",\n  \"username\": \"admin\",\n  \"password\": \"your-password\"\n}\n\nAPI Overview\n\nHomebridge Config UI X exposes a REST API. View full documentation at {HOMEBRIDGE_URL}/swagger.\n\nAuthentication\n\nAll API calls require a Bearer token. Obtain it first:\n\n# Get auth token\nTOKEN=$(curl -s -X POST \"${HOMEBRIDGE_URL}/api/auth/login\" \\\n  -H \"Content-Type: application/json\" \\\n  -d \"{\\\"username\\\":\\\"${HOMEBRIDGE_USERNAME}\\\",\\\"password\\\":\\\"${HOMEBRIDGE_PASSWORD}\\\"}\" \\\n  | jq -r '.access_token')\n\nCommon Operations\nList All Accessories\ncurl -s \"${HOMEBRIDGE_URL}/api/accessories\" \\\n  -H \"Authorization: Bearer ${TOKEN}\" | jq\n\n\nResponse includes accessory uniqueId, serviceName, type, and current values.\n\nGet Accessory Layout (Rooms)\ncurl -s \"${HOMEBRIDGE_URL}/api/accessories/layout\" \\\n  -H \"Authorization: Bearer ${TOKEN}\" | jq\n\nControl an Accessory\n\nUse PUT to update accessory characteristics:\n\n# Turn on a light/switch\ncurl -s -X PUT \"${HOMEBRIDGE_URL}/api/accessories/{uniqueId}\" \\\n  -H \"Authorization: Bearer ${TOKEN}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"characteristicType\": \"On\", \"value\": true}'\n\n# Turn off\ncurl -s -X PUT \"${HOMEBRIDGE_URL}/api/accessories/{uniqueId}\" \\\n  -H \"Authorization: Bearer ${TOKEN}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"characteristicType\": \"On\", \"value\": false}'\n\n# Set brightness (0-100)\ncurl -s -X PUT \"${HOMEBRIDGE_URL}/api/accessories/{uniqueId}\" \\\n  -H \"Authorization: Bearer ${TOKEN}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"characteristicType\": \"Brightness\", \"value\": 50}'\n\n# Set color (Hue: 0-360, Saturation: 0-100)\ncurl -s -X PUT \"${HOMEBRIDGE_URL}/api/accessories/{uniqueId}\" \\\n  -H \"Authorization: Bearer ${TOKEN}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"characteristicType\": \"Hue\", \"value\": 240}'\n\n# Set thermostat target temperature\ncurl -s -X PUT \"${HOMEBRIDGE_URL}/api/accessories/{uniqueId}\" \\\n  -H \"Authorization: Bearer ${TOKEN}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"characteristicType\": \"TargetTemperature\", \"value\": 22}'\n\nCommon Characteristic Types\nType\tValues\tDescription\nOn\ttrue/false\tPower state\nBrightness\t0-100\tLight brightness %\nHue\t0-360\tColor hue in degrees\nSaturation\t0-100\tColor saturation %\nColorTemperature\t140-500\tColor temp in Mired\nTargetTemperature\t10-38\tThermostat target °C\nTargetHeatingCoolingState\t0-3\t0=Off, 1=Heat, 2=Cool, 3=Auto\nRotationSpeed\t0-100\tFan speed %\nActive\t0/1\tActive state (fans, etc.)\nUsing the Scripts\n\nFor convenience, use the provided scripts:\n\nList Accessories\nscripts/homebridge_api.py list\nscripts/homebridge_api.py list --room \"Living Room\"\nscripts/homebridge_api.py list --type Lightbulb\n\nControl Devices\n# Turn on/off\nscripts/homebridge_api.py set <uniqueId> On true\nscripts/homebridge_api.py set <uniqueId> On false\n\n# Adjust brightness\nscripts/homebridge_api.py set <uniqueId> Brightness 75\n\n# Set color\nscripts/homebridge_api.py set <uniqueId> Hue 120\nscripts/homebridge_api.py set <uniqueId> Saturation 100\n\nGet Accessory Status\nscripts/homebridge_api.py get <uniqueId>\n\nTips\nFind your accessory's uniqueId by listing all accessories first\nThe API documentation at /swagger shows all available endpoints\nCharacteristic names are case-sensitive (use On not on)\nSome accessories may have multiple services; check the response for service types\nToken expires after some time; re-authenticate if you get 401 errors"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/JiasenL/clawdbot-skill-homebridge",
    "publisherUrl": "https://clawhub.ai/JiasenL/clawdbot-skill-homebridge",
    "owner": "JiasenL",
    "version": "0.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}