← 返回 Skills 市场
SwitchBot OpenAPI
作者
switchbot-dev
· GitHub ↗
· v1.0.4
· MIT-0
1719
总下载
1
收藏
1
当前安装
4
版本数
在 OpenClaw 中安装
/install switchbot-cloudapi
功能描述
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...
安全使用建议
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.
功能分析
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.
能力标签
能力评估
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.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install switchbot-cloudapi - 安装完成后，直接呼叫该 Skill 的名称或使用
/switchbot-cloudapi触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
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.
元数据
常见问题
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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 1719 次。
如何安装 SwitchBot OpenAPI？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install switchbot-cloudapi」即可一键安装，无需额外配置。
SwitchBot OpenAPI 是免费的吗？
是的，SwitchBot OpenAPI 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
SwitchBot OpenAPI 支持哪些平台？
SwitchBot OpenAPI 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 SwitchBot OpenAPI？
由 switchbot-dev（@switchbot-dev）开发并维护，当前版本 v1.0.4。
推荐 Skills