← Back to Skills Marketplace
154
Downloads
1
Stars
0
Active Installs
7
Versions
Install in OpenClaw
/install ycznwl-smarthome
Description
Create, edit, validate, and manage KNX Gateway automation workflows and scenes via REST API. Covers device listing, device control, scene CRUD/execution, wor...
Usage Guidance
This skill appears to do what it says: control a KNX Gateway via its local REST API using a single KNX_TOKEN. Before installing, ensure the gateway Base URL points to your trusted LAN or VPN host (not an Internet host), keep KNX_TOKEN in a secret store (do not paste it into chat), and review any imported workflow JSON before calling /validate or /enable — particularly any nodes that use email, MQTT, or webhooks, because those can transmit data off your LAN if you configure them. If you want the agent to act autonomously, limit it to operations you trust (or require explicit confirmation for any off‑LAN integrations).
Capability Tags
Capability Assessment
Purpose & Capability
Name/description (KNX Gateway automation) match the declared requirements and the SKILL.md: the only required credential is KNX_TOKEN, no unrelated binaries or extra credentials are requested, and all referenced APIs/endpoints are for a local KNX gateway.
Instruction Scope
The SKILL.md gives concrete REST API call patterns and workflow import/validation guidance and explicitly warns to keep automations local and to only add off‑LAN HTTP/MQTT/webhook/email integrations with explicit user approval. This is expected, but it means workflows created with the skill can be configured to send data outside the LAN (via email, MQTT, webhooks) if the user asks — the skill documents that risk and instructs review before enabling.
Install Mechanism
Instruction-only skill with no install spec and no code to download or execute. Nothing is written to disk by an installer; lowest install risk.
Credentials
Only KNX_TOKEN is required and declared as the primary credential. The SKILL.md instructs secure handling (use secret store / env var, avoid pasting tokens). No other secrets or unrelated env vars are requested.
Persistence & Privilege
always:false and no config paths requested. The skill does not request persistent system-wide privileges or modification of other skills' settings. Autonomous invocation is allowed (platform default) but not combined with other privilege escalation indicators.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install ycznwl-smarthome - After installation, invoke the skill by name or use
/ycznwl-smarthome - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.6
Restore display name while keeping curl-free runtime metadata to avoid command-line web request scanner false positives.
v1.0.5
Remove required curl binary metadata to avoid command-line web request scanner false positives; clarify trusted-LAN defaults and sanitize external integration examples.
v1.0.4
- Updated network access requirements: now specifies that a user-provided KNX Gateway on a trusted LAN or VPN is required.
- Clarified security policy: automations and integrations now default to running only on the gateway and trusted LAN.
- Strengthened guidance on authoring workflows: off-LAN HTTP, MQTT, webhook, or email integrations must only be configured explicitly upon user request and endpoint review.
- Removed curl as a required binary from metadata.
- General copy and policy clarifications for improved safety and deployment on user-controlled networks.
v1.0.3
ycxnwl-smarthome 1.0.3
- Added explicit version declaration (`version: 1.0.3`) in SKILL.md.
- Introduced compatibility and requirements metadata (requires network access to a KNX Gateway and curl; environment variable KNX_TOKEN).
- Added OpenClaw metadata section specifying required environment variables and binaries.
- Clarified authentication in API requests, showing use of `${KNX_TOKEN}`.
- Stated that only KNX_TOKEN is required for normal operation; external workflow node credentials must not be hardcoded.
- No functional/API changes. Documentation and metadata improvements only.
v1.0.2
# ycznwl-smarthome changelog (v1.0.2)
- Added explicit UTF-8 encoding requirements, including instructions to send JSON with `charset=utf-8` and to handle Chinese characters in all user-facing fields.
- Updated scene authoring guidance: clarified that for dimmable lights, sending `set_brightness` with `brightness>0` implicitly turns on the device (no need for separate `turn_on`); added notes on preferred device naming for multi-room scenes.
- Expanded documentation for color temperature values and recommended passing user-configured (realistic) values.
- Documented sun-event and sunrise/sunset offset support in triggers and nodes.
- Added instructions for directly listing and resolving device `room_id` via `GET /rooms` for accurate scene action naming.
- Clarified automation manual trigger requirements for API-based execution.
v1.0.1
Version 1.0.1
- Skill renamed from "automation-agent" to "ycznwl-smarthome".
- Security best practices expanded: emphasizes never pasting tokens into chat and reviewing imported workflow JSON for external connections or exposure.
- Auth token storage guidance updated: recommends storing in environment variables or secret stores, not pasting in chat or hardcoding.
- More detailed security disclaimers added for webhook, HTTP request, and MQTT nodes.
- No functional API changes; documentation and naming improvements only
v1.0.0
Control devices, create scenes, and build automations on your KNX Gateway via REST API.
Covers the full workflow lifecycle: discover devices (lights, curtains, AC, sensors, locks, media players), create and execute scenes, build automation workflows with triggers (schedule, device event, KNX bus telegram,
sunrise/sunset, webhook), configure condition/logic/delay/transform nodes, and manage workflow state (import, validate, enable, monitor executions). Use when asked to automate smart home behavior, control a device, create
or run a scene, set up a schedule, or build a KNX Gateway workflow programmatically.
__Requires a running YCZNWL KNX Gateway instance and an API token.__
Metadata
Frequently Asked Questions
What is KNX Gateway Automation?
Create, edit, validate, and manage KNX Gateway automation workflows and scenes via REST API. Covers device listing, device control, scene CRUD/execution, wor... It is an AI Agent Skill for Claude Code / OpenClaw, with 154 downloads so far.
How do I install KNX Gateway Automation?
Run "/install ycznwl-smarthome" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is KNX Gateway Automation free?
Yes, KNX Gateway Automation is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does KNX Gateway Automation support?
KNX Gateway Automation is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created KNX Gateway Automation?
It is built and maintained by Leo (@tmpbin); the current version is v1.0.6.
More Skills