aqara-open-api
Query and control Aqara/Lumi Studio smart home devices and manage spaces via the Aqara Open Platform API (HTTP JSON). Use when the user asks to list Aqara devices, get device status, control lights/switches/sensors, or manage rooms/spaces. Requires AQARA_OPEN_API_TOKEN and AQARA_ENDPOINT_URL.
Best for Smart home automationWorks with GitHubLow risk
⌘source
- author
@LeoYeAI- language
- Python
★2kstars
306forks
May 6, 2026
✦overview.md
Key Features
- ·Query and control Aqara/Lumi Studio smart home devices
- ·Manage spaces and device assignments
- ·Device discovery and state queries from cache
- ·Uses curl for HTTP requests
- ·Requires AQARAENDPOINTURL and AQARAOPENAPITOKEN
Use Cases
- →List all Aqara devices and get their current status
- →Control lights, switches, or sensors via the API
- →Create, update, or assign devices to rooms/spaces
- →Refresh device cache for up-to-date state
Best for
- ✓Smart home automation
- ✓Device fleet management
Not ideal for
- !One-off script environments
- !Non-Aqara ecosystems
FAQs
name
aqara-open-api
description
Query and control Aqara/Lumi Studio smart home devices and manage spaces via the Aqara Open Platform API (HTTP JSON). Use when the user asks to list Aqara devices, get device status, control lights/switches/sensors, or manage rooms/spaces. Requires AQARA_OPEN_API_TOKEN and AQARA_ENDPOINT_URL.
version:1.0.1
author:aqara
homepage:https://opendoc.aqara.com
metadata:{"clawdbot":{"emoji":"🏠","requires":{"bins":["jq","curl"],"env":["AQARA_ENDPOINT_URL","AQARA_OPEN_API_TOKEN"]}}}
Aqara Open API Skill
This skill equips the agent to operate Aqara/Lumi Studio smart home devices via HTTPS requests to the Aqara Open Platform API. All operations are performed exclusively through curl commands, except GetAllDevicesWithSpaceRequest, which must be executed through bash scripts/fetch_all_devices.sh to refresh the local cache file data/devices.json.
This skill supports only:
- device discovery and device type lookup
- device state queries from cache
- device control
- space listing, creation, update, and device assignment
Configuration
The following environment variables are required:
AQARA_ENDPOINT_URL: The base URLAQARA_OPEN_API_TOKEN: Your Long-Lived Access Token.
AI Quick Navigation (Read This First)
This section is a navigation and execution summary only. It does not add new rules or change existing constraints.
What This Skill Can Do
- Device discovery: load all devices, space mappings, endpoints, functions, traits, and current values
- Device type catalog: query all device types in the project with code and display name
$install
1-click copynpx skills add LeoYeAI/openclaw-master-skills --skill aqara-open-apiSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
4/ 5
very goodClear and well structured, with only minor parts that might need a second read.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
4/ 5
highMostly actionable with clear steps; only a few small gaps remain.