← Back to Skills Marketplace
SwitchBot Smart Home Control
by
Ju Chun Ko
· GitHub ↗
· v1.0.0
1685
Downloads
1
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install switchbot
Description
Control SwitchBot smart home devices (curtains, plugs, lights, locks, etc.) via SwitchBot Cloud API. Use when user asks to open/close curtains, turn on/off lights/plugs, check temperature/humidity, or control any SwitchBot device.
Usage Guidance
This skill appears to do what it says, but review and follow these precautions before use:
- Verify origin/trust: source is 'unknown' — only install/run if you trust the publisher or after you inspect the code (you have the script here).
- Protect credentials: follow the SKILL.md advice (store token/secret in ~/.config/switchbot/credentials.json with chmod 600). Do not paste the token/secret into chat or public logs.
- Consider secrets management: if you prefer, store credentials in a local secret manager and modify the script to read them securely instead of a file.
- Limit exposure: run the script on a machine/network you control; it's benign but it can send commands to your devices.
- Device ID privacy: updating TOOLS.md with device IDs is convenient but leaks device identifiers to your agent/tooling — avoid putting secrets or sensitive location info in that file.
- Test safely: test with a non-critical device first (e.g., a light) to confirm expected behavior.
- Rotate keys if compromised: if you accidentally expose the token/secret, rotate them via the SwitchBot app/dev settings.
If you want a higher assurance level, request an auditable provenance (who published the skill) or run the script in an isolated environment before granting the skill regular use.
Capability Analysis
Type: OpenClaw Skill
Name:
Developer:
Version:
Description: OpenClaw Agent Skill
Suspicious High-Entropy/Eval files: 1
The skill is designed to control SwitchBot smart home devices via their official Cloud API. It provides clear instructions in SKILL.md for users to obtain and securely store API credentials in `~/.config/switchbot/credentials.json` with appropriate file permissions (chmod 600). The `scripts/switchbot.py` script correctly implements HMAC-SHA256 authentication for API calls to `https://api.switch-bot.com/v1.1` and handles credential loading and API interactions securely. There is no evidence of data exfiltration, malicious execution, persistence, obfuscation, or prompt injection attempts against the agent to perform unauthorized actions. All actions are aligned with the stated purpose of device control.
Capability Assessment
Purpose & Capability
Name/description, SKILL.md, and the included Python script are coherent: they implement SwitchBot Cloud API calls to list devices, read status, and send commands. No unrelated services, binaries, or credentials are requested.
Instruction Scope
Runtime instructions stay within the expected scope: they ask the human to obtain a SwitchBot token/secret, store them in ~/.config/switchbot/credentials.json, run the included script for discovery and control, and optionally record device IDs in TOOLS.md. Note: instructing the user to add device IDs to TOOLS.md may store device identifiers in agent tooling/docs — this is expected for convenience but is a potential privacy consideration.
Install Mechanism
There is no install spec; this is an instruction-only skill with a bundled Python script that uses only standard-library modules. Nothing is downloaded or extracted from untrusted URLs.
Credentials
The skill asks the user to place a token and secret in a local credentials file (reasonable and proportionate). One small inconsistency: the registry metadata shows no primary credential or required env vars even though credentials are required via the config file; this is a metadata omission rather than a security red flag. Protecting the credentials file (chmod 600) as instructed is important.
Persistence & Privilege
always is false and the skill does not request persistent system-wide privileges or modify other skills. The skill can be invoked autonomously by the agent (platform default), which is normal; no elevated persistence is requested.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install switchbot - After installation, invoke the skill by name or use
/switchbot - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: Control SwitchBot curtains, plugs, lights, and more via Cloud API
Metadata
Frequently Asked Questions
What is SwitchBot Smart Home Control?
Control SwitchBot smart home devices (curtains, plugs, lights, locks, etc.) via SwitchBot Cloud API. Use when user asks to open/close curtains, turn on/off lights/plugs, check temperature/humidity, or control any SwitchBot device. It is an AI Agent Skill for Claude Code / OpenClaw, with 1685 downloads so far.
How do I install SwitchBot Smart Home Control?
Run "/install switchbot" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is SwitchBot Smart Home Control free?
Yes, SwitchBot Smart Home Control is completely free (open-source). You can download, install and use it at no cost.
Which platforms does SwitchBot Smart Home Control support?
SwitchBot Smart Home Control is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created SwitchBot Smart Home Control?
It is built and maintained by Ju Chun Ko (@daaab); the current version is v1.0.0.
More Skills