剪贴板传输失败因默认载荷限制，需四步配置：一、修改客户端config.json中"maxPayloadSizeKB"值；二、在设置中启用Claw分块传输并设分块大小；三、于IM管理台配置指令长度校验与超限拦截；四、在华为云Stack协议策略中调高剪切板最大传输量。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用WorkBuddy进行远程控制时发现剪贴板传输大文件或大量文本失败、卡顿或被截断，则可能是由于剪贴板重定向机制默认限制了数据载荷大小。以下是配置剪贴板容量策略的具体方法：
一、调整WorkBuddy客户端剪贴板缓冲区上限
该方法直接修改WorkBuddy桌面客户端本地运行时的剪贴板内存分配阈值，适用于Windows/macOS平台，可提升单次复制内容的最大字节数。
1、关闭正在运行的WorkBuddy客户端，确保无后台进程残留。
2、定位客户端配置目录：Windows路径为%APPDATA%\WorkBuddy\config.json；macOS路径为~/Library/Application Support/WorkBuddy/config.json。
3、用文本编辑器打开config.json，查找键名为"clipboard"的对象；若不存在，则在根对象内新增该字段。
4、在"clipboard"对象中添加或修改"maxPayloadSizeKB"字段，设置为整数值，例如："maxPayloadSizeKB": 5120（即5MB）。
5、保存文件，重启WorkBuddy客户端，新配置立即生效。
二、通过Claw协议层启用分块传输模式
该方法利用Claw远程控制协议的流式分片能力，将超限剪贴板内容自动拆分为多个小于阈值的数据包，在客户端侧重组还原，避免因单包超限导致丢弃。
1、打开WorkBuddy桌面客户端，点击右上角齿轮图标进入「设置」。
2、切换至「远程控制」选项卡，确认「启用Claw远程控制」已开启。
3、向下滚动至「高级传输参数」区域，勾选「启用剪贴板分块传输」。
4、在「分块大小(KB)」输入框中填入数值，推荐值为1024（即1MB），最大支持4096。
5、点击「应用并重启Claw服务」，系统将重新初始化通信通道。
三、在企业微信/飞书IM端配置剪贴板指令白名单与尺寸过滤
该方法针对通过IM平台发送的结构化剪贴板指令（如/wb copy类命令），在消息网关层实施预检，拦截超出预设尺寸的原始内容，防止无效传输占用带宽。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
1、登录飞书管理后台或企业微信管理台，进入已绑定的WorkBuddy机器人详情页。
2、在「安全策略」模块中，找到「剪贴板指令限制」设置项。
3、启用「内容长度校验」开关，并在「单条指令最大字符数」栏填写上限值，例如：20000（约2万UTF-8字符，对应典型富文本约1.5MB）。
4、勾选「拒绝超限内容自动截断」，确保不执行部分粘贴，而是返回明确错误提示。
5、保存策略后，所有后续经该IM通道发起的剪贴板操作均受此规则约束。
四、配置云桌面协议策略中的剪切板重定向带宽配额
当WorkBuddy作为客户端接入华为云Stack云桌面环境时，需同步调整底层协议策略，防止云桌面服务端主动压缩或丢弃大体积剪贴板数据。
1、使用管理员账号登录华为云Stack管理控制台，选择对应区域和项目。
2、在服务列表中选择“企业应用 > 云桌面”，进入总览页面。
3、左侧导航栏单击“策略管理 > 协议策略”，进入策略列表页面。
4、选择已启用的剪切板策略（如workspace2storage_Clipboard），点击右侧「编辑」。
5、在“高级策略 > 文件和剪切板”配置页中，找到「剪切板数据最大传输量(MB)」字段，将其修改为10（即10MB）。
6、确认保存，策略将在下次用户会话建立时加载生效。
