{ "schemaVersion": "1.0", "item": { "slug": "homey-cli", "name": "Homey - Home Automation", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/KrauseFx/homey-cli", "canonicalUrl": "https://clawhub.ai/KrauseFx/homey-cli", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/homey-cli", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=homey-cli", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "SKILL.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. 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/homey-cli" }, "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-cli", "agentPageUrl": "https://openagent3.xyz/skills/homey-cli/agent", "manifestUrl": "https://openagent3.xyz/skills/homey-cli/agent.json", "briefUrl": "https://openagent3.xyz/skills/homey-cli/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": "Homey CLI", "body": "Safe, agent-friendly CLI for controlling Homey home automation hubs." }, { "title": "What This Skill Provides", "body": "Device control: Turn devices on/off, dim lights, change colors, set temperatures\nDevice inspection: List devices, check status, read capabilities\nZone management: List zones and devices per zone\nFlow control: List and trigger flows\nInventory: Get complete hub overview" }, { "title": "1. Install Dependencies", "body": "cd skills/homey-cli\nnpm install" }, { "title": "2. Create Homey App Credentials", "body": "Go to https://tools.developer.homey.app/tools/app\nCreate a new app with:\n\nCallback URL: http://localhost:8787/callback\nNote your Client ID and Client Secret" }, { "title": "3. Configure Environment", "body": "Create .env file:\n\nexport HOMEY_CLIENT_ID=\"your-client-id\"\nexport HOMEY_CLIENT_SECRET=\"your-client-secret\"\nexport HOMEY_REDIRECT_URL=\"http://localhost:8787/callback\"" }, { "title": "4. Login", "body": "bash run.sh auth login\n\nFollow the OAuth flow in your browser. Tokens are stored in ~/.config/homey-cli/." }, { "title": "List Homeys", "body": "bash run.sh homey list" }, { "title": "Select Active Homey", "body": "bash run.sh homey use " }, { "title": "Device Operations", "body": "# List all devices\nbash run.sh devices list\n\n# List devices as JSON\nbash run.sh devices list --json\n\n# Get specific device\nbash run.sh devices get \n\n# Read capability value\nbash run.sh devices read onoff\n\n# Control devices\nbash run.sh devices on \nbash run.sh devices off \nbash run.sh devices dim 0.4\nbash run.sh devices color #FF8800\nbash run.sh devices temperature 21.5" }, { "title": "Flow Operations", "body": "# List flows\nbash run.sh flows list\n\n# Trigger flow\nbash run.sh flows trigger " }, { "title": "Complete Inventory", "body": "bash run.sh inventory --json" }, { "title": "Safety Model", "body": "Write operations are capability-allowlisted for safety:\n\nDefault allowed: onoff, dim, light_hue, light_saturation, light_temperature, target_temperature\nOverride via: export HOMEY_CLI_ALLOWED_CAPABILITIES=onoff,dim,target_temperature\n\nDestructive operations (delete devices, modify flows, change app settings) are not supported." }, { "title": "Common Queries", "body": "When users ask:\n\n\"Turn on the kitchen lights\" → List devices, find match, use devices on \n\"Dim living room to 50%\" → Find device, use devices dim 0.5\n\"What's the temperature in the bedroom?\" → Find device, use devices read measure_temperature\n\"List all my lights\" → Use devices list --json and filter by class/capabilities" }, { "title": "Configuration Storage", "body": "Tokens: ~/.config/homey-cli/credentials.json\nActive Homey: ~/.config/homey-cli/config.json" }, { "title": "Troubleshooting", "body": "Auth errors: Re-run bash run.sh auth login\nDevice not found: Check device name/ID with bash run.sh devices list\nCapability not allowed: Add to HOMEY_CLI_ALLOWED_CAPABILITIES or check if it's a read-only capability" } ], "body": "Homey CLI\n\nSafe, agent-friendly CLI for controlling Homey home automation hubs.\n\nWhat This Skill Provides\nDevice control: Turn devices on/off, dim lights, change colors, set temperatures\nDevice inspection: List devices, check status, read capabilities\nZone management: List zones and devices per zone\nFlow control: List and trigger flows\nInventory: Get complete hub overview\nSetup\n1. Install Dependencies\ncd skills/homey-cli\nnpm install\n\n2. Create Homey App Credentials\nGo to https://tools.developer.homey.app/tools/app\nCreate a new app with:\nCallback URL: http://localhost:8787/callback\nNote your Client ID and Client Secret\n3. Configure Environment\n\nCreate .env file:\n\nexport HOMEY_CLIENT_ID=\"your-client-id\"\nexport HOMEY_CLIENT_SECRET=\"your-client-secret\"\nexport HOMEY_REDIRECT_URL=\"http://localhost:8787/callback\"\n\n4. Login\nbash run.sh auth login\n\n\nFollow the OAuth flow in your browser. Tokens are stored in ~/.config/homey-cli/.\n\nUsage\nList Homeys\nbash run.sh homey list\n\nSelect Active Homey\nbash run.sh homey use \n\nDevice Operations\n# List all devices\nbash run.sh devices list\n\n# List devices as JSON\nbash run.sh devices list --json\n\n# Get specific device\nbash run.sh devices get \n\n# Read capability value\nbash run.sh devices read onoff\n\n# Control devices\nbash run.sh devices on \nbash run.sh devices off \nbash run.sh devices dim 0.4\nbash run.sh devices color #FF8800\nbash run.sh devices temperature 21.5\n\nFlow Operations\n# List flows\nbash run.sh flows list\n\n# Trigger flow\nbash run.sh flows trigger \n\nComplete Inventory\nbash run.sh inventory --json\n\nSafety Model\n\nWrite operations are capability-allowlisted for safety:\n\nDefault allowed: onoff, dim, light_hue, light_saturation, light_temperature, target_temperature\nOverride via: export HOMEY_CLI_ALLOWED_CAPABILITIES=onoff,dim,target_temperature\n\nDestructive operations (delete devices, modify flows, change app settings) are not supported.\n\nCommon Queries\n\nWhen users ask:\n\n\"Turn on the kitchen lights\" → List devices, find match, use devices on \n\"Dim living room to 50%\" → Find device, use devices dim 0.5\n\"What's the temperature in the bedroom?\" → Find device, use devices read measure_temperature\n\"List all my lights\" → Use devices list --json and filter by class/capabilities\nConfiguration Storage\nTokens: ~/.config/homey-cli/credentials.json\nActive Homey: ~/.config/homey-cli/config.json\nTroubleshooting\nAuth errors: Re-run bash run.sh auth login\nDevice not found: Check device name/ID with bash run.sh devices list\nCapability not allowed: Add to HOMEY_CLI_ALLOWED_CAPABILITIES or check if it's a read-only capability" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/KrauseFx/homey-cli", "publisherUrl": "https://clawhub.ai/KrauseFx/homey-cli", "owner": "KrauseFx", "version": "1.0.0", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/homey-cli", "downloadUrl": "https://openagent3.xyz/downloads/homey-cli", "agentUrl": "https://openagent3.xyz/skills/homey-cli/agent", "manifestUrl": "https://openagent3.xyz/skills/homey-cli/agent.json", "briefUrl": "https://openagent3.xyz/skills/homey-cli/agent.md" } }