HermesWatcher
Search⌘K For brandsSetup help
StartStart hereSetup plannerInstall Hermes AgentChat from your phoneYour first 24 hours
Use casesWorkflow blueprintsCase studiesUse-case collectionsCommunity libraryPrompt library
LearnWhat is Hermes Agent?GuidesTopicsFAQCommand cheat sheetGlossarySOUL.md gallery
ToolsTools & integrationsAll messaging platformsSkills directoryPlugins directorySkills, plugins & MCP
TroubleshootReleases
Work with usServicesNewsletterFor brands: partner with usFor AI agentsContactAboutFollow @HermesWatcher on X ↗ (opens in a new tab)

Switchbot Control

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.
    hermes plugins install switchbot-control
  2. Said no? Turn it on later:
    hermes plugins enable switchbot-control
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

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

Full setup & settings ↗Source code ↗

More in everyday life & fun

All everyday life & fun plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins