A comprehensive tool for managing SONOFF and eWeLink devices across cloud, LAN, and DIY modes with built-in safety gates.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install sonoff
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install sonoff using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Sonoff?
The Sonoff skill enables developers to integrate and automate SONOFF hardware within the ecosystem of Openclaw Skills. It supports multiple control planes, including eWeLink cloud APIs, local LAN control, and DIY mode RPC-like calls. By utilizing this skill, you can ensure safe, multi-device execution through structured memory management and validated recovery playbooks, making it an essential addition to your collection of Openclaw Skills.
This skill is designed for precision and reliability, moving beyond generic smart-home advice by focusing on SONOFF-specific protocols. It manages local environments and device registries to provide a robust interface for both simple power toggles and complex, staged automation logic.
Sonoff Use Cases
- Automating SONOFF device state transitions via eWeLink cloud APIs.
- Executing local LAN control commands for low-latency device interaction.
- Implementing DIY mode workflows for devices supporting REST API protocols.
- Managing complex, staged multi-device automation rollouts with explicit safety checks.
- Troubleshooting device connectivity and firmware-specific capability mismatches using local incident logs.
How Sonoff Works
- The skill identifies the optimal control plane (Cloud, LAN, DIY, or iHost) based on the target device and environment settings.
- It validates device capabilities and firmware eligibility before generating any command payloads to prevent invalid requests.
- A discovery phase captures current device state and metadata to ensure high-fidelity interaction.
- The skill performs a mandatory read-before-write check to establish a reliable baseline state.
- Command execution is followed by a read-after-write verification loop to confirm the desired state was reached.
- All operations, configurations, and incident signatures are logged locally in the ~/sonoff/ directory for audit and recovery.
Sonoff Setup
To begin using this entry in the Openclaw Skills library, ensure you have the necessary system dependencies and environment variables configured.
# Ensure curl and jq are available on your system
sudo apt install curl jq
# Set your eWeLink API token for cloud operations
export EWELINK_API_TOKEN="your_token_here"
Before first use, review the setup.md file within the skill directory to align activation boundaries and configure write-safety defaults.
Sonoff Data Schema & Taxonomy
The skill maintains a structured local workspace within ~/sonoff/ to track device state and history. This organization is a core feature of high-quality Openclaw Skills.
| File | Description |
|---|---|
memory.md |
Core context, activation boundaries, and current workspace status. |
environments.md |
Mapping of LAN segments, iHost endpoints, and cloud mode settings. |
devices.md |
A registry of discovered devices, their specific capabilities, and command patterns. |
automations.md |
Defined orchestration rules, scheduling logic, and rollback plans. |
incidents.md |
Documentation of failure signatures and validated recovery steps. |
Sonoff Advanced Features
- Multi-mode support for Cloud, LAN, DIY, and iHost local API integration.
- Explicit safety gates for high-impact actions like power relays, heating circuits, or security locks.
- Idempotent automation design using deterministic run IDs and bounded retry logic.
- Automatic state reconciliation between cloud and LAN views to prevent conflicting state transitions.
- Seamless integration with other Openclaw Skills like
iotandmqttfor comprehensive home server orchestration.
SKILL.md
Loading
Related Openclaw Skills
Songwriting Assistant
A structured AI songwriting framework for generating lyrics, chord progressions, and optimized prompts for AI music tools.
Solidity
A specialized technical skill for AI agents focused on writing secure, gas-efficient, and audited Solidity smart contracts.
Solana
A technical toolkit for AI agents to interact with the Solana blockchain, handling everything from transaction lifecycles to token account management.
Software Engineer
A high-performance coding skill that writes, reviews, and refactors production-ready code using clean architecture and pragmatic trade-offs.
Spanish Naturalizer
A specialized skill designed to transform stiff, robotic AI-generated Spanish into warm, authentic, and human-like conversation.
Speech to Text Transcription
A versatile AI agent skill for transcribing audio and video files into structured text with support for multiple providers and local processing.
Featured*
