自动化概览
最近更新:2026/11/13
云柚有几种自动化方式,适合不同的场景:
| 方式 | 适合做什么 | 在哪里用 |
|---|---|---|
| 桌面自动化任务 | 不写代码,手动或定时执行一组操作 | 只在桌面端 |
| 命令行工具 | 在终端或脚本里操作云手机,一次执行多步操作、运行流程宏 | 你的电脑 |
| MCP | 让 AI 助手用自然语言操作云手机 | 支持 MCP 的 AI 助手 |
桌面自动化任务
在桌面端侧栏的「自动化」里点「新建任务」。一个任务是一组动作,可以手动运行,也可以定时运行,定时按这台电脑的时间计算;定时运行时桌面端要开着,错过的不会补跑。也可以在查看器里录下操作步骤,生成任务里的动作。桌面端还提供本地 API,让这台电脑上的脚本、命令行和 AI 助手经桌面端操作设备,见本地 API 与桌面任务。
命令行工具与 MCP
命令行工具 yunyoo 用机器 token 登录后,可以选中云手机、读取屏幕、点按和输入、管理应用和文件、开关机、做备份,还能一次提交多步操作,把常用流程写成流程宏反复运行。它也能作为 MCP 服务运行,让 AI 助手接入,用的是同一套能力;AI 助手也可以直接连接远程地址,不用安装命令行。安装和用法见命令行工具和 MCP。
自己写的程序请经命令行或 MCP 调用:平台的自动化接口要求请求签名,签名方式目前不对外提供。接口清单见自动化接口参考。
需要确认的操作与运行记录
清除应用数据、卸载应用、执行命令,以及涉及付款、消息、账号等的高风险操作,可能需要你本人批准。自动化遇到这类操作时会停下等待,你会收到站内通知,桌面端(1.1.0 起)在窗口不在前台时还会弹出系统通知。在「自动化」的「确认与报告」里批准或拒绝,批准后这一步只执行一次;同一处的运行记录列出自动化执行过的每一步。
遇到付款、登录、验证码等需要本人处理的界面时,自动化可以请你接手。你也可以在查看器里接管设备,接管期间自动化的操作会被拒绝,点「交还」后恢复。
签发机器 token
在头像菜单的「账户设置」里打开「自动化」页,点「创建 token」,填写:
- 名称;
- 作用域:默认勾选观测、UI 动作、应用、文件、生命周期、备份六项;
- 云机范围:全部、某个分组或指定环境;
- 有效期:7、30、90、365 天或永不过期,默认 30 天。
token 以 wpa_ 开头,明文只显示一次,请马上保存。之后可以「轮换」,旧 token 在短暂的宽限期内仍然可用;也可以「吊销」,用它的脚本立即失效。
「命令执行」和「本地桥接」两项属于逃生舱,默认不授予:前者可以在云手机里执行任意命令,后者可以把你电脑上的端口桥接进云手机。勾选时会有警告,创建时还要再确认一次,使用会被审计。
token 的作用域不会超出你自己的权限。看不到「自动化」页或不能创建 token,说明你的角色没有「机器令牌」权限。
动作没做成时的结果码
用命令行或 AI 助手点按、输入、等待时,这一步没做成会返回一个结果码。命令行把它写在结果的 error_code 里,并以退出码 3 结束;AI 助手会收到一条带这个数字的错误。
| 结果码 | 含义 | 怎么办 |
|---|---|---|
| 1001 | 要操作的元素已经不在界面上 | 重新读取界面,用新的元素编号再试 |
| 1002 | 没有找到符合条件的元素 | 检查文字、描述或资源 ID 有没有写对,或先读取界面再定位 |
| 1003 | 等待超时 | 看看界面现在的状态再试;一次最长等 30 秒,需要更久就再等一次 |
| 1004 | 这台云手机不支持这个操作,例如不能输入中文 | 换一种做法;自动化状态里列出了它支持的能力 |
| 1005 | 输入没有成功 | 稍后再试 |
| 1007 | 云手机没有在运行,或正在开关机 | 等它运行起来再试 |
| 1008 | 同一个元素编号对应界面上的多个元素 | 改用文字、描述或资源 ID 定位;结果里列出了候选元素 |
这些数字只用于自动化动作的结果,和网页、桌面端提示里的错误码不是同一套。
