# Switchbot Control: Hermes Agent plugin

> SwitchBot OpenAPI v1.1, personal use. No Plug Mini on/off.

Canonical: https://hermeswatcher.com/plugins/switchbot-control  
Tier: Community  
Official page (Nous Research): https://hermes-agent.nousresearch.com/docs/plugins/switchbot-control  
Last updated in catalog: 2026-10-20

SwitchBot OpenAPI v1.1, personal use. No Plug Mini on/off. Locks off unless enabled. setPosition only Curtain/Curtain3 (0=open).

## Good to know before installing

Controls real devices through the SwitchBot cloud API (api.switch-bot.com) using your SWITCHBOT_TOKEN and SWITCHBOT_SECRET. Each call reads SWITCHBOT_TOKEN and SWITCHBOT_SECRET for the active profile, and an HTTP proxy set in the environment is not used. Every command asks for Hermes approval and is refused under cron, yolo, approvals off and unattended sessions. Lock and door devices stay refused unless you turn on safety_devices. The plugin has no user list of its own: anyone you allow on your Hermes gateway can request a command and approve it. Answering "always" adds an unused line to config.yaml each time. The optional watch is a cron job (a model turn every 5 minutes by default) that stays after uninstall until you run unschedule. Not tested on real devices. While the plugin is enabled, its skill adds one line to the skills index of every session, including surfaces where the tools are turned off.

From the plugin's catalog listing.

## How to install

1. Install it. Hermes asks for any API keys it needs (this one needs `SWITCHBOT_TOKEN`, `SWITCHBOT_SECRET`), then asks whether to turn it on.

```bash
hermes plugins install switchbot-control
```

2. Said no? Turn it on later:

```bash
hermes plugins enable switchbot-control
```

3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see the official page. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide: https://hermes-agent.nousresearch.com/docs/user-guide/features/plugins

## Facts

- Category: Everyday life & fun
- Maintained by: TakeshiTGAL (Community)
- Needs: `SWITCHBOT_TOKEN`, `SWITCHBOT_SECRET` (API keys)
- Adds tools: `switchbot_devices`, `switchbot_command`, `switchbot_watch`
- Requires Hermes: `>=0.21.4`
- Version: 0.1.2
- In the catalog since: 2026-10-07, updated 2026-10-20

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/switchbot-control)
- [Source code](https://github.com/TakeshiTGAL/hermes-plugin-switchbot-control#readme)
- [All plugins](https://hermeswatcher.com/plugins.md)

---

HermesWatcher is an independent guide. It is not affiliated with or endorsed by Nous Research. The [official Hermes Agent documentation](https://hermes-agent.nousresearch.com/docs) and [repository](https://github.com/NousResearch/hermes-agent) from Nous Research are the authority; each page here lists the official sources it was written from. If this site and the official docs disagree, trust the official docs. Index for agents: https://hermeswatcher.com/llms.txt