剪贴板

剪贴板 用于读取或写入剪贴板内容。写入时把指定文本放入剪贴板，读取时把剪贴板当前内容保存到变量，常配合网页里的复制、粘贴操作使用。

指令标识：Clipboard
指令类型：网页指令
指令描述：读取或写入剪贴板内容

先选使用方式

工作流支持「可视化编排」和「代码编排」两种创建方式。剪贴板 在两种方式里都能用，核心业务参数一致，区别主要是你通过界面配置，还是通过 Python 脚本配置。

方式	怎么用	适合人群
可视化编排（推荐先学）	拖入「剪贴板」节点，选择读取或写入，填写文本和输出变量	大多数用户，零代码，适合快速搭建和调试
代码编排（Python）	在脚本中调用 `bots.webClipboard(action="SET", text="...")`	熟悉代码、需要复用脚本或批量生成流程的用户

第一次使用建议先用可视化编排跑通，再迁移到 Python 代码编排。下方「参数说明」同时给出界面字段和代码参数名，方便两种方式对应。

说明：本指令在引擎中的注册标识为 WebClipboard，因此 Python 代码编排中的方法名为 bots.webClipboard(...)。

什么时候用？

需要把流程中的内容写入剪贴板，再在页面里粘贴。
页面有「复制」按钮，复制后需要把剪贴板内容读出来保存。
在多个步骤间通过剪贴板传递文本。

使用前确认

当前已经有打开的页面（剪贴板操作依赖页面环境）。
写入时确认要放入剪贴板的文本；读取时确认页面已经把内容复制到剪贴板。
读取剪贴板要求页面处于前台焦点，本指令会自动把页面置前。

可视化编排：从 0 到跑通

下面用一个常见场景演示：点击页面复制按钮后，把剪贴板内容读出来保存。

确认页面已经打开并加载完成。
用点击元素点击页面上的「复制」按钮。
添加 剪贴板 节点，操作选择 GET（获取剪贴板内容）。
在 将结果保存至 填写变量名，例如 copied_text。
运行后查看变量值是否就是页面复制的内容。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
操作	`action`	Enum	是	-	剪贴板操作类型，可选值：`GET`(获取剪贴板内容)、`SET`(设置剪贴板内容)，不能为空。
输入内容	`text`	String	否	-	设置剪贴板内容（`SET`）时要写入的文本；获取（`GET`）操作时可为空。

输出参数

界面名称	代码属性名	类型	必填	说明
将结果保存至	`outKey`	String	否	读取时保存剪贴板当前内容；写入时保存本次写入的文本。

成功标准

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

失败排查

现象 / 报错原文	可能原因	处理建议
读取剪贴板报权限错误（NotAllowedError）	页面未处于焦点或浏览器未授予剪贴板权限	本指令会自动把页面置前；如仍失败，确认执行环境允许剪贴板访问
读出来是空的	页面还没把内容复制到剪贴板	先执行页面的复制操作，再读取剪贴板
写入后页面粘贴没反应	页面粘贴动作未触发	写入后用相应粘贴操作或快捷键触发页面读取剪贴板

Python 代码编排

代码编排以 Python 为主。运行上下文由代码编排模板创建，示例里只需要关注业务指令本身。

# 写入剪贴板（SET）
bots.webClipboard(action="SET", text="要粘贴的内容")

# 读取剪贴板（GET），返回值即剪贴板内容
copied = bots.webClipboard(action="GET", outKey="copied_text")
print(copied)

如果你想在工作流中通过节点动态编排指令，可使用执行指令（XML）节点。

常见问题

Q1：读取剪贴板为什么有时会报权限错误？

A：浏览器要求页面处于前台焦点才能读剪贴板。本指令会自动把页面置前；如果仍报错，请确认执行环境允许剪贴板读写。

Q2：写入和读取怎么选？

A：把内容放进剪贴板选 SET（设置剪贴板内容）并填「输入内容」；把剪贴板内容取出来选 GET（获取剪贴板内容）并填「将结果保存至」。

剪贴板