Lutron Caseta

OpenClaw plugin for Lutron Caseta smart lighting. It shells out to the lutron CLI to control lights, dimmers, shades, fans, and Pico remotes, activate scenes, toggle Smart Away vacation mode, and read occupancy, battery, and bridge health. Talks to a Lutron Caseta Smart Bridge on your local network.

Install

1. Install the plugin from ClawHub.

2. Install the CLI it depends on:

   pipx install git+https://github.com/omarshahine/lutron-cli
   

   (Homebrew: brew install omarshahine/tap/lutron-cli.) Requires Python 3.10+.

3. Pair with your bridge once (press the small black button on the back within 180s):

   lutron scan         # find the bridge IP
   lutron pair <ip>    # saves pairing certs
   lutron devices      # verify: should return a JSON array
   

The plugin resolves the CLI from the cliPath config, the LUTRON_CLI_PATH env var, or PATH.

Tools

Tool	Purpose
lutron_scenes	List programmed scenes (id + name). Call first to look up scene ids.
lutron_activate_scene	Activate a scene by scene_id.
lutron_devices	List paired devices. Optional domain filter: light, switch, fan, cover, sensor.
lutron_device_status	Current state of one device by device_id.
lutron_set_level	Set a light/dimmer/switch to level 0-100 (0 = off, 100 = full). Optional fade seconds.
lutron_set_fan	Set fan speed: Off, Low, Medium, MediumHigh, High.
lutron_cover	Raise, lower, or stop a shade/blind. Optional tilt 0-100.
lutron_warm_dim	Set warm-dim level on a warm-dim-capable bulb.
lutron_buttons	List Pico / keypad buttons (optional device_id filter).
lutron_tap	Simulate a Pico / keypad button press by button_id.
lutron_battery	Battery status for one device, or all battery-powered devices.
lutron_smart_away	Check, enable, or disable Smart Away (action: status|on|off).
lutron_areas	List rooms / areas on the bridge.
lutron_occupancy	Occupancy sensor groups (Occupied / Unoccupied).
lutron_all_off	Panic switch: turn off every controllable device. Optional area, exclude, fade.
lutron_info	Bridge health: connection state, device/scene/area counts, versions.
lutron_export	Full JSON snapshot of areas, devices, scenes, occupancy, buttons.

Smart Away

Smart Away randomly activates lights based on learned occupancy patterns to make it look like someone is home. It only works on Caseta Smart Bridges (not RA3 or HomeWorks QSX). Typical departure flow: activate a departure scene, lutron_all_off for anything left on, then lutron_smart_away { action: "on" }. Reverse on arrival.

Safety & privacy

This plugin controls physical devices in your home, so it ships with guardrails:

• Kill switch confirmation. lutron_all_off turns off the entire home at once. By default it requires an interactive confirmation before it fires, and it is blocked in headless/automation contexts (where there is no UI to confirm) unless you explicitly opt in with allowUnattended. Prefer a scoped area over the whole house.
• Prompt-injection guardrails. Every state-changing tool tells the agent to act only on a direct request from you, and never on instructions buried in untrusted content (emails, web pages, documents, calendar invites).
• Occupancy is private. lutron_occupancy and lutron_export reveal whether people are home and the full layout of the house. The tools flag this to the agent as sensitive; results should not be forwarded to third parties or untrusted channels.
• No shell injection. The plugin invokes the lutron binary with an argv array (never a shell string), so device names and ids cannot inject shell metacharacters.

Tune the gating with the config keys below. For an extra-cautious setup, set confirmStateChanges: true to require a confirmation before every change, not just the kill switch.

Configuration

Key	Default	Description
cliPath	lutron	Path to the lutron binary
bridgeHost	(CLI config)	Bridge IP or hostname, overrides the lutron-cli saved config
confirmAllOff	true	Require an interactive confirmation before lutron_all_off fires
confirmStateChanges	false	Require confirmation before every state-changing tool, not just the kill switch
allowUnattended	false	Permit confirmation-gated actions to run when no interactive UI is available (trusted automation only)

Tips

• Prefer scenes over individual device control. One scene activation is faster than setting ten devices one by one (each call carries bridge connection overhead).
• Device and scene IDs are strings. Always pass them as strings.
• lutron_set_level is the single tool for on/off/dim. There is no separate on/off tool: level: 0 turns off, level: 100 is full on.

License

MIT (c) Omar Shahine