Tencent SkillHub · Developer Tools

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, or send commands (turn on/off, press, set mode, lock/unlock, set temperature, curtain open %, etc.). Requires SWITCHBOT_TOKEN and SWITCHBOT_SECRET.

skill openclawclawhub Free

0 Downloads

0 Stars

0 Installs

0 Score

High Signal

⬇ 0 downloads ★ 0 stars Unverified but indexed

Install for OpenClaw

Quick setup

Download the package from Yavira.
Extract the archive and review SKILL.md first.
Import or place the package into your OpenClaw setup.

Requirements

Target platform: OpenClaw
Install method: Manual import
Extraction: Extract archive
Prerequisites: OpenClaw
Primary doc: SKILL.md

Package facts

Download mode: Yavira redirect
Package format: ZIP package
Source platform: Tencent SkillHub
What's included: README-CLAWHUB.md, SKILL.md, _meta.json, scripts/execute_scene.sh, scripts/get_status.sh, scripts/list_devices.sh

Validation

Use the Yavira download entry.
Review SKILL.md after the package is downloaded.
Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

Download the package from Yavira.
Extract it into a folder your agent can access.
Paste one of the prompts below and point your agent at the extracted folder.

New install

I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.

Upgrade existing

I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.

Open Send to Agent page Open JSON manifest Open Markdown brief

Trust & source

Release facts

Source: Tencent SkillHub
Verification: Indexed source record
Version: 1.0.2

Provenance

Publisher: switchbot-dev
Source page: View original listing
Canonical URL: Open canonical page

Documentation

ClawHub primary doc Primary doc: SKILL.md 5 sections Open source page

SwitchBot OpenAPI Skill

This skill equips the agent to operate SwitchBot devices via HTTPS requests to the official OpenAPI v1.1. It includes ready-to-run scripts and a Node CLI; use these instead of re-deriving the HMAC signature each time.

Quick Start (Operator)

Set environment variables: SWITCHBOT_TOKEN: your OpenAPI token SWITCHBOT_SECRET: your OpenAPI secret Test (list devices): Bash: scripts/list_devices.sh Node: node scripts/switchbot_cli.js list Common tasks: Basic controls: List devices: node scripts/switchbot_cli.js list Get status: node scripts/switchbot_cli.js status <deviceId> Turn on/off: node scripts/switchbot_cli.js cmd <deviceId> turnOn / turnOff Toggle: node scripts/switchbot_cli.js cmd <deviceId> toggle Press (Bot): node scripts/switchbot_cli.js cmd <deviceId> press Curtain / Curtain 3: Set position: node scripts/switchbot_cli.js cmd <deviceId> setPosition --pos=50 (0=open, 100=closed; CLI auto-formats to 0,ff,50) Pause: node scripts/switchbot_cli.js cmd <deviceId> pause Lock / Lock Pro / Lock Ultra / Lock Lite: Lock/Unlock: node scripts/switchbot_cli.js cmd <deviceId> lock / unlock Deadbolt: node scripts/switchbot_cli.js cmd <deviceId> deadbolt Lights (Color Bulb / Strip Light / Floor Lamp / Strip Light 3 / RGBICWW etc.): Set color: node scripts/switchbot_cli.js cmd <deviceId> setColor --param="255:100:0" Set brightness: node scripts/switchbot_cli.js cmd <deviceId> setBrightness --param=80 Set color temp: node scripts/switchbot_cli.js cmd <deviceId> setColorTemperature --param=4000 Fans (Battery Circulator Fan / Circulator Fan / Standing Circulator Fan): Wind mode: node scripts/switchbot_cli.js cmd <deviceId> setWindMode --param=natural Wind speed: node scripts/switchbot_cli.js cmd <deviceId> setWindSpeed --param=50 Night light: node scripts/switchbot_cli.js cmd <deviceId> setNightLightMode --param=1 Auto-off timer: node scripts/switchbot_cli.js cmd <deviceId> closeDelay --param=3600 Robot Vacuum S1/S1 Plus/K10+/K10+ Pro: Start: node scripts/switchbot_cli.js cmd <deviceId> start Stop: node scripts/switchbot_cli.js cmd <deviceId> stop Dock: node scripts/switchbot_cli.js cmd <deviceId> dock Suction: node scripts/switchbot_cli.js cmd <deviceId> PowLevel --param=2 Robot Vacuum K10+ Pro Combo / K20+ Pro / S10 / S20 / K11+: Start clean: node scripts/switchbot_cli.js cmd <deviceId> startClean --param='{"action":"sweep_mop","param":{"fanLevel":2,"waterLevel":1,"times":1}}' Pause/Dock: node scripts/switchbot_cli.js cmd <deviceId> pause / dock Volume: node scripts/switchbot_cli.js cmd <deviceId> setVolume --param=50 Self clean (S10/S20): node scripts/switchbot_cli.js cmd <deviceId> selfClean --param=1 Blind Tilt: Set position: node scripts/switchbot_cli.js cmd <deviceId> setPosition --param="up;60" Fully open: node scripts/switchbot_cli.js cmd <deviceId> fullyOpen Close: node scripts/switchbot_cli.js cmd <deviceId> closeUp / closeDown Roller Shade: Set position: node scripts/switchbot_cli.js cmd <deviceId> setPosition --param=50 Humidifier (original): Set mode: node scripts/switchbot_cli.js cmd <deviceId> setMode --param=auto Evaporative Humidifier / Auto-refill: Set mode: node scripts/switchbot_cli.js cmd <deviceId> setMode --param='{"mode":7,"targetHumidify":60}' Child lock: node scripts/switchbot_cli.js cmd <deviceId> setChildLock --param=true Air Purifier (VOC/PM2.5/Table): Set mode: node scripts/switchbot_cli.js cmd <deviceId> setMode --param='{"mode":2,"fanGear":2}' Child lock: node scripts/switchbot_cli.js cmd <deviceId> setChildLock --param=1 Smart Radiator Thermostat: Set mode: node scripts/switchbot_cli.js cmd <deviceId> setMode --param=1 Set temp: node scripts/switchbot_cli.js cmd <deviceId> setManualModeTemperature --param=22 Relay Switch 1PM / 1 / 2PM: Toggle: node scripts/switchbot_cli.js cmd <deviceId> toggle Set mode: node scripts/switchbot_cli.js cmd <deviceId> setMode --param=0 2PM channel: node scripts/switchbot_cli.js cmd <deviceId> turnOn --param="1" (channel 1 or 2) Garage Door Opener: Open/Close: node scripts/switchbot_cli.js cmd <deviceId> turnOn / turnOff Video Doorbell: Motion detection: node scripts/switchbot_cli.js cmd <deviceId> enableMotionDetection / disableMotionDetection Candle Warmer Lamp: Brightness: node scripts/switchbot_cli.js cmd <deviceId> setBrightness --param=50 AI Art Frame: Next/Previous: node scripts/switchbot_cli.js cmd <deviceId> next / previous Keypad / Keypad Touch / Keypad Vision / Keypad Vision Pro: Create passcode: node scripts/switchbot_cli.js cmd <deviceId> createKey --param='{"name":"Guest","type":"permanent","password":"12345678"}' Delete passcode: node scripts/switchbot_cli.js cmd <deviceId> deleteKey --param='{"id":"11"}' ⚠️ Keypad commands are async — results come via webhook. IR Remote - Air Conditioner: Set all: node scripts/switchbot_cli.js cmd <deviceId> setAll --param="26,2,1,on" (format: temperature, mode, fan speed, power state) mode: 0/1=auto, 2=cool, 3=dry, 4=fan, 5=heat fan: 1=auto, 2=low, 3=medium, 4=high power: on/off IR Remote - TV: Channel: node scripts/switchbot_cli.js cmd <deviceId> SetChannel --param=5 Volume: node scripts/switchbot_cli.js cmd <deviceId> volumeAdd / volumeSub IR Remote - Others (DIY): Custom button: node scripts/switchbot_cli.js cmd <deviceId> <buttonName> --commandType=customize Scenes (fallback): List scenes: node scripts/switchbot_cli.js scenes Execute scene: node scripts/switchbot_cli.js scene <sceneId>

API Reference

Base URL: https://api.switch-bot.com Path prefix: /v1.1 Daily limit: 10,000 API calls Headers (all required): Authorization: <SWITCHBOT_TOKEN> sign: HMAC-SHA256(token + t + nonce, secret), Base64-encoded t: 13-digit millisecond timestamp nonce: random UUID Key endpoints: GET /v1.1/devices — list all devices GET /v1.1/devices/{deviceId}/status — device status POST /v1.1/devices/{deviceId}/commands — send command GET /v1.1/scenes — list scenes POST /v1.1/scenes/{sceneId}/execute — execute scene Command body format: { "command": "<commandName>", "parameter": "<string|object>", "commandType": "command" } For IR "Others" (DIY) devices, use "commandType": "customize".

Agent Guidelines

Always use the provided CLI scripts — they handle HMAC signatures automatically. The CLI runs preflight checks for BLE devices (Bot, Lock, Curtain, Blind Tilt) — requires Hub + Cloud Services enabled. For IR Air Conditioner, only setAll is supported (not separate setMode/setTemp). For Keypad commands (createKey/deleteKey), results are async via webhook. If a command returns statusCode 160, the device may not support that command — use Scenes as fallback. Never log tokens/secrets. Ask user to set them as environment variables.

Files

scripts/switchbot_cli.js — Node CLI (list/status/cmd/scenes) scripts/list_devices.sh — curl: list devices scripts/get_status.sh — curl: get status scripts/send_command.sh — curl: send command scripts/list_scenes.sh — curl: list scenes scripts/execute_scene.sh — curl: execute scene references/commands.md — complete command reference per device type references/examples.md — usage examples

Category context

Code helpers, APIs, CLIs, browser automation, testing, and developer operations.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package

3 Scripts2 Docs1 Config

SKILL.md Primary doc
README-CLAWHUB.md Docs
scripts/execute_scene.sh Scripts
scripts/get_status.sh Scripts
scripts/list_devices.sh Scripts
_meta.json Config