/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.
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install ecovacs-skills-deebot-control - 安装完成后，直接呼叫该 Skill 的名称或使用
/ecovacs-skills-deebot-control触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 48 次。
如何安装 ecovacs-skills-deebot-control？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install ecovacs-skills-deebot-control」即可一键安装，无需额外配置。
ecovacs-skills-deebot-control 是免费的吗？
是的，ecovacs-skills-deebot-control 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
ecovacs-skills-deebot-control 支持哪些平台？
ecovacs-skills-deebot-control 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 ecovacs-skills-deebot-control？
由 ecovacs（@ecovacs-ai）开发并维护，当前版本 v1.0.0。