OpenClaw Integration for Home Assistant

A native Home Assistant integration for communicating with the OpenClaw Assistant addon.

Features

Chat card — Lovelace card with streaming AI responses, file attachments, and voice mode
Sensors — openclaw_status, openclaw_model, openclaw_session_count, openclaw_last_activity, openclaw_connected
Conversation agent — appears in Assist & Voice PE as a native agent
Service calls — openclaw.send_message for automations
Events — openclaw_message_received for triggering automations from AI responses
Zero-config — auto-discovers the addon via Supervisor API, no tokens or URLs to enter

Installation

HACS (recommended)

Open HACS → Integrations → + Explore & Download Repositories
Search for OpenClaw and install
Restart Home Assistant
Go to Settings → Devices & Services → Add Integration → OpenClaw

Manual

Copy custom_components/openclaw/ into your HA config/custom_components/ directory
Copy www/openclaw-chat-card.js into config/www/
Restart Home Assistant
Add the integration via Settings → Devices & Services

Prerequisites

The OpenClaw Assistant addon must be installed and running.
The integration will auto-detect it — no manual configuration needed.

Chat Card

Add the card to any dashboard:

type: custom:openclaw-chat-card

Services

`openclaw.send_message`

Send a message to OpenClaw from an automation or script.

service: openclaw.send_message
data:
  message: "What's the weather like today?"
  session_id: "optional-session-id"

`openclaw.clear_history`

service: openclaw.clear_history
data:
  session_id: "optional-session-id"

Events

`openclaw_message_received`

Fired whenever OpenClaw sends a response. Use in automations:

trigger:
  - platform: event
    event_type: openclaw_message_received
action:
  - service: notify.mobile_app
    data:
      message: "{{ trigger.event.data.message }}"

License

See LICENSE.

2.1 KiB Raw Blame History