vmos-edge-control-api
Installation
SKILL.md
VMOS Edge Android Control
在需要通过 VMOS Edge Android Control API 控制单台安卓云机时使用这个 skill。MCP 是可选通道,不是前置依赖。
连接入口
- 如果用户已经明确给了
host_ip或cloud_ip,优先使用用户给的值 - 如果用户没有明确给 IP,先检查本地是否存在
cbs_go进程;存在则默认host_ip=127.0.0.1 - 如果用户没有明确给 IP,且本地没有
cbs_go,引导用户提供host_ip、cloud_ip,或在已知宿主机场景下提供db_id - 如果当前会话里同时安装了
vmos-edge-container-api:- 使用宿主机路由
http://{host_ip}:18182/android_api/v2/{db_id} - 必须先通过 container API 的
POST /container_api/v1/get_db或GET /container_api/v1/get_android_detail/{db_id}拿到目标db_id
- 使用宿主机路由
- 如果当前只有
vmos-edge-control-api:- 默认优先使用云机直连
http://{cloud_ip}:18185/api - 仅支持开启了局域网模式的云机
- 默认优先使用云机直连
- 如果当前只有
vmos-edge-control-api,而当前路径要走host_ip:- 如果用户已经给了
db_id,直接使用http://{host_ip}:18182/android_api/v2/{db_id} - 如果没有
db_id,明确说明还缺少db_id或vmos-edge-container-api
- 如果用户已经给了
- 如果直连
http://{cloud_ip}:18185/api/base/version_info连不上、超时,或返回5xx,明确说明当前云机没有暴露 Control API,或没有开启局域网模式
Related skills
More from vmos-dev/vmos-edge-skills
operate-vmos-edge-cli
Use when a task involves VMOS Edge Desktop — creating or controlling Android virtual devices on edge hosts, interacting with the Electron desktop UI via CDP, automating device workflows with YAML playbooks or batch JSON, or recovering from CLI error codes.
9vmos-edge-container-api
Use this skill when managing VMOS Edge cloud phone containers through the Container API via the host machine IP (`host_ip`). Covers host queries, instance lifecycle, db_id/cloud_ip lookup, batch operations, app distribution, and async polling. If no IP is provided and local `cbs_go` is running, default `host_ip` to `127.0.0.1`. Use it to resolve `db_id` when `vmos-edge-control-api` needs host_ip-based routing.
8