@cly-org/switchbot-openclaw-skill

@cly-org/switchbot-openclaw-skill

SwitchBot smart-home skill for OpenClaw — exposes 6 MCP tools so AI agents can control SwitchBot devices, run scenes, and send commands.

Prerequisites

• Node.js 18+
• @switchbot/openapi-cli ≥ 3.3.0 with credentials configured (switchbot config set-token)

Installation

# Via OpenClaw plugin manager (recommended)
openclaw plugins install @cly-org/switchbot-openclaw-skill

# Or global npm
npm install -g @cly-org/switchbot-openclaw-skill

# Either way, then bootstrap the underlying CLI + credentials:
switchbot-openclaw setup

switchbot-openclaw setup verifies the @switchbot/openapi-cli is installed, at >=3.3.0, and authenticated — and prints the exact command to fix each step that isn't. Safe to re-run.

MCP Tools

Tool	Description
devices_list	List all devices in the account
devices_status	Get current status of a device
devices_describe	List supported commands for a device type
devices_command	Send a command (turnOn, turnOff, setBrightness, …)
scenes_list	List all saved scenes
scenes_run	Execute a scene by ID

All mutation commands (devices_command, scenes_run) automatically append to ~/.switchbot/audit.log.

Usage

The server communicates over stdio (MCP protocol). OpenClaw detects this tree as a Claude-style bundle and launches the MCP server via the declarations in:

• .claude-plugin/plugin.json — bundle identity
• .mcp.json — stdio launcher (node ${pluginDir}/bin/start.js)

To start manually (for debugging):

switchbot-openclaw

Policy editor

A local browser-based editor for ~/.config/openclaw/switchbot/policy.yaml:

switchbot-policy-edit
# Opens http://localhost:18799

Configuration

Edit ~/.config/openclaw/switchbot/policy.yaml to set device aliases, quiet hours, and confirmation rules. See policy.yaml docs.

License

MIT