{ "schemaVersion": "1.0", "item": { "slug": "homey", "name": "Homey", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/maxsumrall/homey", "canonicalUrl": "https://clawhub.ai/maxsumrall/homey", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/homey", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=homey", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "CHANGELOG.md", "EXAMPLES.md", "INSTALL.sh", "README.md", "SKILL.md", "TESTING.md" ], "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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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/homey" }, "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/homey", "agentPageUrl": "https://openagent3.xyz/skills/homey/agent", "manifestUrl": "https://openagent3.xyz/skills/homey/agent.json", "briefUrl": "https://openagent3.xyz/skills/homey/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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "Homey Smart Home Control", "body": "Control Athom Homey devices via local (LAN/VPN) or cloud APIs using token authentication." }, { "title": "Setup", "body": "Requires Node.js >= 18.\n\nDecide local vs cloud\n\nLocal (LAN/VPN): use a local API key from the Homey Web App + Homey IP address\nCloud (remote/headless): use a cloud token from Developer Tools\n\n\n\nConfigure\nLocal (recommended when the agent runs on your home network):\nhomeycli auth discover-local --save --pick 1\necho \"\" | homeycli auth set-local --stdin\n# or interactive (hidden input): homeycli auth set-local --prompt\n\nCloud (recommended for VPS/headless hosting):\necho \"\" | homeycli auth set-token --stdin\n# or interactive (hidden input): homeycli auth set-token --prompt\n\nCheck status:\nhomeycli auth status\n\n\n\nTest connection\nhomeycli status" }, { "title": "Snapshot (recommended for agents)", "body": "homeycli snapshot --json\nhomeycli snapshot --json --include-flows" }, { "title": "List Devices", "body": "homeycli devices # Pretty table output\nhomeycli devices --json # JSON output for AI parsing (includes latest values)\n\n# Filter by name (returns multiple matches)\nhomeycli devices --match \"kitchen\" --json" }, { "title": "Control Devices", "body": "Turn devices on/off:\n\nhomeycli device \"Living Room Light\" on\nhomeycli device \"Bedroom Lamp\" off\n\nSet specific capabilities:\n\nhomeycli device \"Dimmer\" set dim 0.5 # 50% brightness\nhomeycli device \"Thermostat\" set target_temperature 21 # Set temperature\nhomeycli device \"RGB Light\" set light_hue 0.5 # Hue (0-1)\nhomeycli device \"Lock\" set locked true # Lock device\n\nGet capability values:\n\nhomeycli device \"Thermostat\" get measure_temperature\nhomeycli device \"Motion Sensor\" get alarm_motion\n\n# Get all values for a device (multi-sensors)\nhomeycli device \"Living Room Air\" values\nhomeycli device \"Living Room Air\" get" }, { "title": "Flows (Automations)", "body": "homeycli flows # List all flows\nhomeycli flows --json # JSON output\nhomeycli flows --match \"good\" --json # Filter flows by name\nhomeycli flow trigger \"Good Night\" # Trigger by name\nhomeycli flow trigger # Trigger by ID" }, { "title": "Zones (Rooms)", "body": "homeycli zones # List all zones/rooms\nhomeycli zones --json # JSON output" }, { "title": "Status", "body": "homeycli status # Show Homey connection info" }, { "title": "Common Capabilities", "body": "CapabilityTypeDescriptionExampleonoffbooleanPower on/offtrue, falsedimnumberBrightness (0-1)0.5 (50%)light_huenumberColor hue (0-1)0.33 (green)light_saturationnumberColor saturation (0-1)1.0 (full)light_temperaturenumberColor temp (0-1)0.5 (neutral)target_temperaturenumberThermostat target (°C)21measure_temperaturenumberCurrent temp (read-only)-lockedbooleanLock statetrue, falsealarm_motionbooleanMotion detected (read-only)-alarm_contactbooleanContact sensor (read-only)-volume_setnumberVolume (0-1)0.5\n\nUse homeycli devices to see what capabilities each device supports." }, { "title": "Fuzzy Matching", "body": "Device and flow names support fuzzy matching:\n\nExact match: \"Living Room Light\" → finds \"Living Room Light\"\nSubstring: \"living light\" → finds \"Living Room Light\"\nLevenshtein distance: \"livng light\" → finds \"Living Room Light\" (typo-tolerant)" }, { "title": "JSON Mode", "body": "Add --json to any command for machine-readable output:\n\nhomeycli devices --json | jq '.[] | select(.class == \"light\")'\nhomeycli status --json" }, { "title": "Examples", "body": "Morning routine:\n\nhomeycli device \"Bedroom Light\" on\nhomeycli device \"Bedroom Light\" set dim 0.3\nhomeycli device \"Thermostat\" set target_temperature 20\n\nCheck temperature:\n\nhomeycli device \"Living Room\" get measure_temperature\n\nTrigger scene:\n\nhomeycli flow trigger \"Movie Time\"\n\nList all lights:\n\nhomeycli devices --json | jq '.[] | select(.class == \"light\") | .name'" }, { "title": "Troubleshooting", "body": "\"No auth configured\"\n\nLocal (LAN/VPN):\n\nSave local config: echo \"\" | homeycli auth set-local --address http:// --stdin\n\nCloud (remote/headless):\n\nSave cloud token: echo \"\" | homeycli auth set-token --stdin\nCloud tokens can be created in Homey Developer Tools: https://tools.developer.homey.app/api/clients\n\n\"Device not found\" / ambiguous match\n\nList devices with homeycli devices --json (or homeycli devices --match --json) to find the right id\nIf a query matches more than one device, the CLI returns candidate IDs and asks you to specify the device by ID\n\n\"Capability not supported\"\n\nCheck available capabilities: homeycli devices shows what each device supports\nCommon issue: trying to turn on a sensor (use get instead of set)" }, { "title": "API Reference", "body": "The CLI uses the official homey-api npm package (v3.15.0).\n\nAuth/connection modes:\n\nLocal mode: HomeyAPI.createLocalAPI({ address, token }) using the Homey Web App local API key.\nCloud mode: AthomCloudAPI using a cloud bearer token (PAT) to create a session and access devices/flows/zones." } ], "body": "Homey Smart Home Control\n\nControl Athom Homey devices via local (LAN/VPN) or cloud APIs using token authentication.\n\nSetup\n\nRequires Node.js >= 18.\n\nDecide local vs cloud\n\nLocal (LAN/VPN): use a local API key from the Homey Web App + Homey IP address\nCloud (remote/headless): use a cloud token from Developer Tools\n\nConfigure\n\nLocal (recommended when the agent runs on your home network):\n\nhomeycli auth discover-local --save --pick 1\necho \"\" | homeycli auth set-local --stdin\n# or interactive (hidden input): homeycli auth set-local --prompt\n\n\nCloud (recommended for VPS/headless hosting):\n\necho \"\" | homeycli auth set-token --stdin\n# or interactive (hidden input): homeycli auth set-token --prompt\n\n\nCheck status:\n\nhomeycli auth status\n\n\nTest connection\n\nhomeycli status\n\nCommands\nSnapshot (recommended for agents)\nhomeycli snapshot --json\nhomeycli snapshot --json --include-flows\n\nList Devices\nhomeycli devices # Pretty table output\nhomeycli devices --json # JSON output for AI parsing (includes latest values)\n\n# Filter by name (returns multiple matches)\nhomeycli devices --match \"kitchen\" --json\n\nControl Devices\n\nTurn devices on/off:\n\nhomeycli device \"Living Room Light\" on\nhomeycli device \"Bedroom Lamp\" off\n\n\nSet specific capabilities:\n\nhomeycli device \"Dimmer\" set dim 0.5 # 50% brightness\nhomeycli device \"Thermostat\" set target_temperature 21 # Set temperature\nhomeycli device \"RGB Light\" set light_hue 0.5 # Hue (0-1)\nhomeycli device \"Lock\" set locked true # Lock device\n\n\nGet capability values:\n\nhomeycli device \"Thermostat\" get measure_temperature\nhomeycli device \"Motion Sensor\" get alarm_motion\n\n# Get all values for a device (multi-sensors)\nhomeycli device \"Living Room Air\" values\nhomeycli device \"Living Room Air\" get\n\nFlows (Automations)\nhomeycli flows # List all flows\nhomeycli flows --json # JSON output\nhomeycli flows --match \"good\" --json # Filter flows by name\nhomeycli flow trigger \"Good Night\" # Trigger by name\nhomeycli flow trigger # Trigger by ID\n\nZones (Rooms)\nhomeycli zones # List all zones/rooms\nhomeycli zones --json # JSON output\n\nStatus\nhomeycli status # Show Homey connection info\n\nCommon Capabilities\nCapability\tType\tDescription\tExample\nonoff\tboolean\tPower on/off\ttrue, false\ndim\tnumber\tBrightness (0-1)\t0.5 (50%)\nlight_hue\tnumber\tColor hue (0-1)\t0.33 (green)\nlight_saturation\tnumber\tColor saturation (0-1)\t1.0 (full)\nlight_temperature\tnumber\tColor temp (0-1)\t0.5 (neutral)\ntarget_temperature\tnumber\tThermostat target (°C)\t21\nmeasure_temperature\tnumber\tCurrent temp (read-only)\t-\nlocked\tboolean\tLock state\ttrue, false\nalarm_motion\tboolean\tMotion detected (read-only)\t-\nalarm_contact\tboolean\tContact sensor (read-only)\t-\nvolume_set\tnumber\tVolume (0-1)\t0.5\n\nUse homeycli devices to see what capabilities each device supports.\n\nFuzzy Matching\n\nDevice and flow names support fuzzy matching:\n\nExact match: \"Living Room Light\" → finds \"Living Room Light\"\nSubstring: \"living light\" → finds \"Living Room Light\"\nLevenshtein distance: \"livng light\" → finds \"Living Room Light\" (typo-tolerant)\nJSON Mode\n\nAdd --json to any command for machine-readable output:\n\nhomeycli devices --json | jq '.[] | select(.class == \"light\")'\nhomeycli status --json\n\nExamples\n\nMorning routine:\n\nhomeycli device \"Bedroom Light\" on\nhomeycli device \"Bedroom Light\" set dim 0.3\nhomeycli device \"Thermostat\" set target_temperature 20\n\n\nCheck temperature:\n\nhomeycli device \"Living Room\" get measure_temperature\n\n\nTrigger scene:\n\nhomeycli flow trigger \"Movie Time\"\n\n\nList all lights:\n\nhomeycli devices --json | jq '.[] | select(.class == \"light\") | .name'\n\nTroubleshooting\n\n\"No auth configured\"\n\nLocal (LAN/VPN):\n\nSave local config: echo \"\" | homeycli auth set-local --address http:// --stdin\n\nCloud (remote/headless):\n\nSave cloud token: echo \"\" | homeycli auth set-token --stdin\nCloud tokens can be created in Homey Developer Tools: https://tools.developer.homey.app/api/clients\n\n\"Device not found\" / ambiguous match\n\nList devices with homeycli devices --json (or homeycli devices --match --json) to find the right id\nIf a query matches more than one device, the CLI returns candidate IDs and asks you to specify the device by ID\n\n\"Capability not supported\"\n\nCheck available capabilities: homeycli devices shows what each device supports\nCommon issue: trying to turn on a sensor (use get instead of set)\nAPI Reference\n\nThe CLI uses the official homey-api npm package (v3.15.0).\n\nAuth/connection modes:\n\nLocal mode: HomeyAPI.createLocalAPI({ address, token }) using the Homey Web App local API key.\nCloud mode: AthomCloudAPI using a cloud bearer token (PAT) to create a session and access devices/flows/zones." }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/maxsumrall/homey", "publisherUrl": "https://clawhub.ai/maxsumrall/homey", "owner": "maxsumrall", "version": "1.1.2", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/homey", "downloadUrl": "https://openagent3.xyz/downloads/homey", "agentUrl": "https://openagent3.xyz/skills/homey/agent", "manifestUrl": "https://openagent3.xyz/skills/homey/agent.json", "briefUrl": "https://openagent3.xyz/skills/homey/agent.md" } }