switchbot

What This Skill Does

The SwitchBot skill for OpenClaw provides a robust interface for interacting with your smart home ecosystem via the SwitchBot Cloud API v1.1. It empowers your AI agent to act as a central controller for a wide array of IoT devices, including motorized curtains, smart plugs, lights, physical robot button pushers (Bots), smart locks, and environmental sensors. By bridging the gap between your natural language requests and the SwitchBot API, the skill translates simple instructions into specific cloud-based commands. This enables advanced automation, such as setting curtain positions, toggling power for appliances, monitoring temperature and humidity, or triggering locks, all within your existing OpenClaw workflow.

Installation

To begin, ensure your OpenClaw environment is ready. Use the command clawhub install openclaw/skills/skills/daaab/switchbot to add the functionality. Once installed, follow the setup guide: obtain your Token and Secret Key via the SwitchBot App under the 'Developer Options' section. Create a secure local directory at ~/.config/switchbot and save your credentials in credentials.json with strict 600 permissions. Finally, run the discovery script via python3 <skill_path>/scripts/switchbot.py list to populate your device list. We recommend maintaining an updated table of your device IDs and types in your TOOLS.md file for easier reference by the AI.

Use Cases

This skill is perfect for home automation scenarios. Use it to wake up to natural light by scheduling curtains, manage energy usage by toggling plugs based on time or occupancy, and ensure your home's security by checking the status of smart locks. It is also excellent for climate control, allowing you to monitor sensor data from meters and humidifiers to keep your living space comfortable.

Example Prompts

1. "Open the living room curtains to 50% and turn on the bedroom light."
2. "Check the current temperature and humidity in the baby's room using the Meter sensor."
3. "Is the front door locked? If not, please lock it now."

Tips & Limitations

Note that this skill relies on the SwitchBot Cloud API; therefore, an active internet connection is required for all commands. It does not communicate via Bluetooth directly with devices. Ensure your Hub Mini or Hub 2 is properly configured, as they act as the gateway for your non-Wi-Fi devices. Always check your device ID list if a command fails, as devices may be renamed or offline.