Integrating OpenClaw with Home Assistant can transform your home into a highly responsive smart environment. OpenClaw, a powerful automation solution, allows you to manage devices efficiently, while Home Assistant serves as a versatile hub to control all your smart devices under one roof. In this tutorial, we will walk through the process of setting up OpenClaw with Home Assistant, offering you a hands-on approach to building a cohesive smart home. ## Prerequisites Before we dive into the integration process, ensure you have the following: 1. **Home Assistant Installed**: Make sure you have Home Assistant set up on your device. You can install it on Raspberry Pi, a virtual machine, or a dedicated server. 2. **OpenClaw Installed**: You should have OpenClaw installed and operational. Follow the installation guide on the OpenClaw documentation if you haven't done this yet. 3. **Basic Knowledge of YAML**: Home Assistant configuration often requires editing YAML files, so familiarity with this format is beneficial. 4. **Network Access**: Ensure that both Home Assistant and OpenClaw can communicate over the same network. 5. **A Text Editor**: You will need a text editor like Visual Studio Code, Notepad++, or any code editor of your choice for editing configuration files. ## Step-by-Step Instructions ### 1. Setting Up OpenClaw First, ensure that OpenClaw is correctly configured and running. You can verify this by accessing its dashboard. 1. **Launch OpenClaw**: Open your web browser and navigate to the IP address where OpenClaw is hosted (e.g., `http://:`). 2. **Create Your Automations**: Set up your desired automations in OpenClaw. This could involve linking smart lights, thermostats, or any other IoT devices that OpenClaw supports. ### 2. Enable OpenClaw API To allow Home Assistant to communicate with OpenClaw, you'll need to enable its API. 1. **Log in to OpenClaw**: Access your OpenClaw dashboard. 2. **Navigate to Settings**: Find the section related to API settings. 3. **Enable API Access**: Toggle the API access option to "Enabled" and note down the API key/token. ### 3. Install the OpenClaw Integration in Home Assistant Now, let's integrate OpenClaw into Home Assistant. 1. **Access Home Assistant**: Open your Home Assistant dashboard. 2. **Go to Configuration**: Click on "Configuration" in the sidebar. 3. **Select Integrations**: Click on "Integrations" to view all available integrations. 4. **Add Integration**: Click on the "+" icon at the bottom right to add a new integration. 5. **Search for OpenClaw**: Type "OpenClaw" in the search bar and select it from the list. ### 4. Configure OpenClaw in Home Assistant 1. **Enter API Details**: You will be prompted to enter the API URL and the API key you noted earlier. The API URL should look like this: ``` http://:/api ``` Example configuration: ```yaml openclaw: api_url: "http://192.168.1.10:5000/api" api_key: "your_openclaw_api_key" ``` 2. **Save Configuration**: After entering the details, save the configuration. 3. **Restart Home Assistant**: Restart Home Assistant to apply the changes. You can do this from the Configuration tab or by restarting the service. ### 5. Create Entities in Home Assistant Once Home Assistant has restarted, it should discover the entities created in OpenClaw automatically. 1. **Check Entities**: Navigate to "Developer Tools" and click on the "States" tab to see the list of entities. Look for entities prefixed with `openclaw.`. 2. **Customize Entities**: If needed, customize these entities in your configuration.yaml file to better represent them in Home Assistant. ```yaml homeassistant: customize: sensor.openclaw_device_name: friendly_name: "Smart Light" icon: "mdi:lightbulb" ``` ### 6. Create Automations in Home Assistant With the integration complete, you can now create automations in Home Assistant using OpenClaw entities. 1. **Navigate to Automations**: Go to the "Automations" section in Home Assistant. 2. **Create a New Automation**: Click on “Add Automation” and select “Start with an empty automation”. 3. **Define Triggers**: Set up triggers based on the OpenClaw entities. For instance, you can trigger an automation when a door sensor is activated. Example automation YAML: ```yaml automation: - alias: "Turn on Light when Door Opens" trigger: platform: state entity_id: sensor.openclaw_door_sensor to: 'on' action: service: light.turn_on target: entity_id: light.openclaw_smart_light ``` ### 7. Testing the Integration 1. **Test the Automations**: Open the entities in your Home Assistant dashboard and manually trigger them to ensure they respond as expected. 2. **Check Logs**: If something doesn’t work, check the Home Assistant logs for errors. You can find logs under "Configuration" > "Logs". ### Troubleshooting Tips - **Connection Issues**: Ensure both OpenClaw and Home Assistant are on the same network and can ping each other. - **API Key Errors**: Double-check that you copied the API key correctly and that it hasn’t expired. - **Entities Not Showing**: If entities are not showing up, try restarting Home Assistant and ensuring OpenClaw is running without issues. ## Next Steps Now that you have successfully integrated OpenClaw with Home Assistant, here are some related topics to explore: - [Creating Custom Dashboards in Home Assistant](https://www.home-assistant.io/lovelace/) - [Advanced Automations with Home Assistant](https://www.home-assistant.io/docs/automation/) - [Using MQTT in Home Assistant](https://www.home-assistant.io/docs/mqtt/) - [Integrating More Devices with Home Assistant](https://www.home-assistant.io/integrations/) By following this tutorial, you’ve taken a significant step towards building a highly functional, automated smart home using OpenClaw and Home Assistant. Enjoy your new smart home experience!