← 返回 Skills 市场
Loxone
作者
Oliver Drobnik
· GitHub ↗
· v1.3.3
1381
总下载
2
收藏
2
当前安装
12
版本数
在 OpenClaw 中安装
/install loxone
功能描述
Control and monitor a Loxone Miniserver (smart home) via HTTP API and real-time WebSocket. Use for querying room/device status (temperatures, lights), watching live events, and sending safe control commands.
使用说明 (SKILL.md)
Loxone (Smart Home)
Setup
See SETUP.md for prerequisites and setup instructions.
Commands
python3 scripts/loxone.py roomspython3 scripts/loxone.py mappython3 scripts/loxone.py status "\x3CRoom>"python3 scripts/loxone.py control "\x3CRoom>" "\x3CControl>" on|offpython3 scripts/loxone_watch.py --room "\x3CRoom>" [--changes-only] [--duration \x3Csec>]
Notes
- Treat as read-only by default; only use control commands when explicitly requested.
- WebSocket auth can be finicky; if WS fails, fall back to HTTP status queries.
安全使用建议
This package appears to do what it says: communicate with a Loxone Miniserver via HTTP and WebSocket. Before installing or running: 1) Note the mismatch in docs—SETUP.md incorrectly claims only standard library; you must install requests and websockets (from PyPI) or otherwise ensure they exist. 2) The skill stores your Loxone username/password in a local config.json—follow the SETUP.md advice and restrict file permissions (chmod 600). 3) The skill will contact dns.loxonecloud.com if you use Cloud DNS and will talk directly to the configured Miniserver; only provide credentials/remote access you trust. 4) Control commands can have real-world effects—use the read-only defaults and only run control actions when you explicitly intend to (the scripts include a safe-rooms check). 5) Consider running the scripts in an isolated environment (virtualenv/container) and review the code yourself if you have sensitive network exposure requirements. If you want higher assurance, ask the publisher to fix the documentation about required Python packages and confirm the expected config file path.
功能分析
Type: OpenClaw Skill
Name: loxone
Version: 1.3.3
The OpenClaw Loxone skill is classified as benign. The code and documentation are well-aligned with the stated purpose of controlling a Loxone smart home system. Key indicators for this classification include explicit instructions in `SKILL.md` and `SETUP.md` for the AI agent to 'Treat as read-only by default' and only use control commands 'when explicitly requested', demonstrating a focus on safety. Input sanitization is present in `scripts/loxone.py` and `scripts/loxone_client.py` for command values and UUIDs, mitigating injection risks. All network calls are directed to the Loxone Miniserver or its Cloud DNS resolution service, with no evidence of data exfiltration to unauthorized external endpoints. There are no signs of obfuscation, persistence mechanisms, or arbitrary code execution.
能力评估
Purpose & Capability
Name/description match the included Python scripts (HTTP API client + WebSocket watcher) and the listed commands. The network calls (Miniserver endpoints and Loxone Cloud DNS) are expected for this purpose. Minor documentation mismatch: SETUP.md claims "No additional Python packages required (standard library)" while SKILL.md and the code require third-party packages (requests, websockets).
Instruction Scope
SKILL.md and the scripts limit actions to Loxone-related activities: loading a local config.json, fetching LoxAPP3.json, opening HTTPS/HTTP to the configured host, and connecting to dns.loxonecloud.com when using Cloud DNS. The skill reads only its own config file and caches a structure file; it does not attempt to read unrelated system files or environment variables. It prints partial tokens to stdout during auth flows (informational).
Install Mechanism
No install spec (instruction-only at registry level) — the runtime is the included Python scripts. This is lower-risk than arbitrary remote installs. The scripts do depend on third-party Python packages (requests, websockets) — ensure these are installed from known sources before running.
Credentials
No environment variables or external credentials are requested by the registry metadata. The skill requires Loxone username/password, but these are stored in a local config.json as documented (expected for a network client). This credential usage is proportional to the stated functionality; users should protect the local config file (SETUP.md recommends chmod 600).
Persistence & Privilege
always:false and no claims of modifying other skills or system-wide settings. The skill caches a structure file in its directory and a small .cache LoxAPP3.json — normal for offline efficiency. Agent autonomous invocation is enabled by default but not elevated by the skill.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install loxone - 安装完成后,直接呼叫该 Skill 的名称或使用
/loxone触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.3.3
Remove invented sensitivity metadata field
v1.3.2
Declare missing dependencies, env vars, and sensitivity in metadata
v1.3.1
Rename .clawdhubignore to .clawhubignore
v1.3.0
Refactor: move setup/prerequisites to SETUP.md, keep SKILL.md lean
v1.2.0
- Bump version to 1.2.0.
- Internal script updates in loxone.py and loxone_client.py.
- No user-facing changes documented in SKILL.md.
v1.1.0
Security: removed verify_ssl bypass and LOXONE_INSECURE_SSL env var. SSL verification is now always enforced when use_https is true. Use use_https:false for plain HTTP LAN connections instead.
v1.0.5
Docs: clarify host supports IPs, arbitrary hostnames, and Cloud DNS shorthand (dns.loxonecloud.com/<SERIAL>); redact personal serial from examples.
v1.0.4
Docs/packaging cleanup (valid config.json.example, ignore runtime artifacts). Supports Cloud DNS shorthand host without hard-coded IP.
v1.0.3
Support Cloud DNS shorthand host (dns.loxonecloud.com/<snr>) and resolve tunnel endpoint at runtime (no hard-coded IP).
v1.0.2
Security: enable HTTPS + cert verification by default (remove verify=False), support wss, and make insecure mode explicit (verify_ssl:false or LOXONE_INSECURE_SSL=1).
v1.0.1
Add README + release tags
v1.0.0
Initial public release (clean repo, no secrets).
元数据
常见问题
Loxone 是什么?
Control and monitor a Loxone Miniserver (smart home) via HTTP API and real-time WebSocket. Use for querying room/device status (temperatures, lights), watching live events, and sending safe control commands. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 1381 次。
如何安装 Loxone?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install loxone」即可一键安装,无需额外配置。
Loxone 是免费的吗?
是的,Loxone 完全免费(开源免费),可自由下载、安装和使用。
Loxone 支持哪些平台?
Loxone 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Loxone?
由 Oliver Drobnik(@odrobnik)开发并维护,当前版本 v1.3.3。
推荐 Skills