/install ecovacs-skills-deebot-control
Ecovacs Deebot control
What you need
| Input | Notes |
|---|---|
| AK (Access Key) | Create or view it in the Ecovacs Open Platform “Service overview” (China: https://open.ecovacs.cn/, Global: https://open.ecovacs.com/), then copy it into env vars, a config file, or chat yourself. Pick the portal region that matches your account. Do not hand account passwords to automation; this skill does not log in on your behalf. |
| Gateway base URL (optional) | Defaults to the same host as the Open Platform (China https://open.ecovacs.cn, Global https://open.ecovacs.com). Override with ECOVACS_PORTAL_URL for a self-hosted or local gateway (e.g. mcp_portal_services). |
| Device nickname fragment | Used to pick one robot. Take a substring of nick or name from the device list (fuzzy match). |
If the AK is invalid (e.g. errno 3000), refresh it on the Open Platform—do not try to replace user login with other APIs.
Three steps
- Configure AK → 2. Device list → 3. Send commands
1. Configure AK (pick one)
export ECOVACS_AK="YOUR_AK"
# or: python3 scripts/ecovacs.py set-ak \x3Cak>
# writes ~/.ecovacs_session.json with {"ak":"..."} only
2. Device list
python3 scripts/ecovacs.py devices
Note the nick / name fragment you will use as \x3Cnick> below.
3. Common CLI operations
Let SCRIPT=scripts/ecovacs.py.
Queries
- Battery:
python3 "$SCRIPT" battery \x3Cnick> - Work state (clean / charge / station):
python3 "$SCRIPT" status \x3Cnick>
Cleaning
- Whole-home auto clean:
python3 "$SCRIPT" clean \x3Cnick> start - Pause / resume / stop:
python3 "$SCRIPT" clean \x3Cnick> pauseorresume/stop
Charging
- Go charge / stop go-charge:
python3 "$SCRIPT" charge \x3Cnick> goorstop
HTTP gateway (no Python)
BASE_URL is the same as ECOVACS_PORTAL_URL (defaults to the regional Open Platform host).
Device list
curl -sS "${BASE_URL}/robot/skill/deviceList?ak=YOUR_AK"
Control: POST /robot/skill/ctl with JSON ak, optional nickName (fuzzy match on list), and ctl.cmd / ctl.data.
curl -sS -X POST "${BASE_URL}/robot/skill/ctl" -H 'Content-Type: application/json' \
-d "{\"ak\":\"${AK}\",\"nickName\":\"nick-fragment\",\"ctl\":{\"cmd\":\"Charge\",\"data\":{\"act\":\"go\"}}}"
CloudCtl expects Charge, Clean, etc. with official casing—not lowercase charge.
More JSON examples (e.g. zone clean) are in references/api.md.
Errors and enums (troubleshooting)
Responses are usually two layers: outer msg / code; inner cloudctl payload under nested ctl.data with ret (ok/fail), errno, optional error.
| Situation | Meaning / next step |
|---|---|
| Appendix F 5009 | Command or parameter combo not supported on this model (casing, firmware); verify model, try GetWorkState / GetBatteryInfo naming |
| Appendix F 10004 | Offline / timeout / powered off / re-provisioned |
| Appendix F 10000 | Low battery, cannot run |
| Appendix F 10005 | Host fault (lifted, dustbin missing, …) |
| Clean 10006 / Charge 10006 | Internal host fault (appendix C/D) |
| Appendix F 4000 | Malformed JSON |
| Appendix F 4504 | Token check failed—verify AK |
ret=fail |
Read errno and error together |
Water level: In sweep-only mode (no mopping / tank inactive), SetWaterInfo often fails (ret=fail); switch to a mopping-capable mode first.
Clean enums: act = s/p/r/h; workMode 0–3; zone clean uses type=spotarea + aid from GetAreaList mssid. Charge: go / stopGo.
Full tables: see “CloudCtl errors and enums” at the end of references/api.md.
How to read the docs
| File | Audience | Contents |
|---|---|---|
| This SKILL.md | End users | Inputs, three steps, CLI, HTTP |
| references/api.md | Integrators | Paths, bodies, enums, curl |
| references/agent-internal.md | Internal | Smart clean, rooms, polling, GetWorkState heuristics |
Prefer this page for user-facing guidance; use references/agent-internal.md only when you need implementation-level troubleshooting.
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install ecovacs-skills-deebot-control - After installation, invoke the skill by name or use
/ecovacs-skills-deebot-control - Provide required inputs per the skill's parameter spec and get structured output
What is ecovacs-skills-deebot-control?
Control Ecovacs Deebot vacuums via the IoT API and a gateway. Users must obtain and provide an AK from the Open Platform; scripts/ecovacs.py and gateway /rob... It is an AI Agent Skill for Claude Code / OpenClaw, with 48 downloads so far.
How do I install ecovacs-skills-deebot-control?
Run "/install ecovacs-skills-deebot-control" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is ecovacs-skills-deebot-control free?
Yes, ecovacs-skills-deebot-control is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does ecovacs-skills-deebot-control support?
ecovacs-skills-deebot-control is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created ecovacs-skills-deebot-control?
It is built and maintained by ecovacs (@ecovacs-ai); the current version is v1.0.0.