功能模块与场景说明OC Client
汇总 openclaw 的核心模块、典型能力与适用任务。通过梳理系统底层的文本流转逻辑与配置边界，帮助您在部署前从结构层面准确定位所需功能。
查看模块详情 ↓输入效率中枢引擎
openclaw 并非单一的剪贴板工具，而是一个由文本监听、正则处理和片段注入组成的复合引擎。了解这些核心模块的运行机制，是高级配置的前提。
- 全局文本钩子：在系统底层捕获输入事件，需在客户端“安全设置”中授权。
- 实时格式化通道：支持在文本进入输入框前，进行自动大小写转换或去除冗余换行。
- 内联片段触发：通过缩写词直接展开长文本，响应延迟低于 50ms。
跨设备协同连接态
OC Client 在多设备间的无缝流转依赖于本地局域网发现机制或安全的云端加密通道。明确网络边界，能大幅降低连接失败的概率。
- 局域网直连 (推荐)：两台设备处于同一 Wi-Fi 下即可激活，延迟极低，无需外网。
- 云端中转支持：当设备跨网段时，系统自动降级为端到端加密的云端中转模式。
- 平台特有权限：macOS 版本需提前在“系统偏好设置”中授予辅助功能权限才能完成跨端粘贴。
典型能力与任务矩阵
将底层引擎转化为具体的桌面任务。以下是 openclaw 能够直接接管并优化的典型操作场景及所需的配置入口。
历史记录溯源
自动留存最近 500 条图文复制记录，支持本地全文检索。适合资料收集与多源信息比对任务。
正则与脚本清洗
复制即触发数据格式化。内置去除非法字符、JSON美化等宏规则。适合开发人员与数据录入专员。
富文本格式剥离
无缝剥离网页复制带来的多余样式、隐藏链接与背景色，强制以纯文本格式粘贴至目标应用。
模块能力边界与异常排查指南
为了让部署过程更透明，我们明确列出了 openclaw 的能力边界与常见功能异常的排查判断条件。
设备接力模块为何无法发现目标主机？
判断条件：请先确认两台设备是否连接在同一个路由器的同一频段下。若网络环境复杂，需检查防火墙是否放行了客户端所需的 UDP 广播端口（默认为 59200）。
片段触发（Snippet）在某些软件中失效？
例外情况说明：部分拥有最高级键盘钩子权限的软件（如部分虚拟机、远程桌面客户端或反作弊游戏环境）会屏蔽外部键盘事件注入。此时建议使用右键菜单手动粘贴替换片段。
大文件跨端传输容量上限是多少？
能力边界：当前版本的跨端同步模块专为轻量级数据（纯文本、代码片段、小体积截图）优化。单次传输的图文混合包体积硬限制为 15MB，超出部分将被自动截断或忽略。
正则表达式处理导致客户端卡顿？
排查建议：请检查是否在“全局规则”中启用了极耗性能的“回溯正则”。建议对长文本取消全局匹配，并在“规则引擎”中为高耗时正则添加特定的应用白名单限制。
macOS 睡眠唤醒后剪贴板断连？
后续操作：系统休眠会暂时挂起网络套接字。唤醒后，客户端通常会在 5 秒内自动重连。如果长期处于离线状态，可点击状态栏图标选择“强制重置网络状态”。