获取剪贴板内容（Android）

获取剪贴板内容（Android） 用于读取安卓设备当前剪贴板中的文本内容。它常用于读取被复制的验证码、分享口令、链接等信息，并保存到输出变量供后续步骤使用。该指令为业务工作流节点，推荐通过可视化编排使用。

指令标识：MobileGetClipboard
指令类型：手机指令
指令描述：安卓端获取剪贴板内容

先选使用方式

该指令是一个业务工作流节点，主要通过可视化编排使用。它在画布中以节点形式提供，配置直观，无需编写代码。

方式	怎么用	适合人群
可视化编排（推荐）	拖入「获取剪贴板内容（Android）」节点，配置「将结果保存至」	所有用户，零代码，推荐使用此方式
代码编排（Python）	该指令为业务工作流节点，推荐通过可视化编排使用，不提供独立的 Python 方法	—

建议直接在可视化编排中使用本节点。下方「参数说明」给出界面字段，方便配置。

什么时候用？

应用把验证码、口令、链接等内容复制到了剪贴板，需要读取后继续使用。
流程中需要把上一步复制的内容传递给下一步（如填入输入框）。
仅在 Android 设备上读取剪贴板内容的场景。

使用前确认

当前流程已经连接并占用了一台可用的 Android 设备。
目标内容已经被复制到剪贴板（例如点击了「复制」按钮）。
已规划好用于保存结果的输出变量名，便于后续节点引用。

可视化编排：从 0 到跑通

下面用一个常见场景演示：读取被复制的验证码并填入输入框。按 4 步即可跑起来：

在工作流画布中添加 获取剪贴板内容（Android） 节点，放在复制操作之后。
在右侧配置面板的 将结果保存至 中填写一个变量名，例如 clipboardText。
点击运行，确认输出变量中拿到了剪贴板文本。
在后续输入文本节点中引用该变量（如 ${clipboardText}），把内容填入目标输入框。

【图片占位 | command-mobilegetclipboard-config】
截图内容建议： 截一张可视化编排页面，画布选中「获取剪贴板内容（Android）」节点，右侧属性面板展示「将结果保存至」输入框。
标注建议： 用 ① 标出画布中的节点，用 ② 标出「将结果保存至」输入框，用 ③ 标出运行后查看变量内容的入口。
用户看完应能明白： 这个节点不需要输入参数，核心是配置一个输出变量来接收剪贴板文本。

参数说明

输入参数

该节点无业务输入参数，仅依赖已连接的 Android 设备上下文。

输出参数

界面名称	代码属性名	类型	必填	说明
将结果保存至	`outKey`	String	否	保存读取到的剪贴板文本内容。后续节点通过该变量名引用结果。

成功标准

获取剪贴板内容（Android） 节点运行结束后状态为成功。
运行日志中没有参数缺失、超时或执行失败等错误。
如果配置了输出变量，后续节点能够读取到符合预期的结果。
后续节点能够继续执行，流程没有因为该节点异常中断。

失败排查

现象 / 报错原文	可能原因	处理建议
流程未连接设备相关报错	流程未连接设备	先执行连接/占用设备节点，或在全局变量中配置设备上下文
读取到的内容为空	剪贴板本身为空	确认在读取前已经执行了复制操作，使目标内容进入剪贴板
iOS 设备读取失败	该节点面向 Android	该节点用于 Android 端剪贴板读取，iOS 场景请改用其他方案
输出变量为空	未配置「将结果保存至」	检查是否填写了输出变量，并确认后续引用的变量名一致

Python 代码编排

该指令为业务工作流节点，推荐通过可视化编排使用。运行上下文由代码编排模板创建，但本节点不提供独立的 Python 方法，请在画布中以节点形式使用。

如果你的流程整体采用代码编排，可在脚本中通过运行子工作流的方式复用包含本节点的工作流，把剪贴板读取逻辑封装在可视化工作流中，再由主流程调用。

常见问题

Q1：为什么没有 Python 示例？

A：该指令是业务工作流节点，而非标准引擎指令，因此不提供独立的 Python 方法。推荐在可视化编排中以节点形式使用。

Q2：iOS 设备可以用吗？

A：该节点面向 Android 端剪贴板读取。iOS 场景请结合具体应用能力另行处理。

Q3：读取到内容后怎么用？

A：把结果保存到输出变量后，在后续节点中用变量引用（如 ${clipboardText}）即可，例如填入输入文本。