← Back to Skills Marketplace
SwitchBot OpenAPI
by
switchbot-dev
· GitHub ↗
· v1.0.4
· MIT-0
1719
Downloads
1
Stars
1
Active Installs
4
Versions
Install in OpenClaw
/install switchbot-cloudapi
Description
Control and query SwitchBot devices using the official OpenAPI (v1.1). Use when the user asks to list SwitchBot devices, get device status, send commands, or...
Usage Guidance
This skill appears to be a legitimate SwitchBot OpenAPI client. Before installing: (1) Treat SWITCHBOT_TOKEN and SWITCHBOT_SECRET as highly sensitive — they can be used to unlock doors and create passcodes; store them in a secure secrets store and rotate if shared. (2) Run non-destructive commands first (e.g., list, status) to validate connectivity and correct token use. (3) If you run this on a multi-tenant gateway, restrict which agents/users can invoke the skill because it can perform sensitive operations. (4) Note the README mentions SWITCHBOT_REGION (optional) though the scripts use a single base URL; verify region behavior if you expect regional endpoints. (5) The skill sends only to api.switch-bot.com (and will forward user-supplied image URLs to the API for art-frame uploads) — no other network endpoints were found.
Capability Analysis
Type: OpenClaw Skill
Name: switchbot-cloudapi
Version: 1.0.4
The skill provides a legitimate and well-documented interface for controlling SwitchBot devices via the official OpenAPI v1.1. It includes a Node.js CLI (scripts/switchbot_cli.js) and several helper shell scripts (e.g., list_devices.sh, send_command.sh) that correctly implement the required HMAC-SHA256 authentication and signature generation. The instructions in SKILL.md are security-conscious, explicitly advising the agent never to log tokens or secrets and to handle sensitive operations like unlocking with care.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description match the code and scripts. Required binaries (node, curl, openssl, jq, uuidgen) and required env vars (SWITCHBOT_TOKEN, SWITCHBOT_SECRET) are appropriate for signing and calling the official SwitchBot OpenAPI. The included shell scripts and Node CLI implement the documented operations (list, status, commands, scenes).
Instruction Scope
SKILL.md and the scripts instruct the agent to call api.switch-bot.com and to use the provided CLI/scripts. The runtime instructions only read the declared env vars and run the bundled scripts; they do not attempt to read unrelated system files or contact unexpected external endpoints. The Node CLI and shell scripts perform preflight checks and then call the official API.
Install Mechanism
No install spec or external download is present; this is delivered as source files and scripts. Nothing in the package pulls arbitrary code from untrusted URLs or creates non-standard binaries.
Credentials
The skill only requires SWITCHBOT_TOKEN and SWITCHBOT_SECRET, which is proportionate for an API client. Note: those credentials grant full API access and therefore can perform sensitive actions (unlocking locks, creating passcodes, executing scenes). The README mentions an optional SWITCHBOT_REGION, but it is not declared in requires.env and the code currently uses a single base URL—minor inconsistency. Users should ensure the token/secret are stored securely and scoped/rotated appropriately.
Persistence & Privilege
always:false and user-invocable:true (default) — the skill does not request permanent/automatic inclusion or elevated platform privileges, and it does not modify other skills or system-wide settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install switchbot-cloudapi - After installation, invoke the skill by name or use
/switchbot-cloudapi - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.4
switchbot-openapi 1.0.4 changelog:
1、Weather Station now supports custom daily quotes.
2、Art Frame improves image uploads by automatically detecting and converting image link formats.
3、Optimized home and room information retrieval for better stability and accuracy.
v1.0.2
Supports batch control of devices based on home names, room names, or category types (such as lights, thermostats, and air purifiers)
v1.0.1
Fixed minor bugs.
v1.0.0
Initial public release of the SwitchBot OpenAPI skill.
This is a beta version.
- Control and query SwitchBot devices via the official OpenAPI (v1.1).
- Supports listing devices, getting device status, and sending commands (turn on/off, press, set mode, lock/unlock, set temperature, curtain open %, etc.).
- Includes ready-to-use CLI/scripts for common operations.
- Requires environment variables for secure authentication (SWITCHBOT_TOKEN and SWITCHBOT_SECRET).
- Notes on device/model limitations and error handling included.
- Additional API details, usage instructions, and file references provided.
Metadata
Frequently Asked Questions
What is SwitchBot OpenAPI?
Control and query SwitchBot devices using the official OpenAPI (v1.1). Use when the user asks to list SwitchBot devices, get device status, send commands, or... It is an AI Agent Skill for Claude Code / OpenClaw, with 1719 downloads so far.
How do I install SwitchBot OpenAPI?
Run "/install switchbot-cloudapi" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is SwitchBot OpenAPI free?
Yes, SwitchBot OpenAPI is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does SwitchBot OpenAPI support?
SwitchBot OpenAPI is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created SwitchBot OpenAPI?
It is built and maintained by switchbot-dev (@switchbot-dev); the current version is v1.0.4.
More Skills