moltbot-ha

What This Skill Does

The moltbot-ha skill provides a robust interface between the OpenClaw AI agent and your Home Assistant environment. By leveraging the moltbot-ha CLI, the agent can discover, query, and manipulate your smart home devices directly. Whether you need to adjust lighting ambiance, trigger complex automation scripts, monitor sensor data, or secure your home, this skill transforms your CLI into a command center for your entire domestic IoT infrastructure. It supports granular attribute controls and direct service calls to native Home Assistant entities.

Installation

To integrate this skill with your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/iamvaleriofantozzi/moltbot-ha

Ensure you have completed the underlying tool setup by installing the CLI via uv tool install moltbot-ha and configuring your HA_TOKEN environment variable. Initializing the configuration via moltbot-ha config init is mandatory to establish the secure connection to your Home Assistant instance URL.

Use Cases

This skill is ideal for users who want to bridge AI reasoning with real-world physical actions. Common use cases include:

• Adaptive Environment Control: Automatically dimming lights and adjusting color temperature based on the time of day or activity.
• Complex Automations: Triggering multi-device scripts such as "Movie Night" or "Good Morning" routines.
• Security Management: Monitoring sensor states like window contacts or temperature and securely managing locks.
• Diagnostics: Quickly checking the state of unresponsive smart devices or sensors without navigating the web UI.

Example Prompts

1. "Hey OpenClaw, please set the living room lights to 70% brightness and a warm color temperature."
2. "Check if any windows or doors are currently left open, specifically looking at the sensors."
3. "Run the 'Leaving Home' script and make sure the garage door is closed behind me."

Tips & Limitations

• Safety First: The skill features a built-in 3-level safety system. Critical operations like operating garage doors or locks will trigger an explicit confirmation prompt. Always provide explicit consent when the agent detects a critical operation.
• Environment Variables: Ensure HA_TOKEN is persistantly exported in your shell profile to avoid connectivity issues during automated tasks.
• Data Precision: When using moltbot-ha set or moltbot-ha call, ensure the entity IDs are accurate, as these commands interact directly with your Home Assistant state machine.