aqara-agent
aqara-agent is an official Aqara Home AI Agent skill. It supports natural-language home and space management, device inquiry, device control, device configuration (firmware/OTA upgrade only - not supported: rename devices, move devices between rooms or positions, or other device record edits outside firmware), device logs, scene management (query, execute, create, snapshot, and logs), automation management (create, query, detail, toggle, and logs), and energy / electricity-cost statistics (by device, room, or home). Examples: "How many lights are at home?", "Switch to my other home.", "Turn off the living room AC.", "What are the temperature and humidity in the bedroom?", "Upgrade the bedroom camera firmware.", "Upgrade firmware for the hub.", "Show device logs for this device.", "Run the Movie scene.", "Recommend a bedtime setup for the bedroom.", "Create a good-night scene in the bedroom.", "Capture a scene snapshot of how things are now.", "Which scenes use the kitchen lights?", "When it is sunset in Haidian District, Beijing, turn off the security alarm.", "Create an automation to turn off the bedroom lights every day at 10:30pm.", "Five minutes after the living room motion sensor detects someone, turn on the hallway lights.", "At 7am on weekdays, run the Good Morning scene.", "If outdoor temperature drops below 5 degrees C, send me a notification.", "What automations do I have?", "Turn off the morning routine automation.", "What triggers the Leave Home automation?", "What was last month's electricity bill at home?", "How much power did the bedroom use this week?", "Check automation execution in the bedroom for the last three days.", "Show scene run history for the Movie scene."
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/aqara/aqara-agentAqara Smart Home AI Agent Skill
Basics
aqara_open_api.py CLI
- Invocation:
python3 scripts/aqara_open_api.py <method_name> [json_body]. - Must: first argument equals the exact public method name on
AqaraOpenAPI(see bash examples inreferences/*.md). Forbidden: aliases or shortened names unless a reference documents an equivalent. - Dispatch:
get_*-> no JSON body;post_*-> JSON object (optional, default{}). - Energy:
post_energy_consumption_statistic- route fromdevice_idsonly (non-empty -> device API; else position). Fields and NL mapping:references/energy-statistic.md. - Methods (ground list):
get_homes,get_rooms,get_home_devices,get_home_scenes,get_home_automations,post_current_outdoor_weather,post_device_base_info,post_device_status,post_device_control,post_device_firmware_query,post_device_firmware_upgrade,post_device_log,post_execute_scene,post_scene_detail_query,post_create_scene,post_scene_snapshot,post_scene_execution_log,post_device_related_automation_query,post_automation_execution_log,post_automation_switch,post_create_automation,post_energy_consumption_statistic. Forbidden call names not present onAqaraOpenAPIunless a reference adds them. post_create_automationandraw_config(non-negotiable): Every call Must send non-emptyraw_configin the HTTP body (automation-create.md). Forbidden to send onlyauxiliary_configor only root-level supplementalconditions/actionswithout non-emptyraw_config.post_create_automationfirst round vs follow-up: First call: non-emptyraw_configonly;auxiliary_configMust be empty (omit the argument or pass{}). If the response needs config-list matching, useLLMConfigReferenceas the only source for Step 03 ->auxiliary_config(step-03-parse-config-prompt.md). Second and later calls: Must resend the same non-emptyraw_configand attachauxiliary_config(Step 3 supplement).scripts/aqara_open_api.pyshallow-mergesraw_configandauxiliary_configinto one JSON when both are passed.- Optional env:
AQARA_OPEN_HTTP_TIMEOUT(default 60),AQARA_OPEN_API_URL(overrides disk). Optional disk:assets/user_account.jsonkeysaqara_open_api_urloropen_api_url(full base, no trailing slash required) when env is unset — requests use{base}/{path}(e.g.homes/query).
Skill Package Layout
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-aqara-aqara-agent": {
"enabled": true,
"auto_update": true
}
}
}