lofy-home

What This Skill Does

The lofy-home skill acts as a comprehensive bridge between the OpenClaw AI agent and your home automation setup via Home Assistant. By leveraging the Home Assistant REST API, this skill allows users to control lighting, media playback, climate, and hardware power states using natural language. It centralizes environment management through a structured configuration file (data/home-config.json), which maps intuitive labels (like "desk lamp" or "speaker") to specific Home Assistant entity IDs. Beyond simple device toggling, it supports complex scene activations, allowing you to synchronize lighting, music, and presence-based settings (such as Do Not Disturb) with a single command.

Installation

To integrate the lofy-home skill into your agent, execute the following installation command in your terminal:

clawhub install openclaw/skills/skills/harrey401/lofy-home

Once installed, you must define your environment variables, specifically HA_TOKEN for authentication, and ensure your data/home-config.json is configured with your correct Home Assistant URL and entity mappings. If an entity ID is missing or incorrect, the agent will prompt you to update the configuration file before execution.

Use Cases

• Workspace Optimization: Instantly shift your room to a "study" state with cool-tone lighting, focus music, and system-wide DND.
• Automated Living: Trigger "chill" or "morning" scenes based on time of day or occupancy status.
• PC Power Management: Wake your workstation remotely via Wake-on-LAN packets, bypassing the need to physically interact with hardware.
• Adaptive Comfort: Quickly adjust ambient conditions, such as turning off lights before bed or bumping the thermostat when the temperature feels low.

Example Prompts

1. "It is time to grind, activate study mode for me."
2. "I'm heading out for the day, please turn off all the lights and switch to eco mode."
3. "My computer is off, can you send the wake packet to my PC?"

Tips & Limitations

• Safety First: The agent will never execute a "turn off all" command without seeking your explicit confirmation to prevent accidental power-downs.
• API Connectivity: Ensure your home-config.json points to a reachable URL. If the agent reports an unreachable server, verify your network settings and confirm the Home Assistant API is accessible.
• Customization: Keep your data/home-config.json synced; the skill relies entirely on these mappings to translate human speech into actionable API calls.