Overview

Bridges OpenClaw with your n8n instance to automate Home Assistant workflows. By sending a POST to a n8n webhook, it routes user prompts into state checks, actions, historical data, or calendar information.

How This Skill Works

Sends a JSON POST to the n8n webhook endpoint containing chatInput, a requestType (state, action, historical, calendar), and a sessionId. The skill determines the appropriate requestType from the user's prompt and triggers the corresponding n8n workflow via curl at the designated webhook URL.

When to Use It

• Query the current state of a device (e.g., 'is the air conditioner running?')
• Change a device state or trigger an action (e.g., 'turn off the office light')
• Ask for IoT data from the past (e.g., 'when was the front door last opened?')
• Ask about calendar or scheduling information (e.g., 'when is my next meeting?')
• Route a user prompt into a Home Assistant automation workflow via the n8n webhook for IoT-related tasks

Quick Start

1. Step 1: Determine the nature of a user's prompt (state, action, historical, calendar)
2. Step 2: POST to the n8n webhook: http://localhost:5678/webhook/05f3f217-08b9-42de-a84a-e13f135bde73 with {"chatInput": "...", "requestType": "...", "sessionId": "openclaw"}
3. Step 3: Verify the n8n workflow runs and returns results

Best Practices

• Use clear, concise chatInput phrases that map to your device or scene
• Always map prompts to the correct requestType: state, action, historical, or calendar
• Keep sessionId as 'openclaw' to maintain context across requests
• Run and test the n8n webhook locally (n8n should listen on port 5678) and verify the webhook URL
• Send requests with Content-Type: application/json and use the exact webhook URL

Example Use Cases

• Action: turn off the office light (requestType: action) with chatInput: 'turn off the office light'
• Action: change the downstairs thermostat to 72 (requestType: action) with chatInput: 'change the downstairs thermostat to 72'
• Historical: when was the front door last opened? (requestType: historical) with chatInput: 'when was the front door last opened?'
• State: is the air conditioner running? (requestType: state) with chatInput: 'is the air conditioner running?'
• Calendar: when is my next meeting? (requestType: calendar) with chatInput: 'when is my next meeting?'

Frequently Asked Questions