云柚

文档中心

自动化概览

最近更新: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 定位;结果里列出了候选元素

这些数字只用于自动化动作的结果,和网页、桌面端提示里的错误码不是同一套。