# Send Homey 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. 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. ``` ### 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "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": { "downloadUrl": "/downloads/homey", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=homey", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "CHANGELOG.md", "EXAMPLES.md", "INSTALL.sh", "README.md", "SKILL.md", "TESTING.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "homey", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-04T04:17:26.781Z", "expiresAt": "2026-05-11T04:17:26.781Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=homey", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=homey", "contentDisposition": "attachment; filename=\"homey-1.1.2.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "homey" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "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." ] } }, "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" } } ``` ## Documentation ### Homey Smart Home Control Control Athom Homey devices via local (LAN/VPN) or cloud APIs using token authentication. ### Setup Requires Node.js >= 18. Decide local vs cloud Local (LAN/VPN): use a local API key from the Homey Web App + Homey IP address Cloud (remote/headless): use a cloud token from Developer Tools Configure Local (recommended when the agent runs on your home network): homeycli auth discover-local --save --pick 1 echo "" | homeycli auth set-local --stdin # or interactive (hidden input): homeycli auth set-local --prompt Cloud (recommended for VPS/headless hosting): echo "" | homeycli auth set-token --stdin # or interactive (hidden input): homeycli auth set-token --prompt Check status: homeycli auth status Test connection homeycli status ### Snapshot (recommended for agents) homeycli snapshot --json homeycli snapshot --json --include-flows ### List Devices homeycli devices # Pretty table output homeycli devices --json # JSON output for AI parsing (includes latest values) # Filter by name (returns multiple matches) homeycli devices --match "kitchen" --json ### Control Devices Turn devices on/off: homeycli device "Living Room Light" on homeycli device "Bedroom Lamp" off Set specific capabilities: homeycli device "Dimmer" set dim 0.5 # 50% brightness homeycli device "Thermostat" set target_temperature 21 # Set temperature homeycli device "RGB Light" set light_hue 0.5 # Hue (0-1) homeycli device "Lock" set locked true # Lock device Get capability values: homeycli device "Thermostat" get measure_temperature homeycli device "Motion Sensor" get alarm_motion # Get all values for a device (multi-sensors) homeycli device "Living Room Air" values homeycli device "Living Room Air" get ### Flows (Automations) homeycli flows # List all flows homeycli flows --json # JSON output homeycli flows --match "good" --json # Filter flows by name homeycli flow trigger "Good Night" # Trigger by name homeycli flow trigger # Trigger by ID ### Zones (Rooms) homeycli zones # List all zones/rooms homeycli zones --json # JSON output ### Status homeycli status # Show Homey connection info ### Common Capabilities 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 Use homeycli devices to see what capabilities each device supports. ### Fuzzy Matching Device and flow names support fuzzy matching: Exact match: "Living Room Light" → finds "Living Room Light" Substring: "living light" → finds "Living Room Light" Levenshtein distance: "livng light" → finds "Living Room Light" (typo-tolerant) ### JSON Mode Add --json to any command for machine-readable output: homeycli devices --json | jq '.[] | select(.class == "light")' homeycli status --json ### Examples Morning routine: homeycli device "Bedroom Light" on homeycli device "Bedroom Light" set dim 0.3 homeycli device "Thermostat" set target_temperature 20 Check temperature: homeycli device "Living Room" get measure_temperature Trigger scene: homeycli flow trigger "Movie Time" List all lights: homeycli devices --json | jq '.[] | select(.class == "light") | .name' ### Troubleshooting "No auth configured" Local (LAN/VPN): Save local config: echo "" | homeycli auth set-local --address http:// --stdin Cloud (remote/headless): Save cloud token: echo "" | homeycli auth set-token --stdin Cloud tokens can be created in Homey Developer Tools: https://tools.developer.homey.app/api/clients "Device not found" / ambiguous match List devices with homeycli devices --json (or homeycli devices --match --json) to find the right id If a query matches more than one device, the CLI returns candidate IDs and asks you to specify the device by ID "Capability not supported" Check available capabilities: homeycli devices shows what each device supports Common issue: trying to turn on a sensor (use get instead of set) ### API Reference The CLI uses the official homey-api npm package (v3.15.0). Auth/connection modes: Local mode: HomeyAPI.createLocalAPI({ address, token }) using the Homey Web App local API key. Cloud mode: AthomCloudAPI using a cloud bearer token (PAT) to create a session and access devices/flows/zones. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: maxsumrall - Version: 1.1.2 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-04T04:17:26.781Z - Expires at: 2026-05-11T04:17:26.781Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/homey) - [Send to Agent page](https://openagent3.xyz/skills/homey/agent) - [JSON manifest](https://openagent3.xyz/skills/homey/agent.json) - [Markdown brief](https://openagent3.xyz/skills/homey/agent.md) - [Download page](https://openagent3.xyz/downloads/homey)