OpenClaw + Philips Hue

Prerequisites

• OpenClaw running (see our deployment guide)
• Philips Hue Bridge (v1 or v2)
• At least one Hue light or device
• Bridge connected to your local network

Step 1: Find Your Bridge IP

1. Open the Hue app on your phone
2. Go to Settings → Hue Bridges
3. Tap the "i" icon next to your bridge
4. Note the IP address

Or use discovery:

# From a machine on the same network
curl -s https://discovery.meethue.com/

Step 2: Create a User (Press Button Method)

1. Press the button on your Hue Bridge
2. Within 30 seconds, make this API call:

curl -X POST "http://BRIDGE_IP/api" -d '{"devicetype":"openclaw#assistant"}'

1. You'll receive a username (API key):

[{"success":{"username": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"}}]

1. Save this username — it's your API key

Configuration

Add the Philips Hue integration to your OpenClaw config:

# In your openclaw config
integrations:
  hue:
    enabled: true
    bridge_ip: "192.168.1.100"  # Your bridge IP
    username: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Or via environment variables in your docker-compose.yml:

environment:
  - HUE_ENABLED=true
  - HUE_BRIDGE_IP=192.168.1.100
  - HUE_USERNAME=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Step 3: Test the Connection

Verify your setup works:

# List all lights
curl "http://BRIDGE_IP/api/USERNAME/lights"

# Turn on a light
curl -X PUT "http://BRIDGE_IP/api/USERNAME/lights/1/state" -d '{"on":true}'

Verification

Try asking OpenClaw to control your lights:

"Turn on the living room lights"
"Set bedroom to 50% brightness"
"Dim the kitchen lights"
"Turn all lights off"
"Set the mood scene"

Check logs for API calls:

docker compose logs -f openclaw | grep -i hue

Common Issues

Link button not pressed: The bridge button must be pressed within 30 seconds of creating a new user. If you get "link button not pressed", try again.

Bridge not found: Ensure OpenClaw and the bridge are on the same network. For Docker, use --network host or proper port forwarding.

Unauthorized user: If your username was revoked, press the bridge button and create a new user.

Lights not responding: Check that lights are powered on and connected to the bridge. Restart the bridge if needed.