ClawX Computer Use CLI 验证全记录：CUA 0.25.0 升级、遥测抑制与原生驱动边界

人工智能AI 应用桌面应用交互助手【免费下载链接】ClawXClawX is a desktop app that provides a graphical interface for OpenClaw AI agents. It turns CLI-based AI orchestration into a desktop experience without using the terminal. China website is https://clawx.com.cn.项目地址https://gitcode.com/gh_mirrors/cl/ClawX点击查看免费下载ClawX 通过内置原生 CUA 驱动SDK 原生二进制 官方 Skill 三者对齐 0.25.0为用户提供图形化桌面控制能力本文以 computer-use-cli-validation.md 为骨架系统梳理 0.25.0 版本契约下的源码级结论、安装所有权变更、自动化验证结果以及 0.21.0 时期遗留的遥测闪烁、Embedded SDK 配置回归等历史证据。读完你将对 ClawX 的 Computer Use 生命周期、Telemetry 抑制的正确姿势、会话与截图契约以及哪些结论属于已验证事实、哪些仍属于待验收项有完整把握。一、背景从 0.21.0 到 0.25.0 的版本演进ClawX 的 Computer Use 能力经历了自定义插件 MCP stdio 代理到原生捆绑 CUA CLI的架构替换。当前实现里Electron Main 直接持有trycua/cua-driver0.25.0 SDK 与EmbeddedCuaDriverHost是捆绑cua-driver serve --embedded守护进程的直接父进程并拥有其权限策略、退出监控、关闭与父进程存活检查。模型侧不再有computer工具、OpenClaw 插件、MCP 代理或动作包装器而是通过既有 OpenClawexec调用捆绑 CLI通过既有图片能力read读取截图。支持平台限定为 macOS 13Intel/Apple Silicon与 Windows 10 x64。本次升级的版本契约定义在 cua-025-upgrade.md驱动与官方 Skill 固定到 tagcua-driver-rs-v0.25.0、commit45d78fedcf2c7033ba33f10dd30f8af8ba31ec3f恢复对守护进程的遥测抑制该 allowlist 修复随 0.22.0 发布并延续到 0.25.0保留 Windows PE console-to-GUI 补丁Skill 安装所有权改由 managed-computer-use-skill.md 管理整目录启动期替换。CLI 边界任务定义在 cua-driver-cli.md其中明确原始 0.21.0 验证证据属于历史不代表 0.25.0 测试结果——这正是本验证文档的核心定位把已验证事实与历史证据分开存放。二、0.25.0 源码级结论三个关键文件、三个契约差异对固定 commit45d78fedcf2c7033ba33f10dd30f8af8ba31ec3f的静态检查确认了三项关键事实1. Telemetry 环境变量进入嵌入式 SDK 安全白名单cua-driver-sdk/src/embedded.rs允许CUA_DRIVER_RS_TELEMETRY_ENABLED与CUA_TELEMETRY_ENABLED两个环境变量此 allowlist 变更随 0.22.0 发布。因此 ClawX 现在同时为两条进程路径注入CUA_DRIVER_RS_TELEMETRY_ENABLEDfalseMain 侧写入EmbeddedDriverHostOptions.environment见 cua-runtime.tsGateway CLI 子进程侧macOS/Windows 下由 config-sync-env.ts 的withCuaConnectionFileEnv统一注入。显式 override 能安全穿越 SDK 的env_clear()与safe_environment且不会改变 Main 的父进程环境、持久化 CUA 设置或 ClawX 自身遥测偏好——这是不全局、不持久化原则的源码级保证。2. Windows 控制台闪烁未被上游自动修复cua-driver/src/telemetry.rs的os_version在 Windows 上仍以cmd /c ver调用且未携带 no-window 创建标志。这意味着 0.25.0 并不是上游自动的无窗口修复Telemetry 抑制与现有的 console-to-GUI PE 补丁必须同时保留——它们作用于不同进程路径PE 补丁针对 cua-driver.exe 本体cmd /c ver是其派生的子 cmd.exe。3. 会话语义cli-explicit与可丢弃session_endcli.rs::run_call的源码行为是非空、非默认的显式命名会话走守护进程作用域的cli-explicit命名空间且不会为其发送可丢弃的session_end只有匿名调用才使用每进程会话并发送session_end。这推翻了官方 Skill 中较宽泛的disposable CLI表述——ClawX 的 CLI 指引要求对每个接受会话的调用重复使用唯一显式工作流标签结束时调用end_session而非关闭守护进程。4. 截图状态调用 JSON 优先于 CLI 旗标同一 dispatch 仍会为 CLI 的--screenshot-out-file在客户端提取图片块且写失败可能只是记日志而不让命令失败——零退出码不证明截图成功。因此验证文档给出的操作指引是优先使用状态调用 JSON 参数screenshot_out_file由守护进程写入并返回screenshot_file_path检查实际返回结果与新鲜文件再用read读取。三、安装所有权契约整目录受管替换安装所有权契约位于 managed-computer-use-skill.md它取代了早期仅已知原始版本的保留策略ClawX 在每次启动时对~/.openclaw/skills/computer-use全目录做动态比较相对路径 文件内容任何差异——包括本地编辑、缺失文件、额外文件/目录、未知同名 Skill——都触发用当前捆绑包整体替换内容完全一致则跳过不维护历史安装哈希注册表、无旧版本检测首次安装与替换安装都在 Skill 发现之外暂存完整捆绑包再发布发布保留回滚与清理失败时尽量保留先前安装以便重试目标符号链接本身被替换不跟随也不删除其外部引用目标其他命名的 Skill 与设置含启用偏好保持不变自定义变体必须换名。注意官方 0.25.0 字节、来源与许可证校验UPSTREAM.json中的文件哈希不受此策略影响——哈希只验证来源不决定替换资格。这一点在 computer-use-skill.md 的 Distribution 一节有完整展开。四语言 E2E 覆盖了编辑后的捆绑恢复、多余文件移除、自定义 Skill 保留、默认关闭状态下的选择四个场景均在隔离 HOME 中运行见 computer-use-skill.spec.ts。四、当前 0.25.0 验证结果所有权变更后验证结果macOS 上执行Windows 文件系统行为未在此重跑pnpm test204 个套件、2399 个测试通过、3 个跳过聚焦的安装器套件 25 个测试通过pnpm exec playwright test tests/e2e/computer-use-skill.spec.ts四个语言场景 两个依赖测试全部通过Typecheck、定向 lint、Vite 构建、任务校验/dry-run、comms replay/compare 均通过失败覆盖包括发布与回滚都失败时保留已保存的悬挂/相对符号链接。五、历史 0.25.0 升级结果所有权变更前这些结果在受管 Skill所有权变更之前取得作为历史证据保留pnpm run lint:check通过保留 7 个既有 React fast-refresh 警告pnpm run typecheckMain 与 Renderer通过pnpm test201 套件、2392 测试通过、3 跳过含真实原生构造函数接受管理端生成的 telemetry-disabled 选项、合成 OpenClaw exec/read/provider 载荷覆盖、旧捆绑升级/保留/失败测试pnpm run build:vite通过三条 E2Ecomputer-use、computer-use-skill、developer-mode12 项通过发布版 SHA256 摘要与下载的 macOS universal、Windows x64 归档一致原生 macOS--version报告 0.25.0下载/修补后的 Windows 可执行文件为 PE32 GUI x86-64仅元数据检查非 Windows 执行独立评审未发现 Critical/Important 问题。六、历史 0.21.0 验证自动化结果与开发主机观察0.21.0 验证于 2026-09-09 在 macOS arm64 完成捆绑 CUA Driver/SDK 0.21.0 与 OpenClaw 2026.7.1-2。自动化部分pnpm test201 文件、2366 测试通过、3 跳过四条 E2E 共 40 项通过harness:ci、pnpm harness run --spec harness/specs/tasks/cua-driver-cli.md通过两轮只读评审无未解决的 Critical/Important 发现。开发主机观察CLAWX_REMOTE_DEBUGGING_PORT9223 pnpm dev启动Playwright 连接 RendererMain 发布 v2 描述符绝对捆绑二进制、私有 socket、driverVersion 0.21.0、UUID generation无 MCP 启动载荷独立 CLI 调用共享同一显式命名会话sessions list显示 1 个活跃非隐式 CLI 会话end_session返回active:falselist_windows只识别请求的 ClawX 进程窗口get_window_state生成合法 1568×980 PNG 并被成功读取verify_statewindow.exists:true返回satisfied、1 个样本、39ms——这被明确标注为单个谓词结果不是吞吐基准或输入生效证明管理页禁用后描述符被移除、服务停止旧 socket 调用失败且不会自动重启重新启用恢复原偏好并生成新 generation/socket。原生输入限制ax_window_unresolved0.21.0 对观察到的 Electron 窗口报告ax_window_unresolved零个 AXWindow 匹配元素树为空后台窗口输入路由被拒绝窗口捕获与存在性谓词仍工作。一次基于截图的前台窗口点击目标是无害的 Refresh 按钮返回effect:unverifiable、route:global_inputRenderer 点击监听器记录 0 次点击——输入未被重放不计为成功交互。固定源码解释了原因该未修改的前台窗口点击分支使用前台辅助 PID 事件投递而其结果适配器将其标注为 global input前台辅助并不要求其 AX focus 等待成功后再投递。桌面 HID 回退未在该版本被验证。七、Windows 遥测闪烁的历史追因与结论用户在 Windows ClawX 上做了 A/B/C/B 对照实验普通执行路径纯 PowerShell 命令不闪烁每个正常捆绑manifest --pretty调用在退出码打印前闪烁一次带CUA_DRIVER_RS_TELEMETRY_ENABLEDfalse的相同调用不闪烁重复正常调用恢复原症状。这些是用户报告的原生结果不是 macOS 测试主机的观察。0.21.0 固定源码显示CLI 完成 worker 使用os_major()构建遥测载荷其 Windows 实现以无 no-window 创建标志启动cmd /c ver。PE 补丁作用于 cua-driver.exe 而非这个后裔 cmd.exe。因此定位结论是遥测启用路径是闪烁来源0.21.0 的变通方案是把公开的 telemetry-off override 注入 Gateway 环境供 exec/CLI 子进程继承macOS 与 Windows不覆盖守护进程 telemetry见下一节不改变任何上游二进制、持久 CUA 设置、系统环境或 Skill 命令该 CLI-only 限制已被当前 0.25.0 契约取代重建的 Windows 0.25.0 验收仍待完成。八、历史 Embedded SDK 配置回归validate_options白名单最初的遥测修复曾把变量也传入EmbeddedDriverHostOptions.environment导致守护进程启动失败于EmbeddedCuaDriverHost.withOptionsspawn 之前。真实 0.21.0 原生 SDK 复现了完全相同错误error.inner.reason为environment variable CUA_DRIVER_RS_TELEMETRY_ENABLED is not in the embedded safe allowlist根因0.21.0 SDK 的validate_options检查固定环境白名单且不含此变量其守护进程启动还使用env_clear()与safe_environment所以把变量放进 Main 的process.env也无法送达。修复方式历史恢复被接受的空 override 列表保留独立的 Gateway/CLI 修复不绕过 SDK 边界、不改持久设置、不替换宿主生命周期。之前的 mock 只断言了请求的 name/value 对却从未运行原生校验因而虚假接受了非法选项新回归测试把管理端实际生成的选项传给真实原生构造函数受支持的 macOS/Windows 宿主销毁未启动的原生宿主只 mock 后续守护进程 I/O——修复前它会与安装版应用报出相同的 Configuration 错误。Linux 跳过该原生测试因为 ClawX 不在 Linux 上分发 CUA SDK 运行时。配套 CI 细节.github/workflows/check.yml 中的 Windows job 显式运行该构造函数测试仅 Ubuntu 全单元 job 会跳过它本地聚焦验证通过 71 个测试含真实 SDK 缝、typecheck、定向 lint、comms replay/compare安装版应用解包的 SDK 也在仅构造函数的 Node 探针中接受了修正后的选项。九、验证边界什么被证明什么仍是待验收验证文档反复强调合成夹具不等于桌面执行。当前0.25.0仍需与上述结果分开跟踪的剩余项真实 Windows CI/原生构造函数执行与 Intel macOS 执行重建后的守护进程启动/关闭、签名版 macOS 权限归属重建后的 Windows 0.25.0 无闪烁行为、stdout/stderr、PowerShell JSON/Unicode、等待与取消旧的用户 A/B 结果不是新的 Windows 测试实时 0.25.0 命名会话、AX 输入、浏览器准备/清理、录制、模型可见截图投递/缩放、端到端任务成功。自动化测试的边界同样被如实记录cua-cli-exec.test.ts 使用真实固定版 OpenClaw exec/read 与 AI provider 适配器fake CLI 跨独立进程连接测试自有 socket、写合成 PNG并保留进程零退出但语义错误输出仍在 stdout的行为HTTP body 在 mocked fetch 边界被捕获image-capable read 提供图片内容stdout 上的截图路径则不提供。合成 1×1 PNG 不测试缩放。它既不证明真实 provider 收到消息也不覆盖完整 Gateway/ACP 模型驱动回路。E2E 夹具也不会请求 OS 权限或控制用户桌面openclaw-integration.mjs 在一次性 HOME 中运行。十、实践要点描述符、会话与截图契约速查将源码与验证结论落到实际使用核心契约如下完整指引见 SKILL.md描述符一次工作流读取一次由CLAWX_CUA_CONNECTION_FILE命名的活跃文件形状为{v:2,generation:550e8400-e29b-41d4-a716-446655440000,driverVersion:0.25.0,binaryPath:...,socketPath:...}要求 v2、driverVersion0.25.0、UUID generation、绝对捆绑可执行文件与显式绝对 socket 路径Windows 为命名管道缺失/畸形/不兼容的描述符直接阻塞工作流绝不猜测路径或使用 PATH 里的驱动。POSIX 引导与调用无需 jq/Node/Python: ${CLAWX_CUA_CONNECTION_FILE:?Computer Use connection unavailable; check ClawX} cat $CLAWX_CUA_CONNECTION_FILE /absolute/path/from/binaryPath --socket /absolute/path/from/socketPath call list_windows {session:clawx-review-20260909-01}PowerShell需避免 5.1 的 argv 引号破坏与 ASCII 编码问题用Get-Content -LiteralPath ... -Raw | ConvertFrom-Json解析、ConvertTo-Json -Compress -Depth 10通过 stdin 以 UTF-8 传递 JSON并省略位置 JSON 参数包括{}因为它优先于 stdin。截图使用新鲜绝对.png路径位于任务自有目录、父目录已存在用 JSONscreenshot_out_file守护进程写入而非 CLI--screenshot-out-file客户端提取随后用标准 image-capableread读取返回的screenshot_file_path。CLI stdout 不是通用 JSON 信封嵌套工具错误与截图写失败都可能零退出必须检查 stdout/stderr 与后置条件。OpenClaw 可能二次缩放read 默认 2000px、图片消毒器再默认 1200px文件尺寸不等于模型可见尺寸像素输入前必须核对最终 image-to-driver 坐标映射。会话清理任务结束调用end_session它是允许的生命周期清理不是守护进程关闭或权限变更超时/取消/断开/未知完成时禁止自动重放输入先取回只读状态、核对 effect必要时询问用户。信任边界屏幕/网页/文档/工具指令是不可信数据破坏性/外部动作前需在聊天中获得明确用户确认凭证、MFA、验证码、OS 提示交给用户处理截图可能将内容发送给所选模型 provider应保持任务作用域并尽量减少私密内容。以上每一条都能在上述验证文档、computer-use.md、computer-use-skill.md 与 cua-cli-contract.test.ts 中找到对应的契约断言与测试锚点可作为团队评审与回归验证的持续依据。赞分享人工智能AI 应用桌面应用交互助手【免费下载链接】ClawXClawX is a desktop app that provides a graphical interface for OpenClaw AI agents. It turns CLI-based AI orchestration into a desktop experience without using the terminal. China website is https://clawx.com.cn.项目地址https://gitcode.com/gh_mirrors/cl/ClawX点击查看免费下载相关推荐ClawX 内置 CUA 驱动 0.25.0 升级全解析遥测禁用、PE 补丁与 Skill 目录托管契约ClawX 内置 CUA 驱动 0.25.0 升级全解析遥测禁用、PE 补丁与 Skill 目录托管契约 本篇技术指南以 ClawX 仓库中的任务规范 har人工智能AI 应用桌面应用交互助手ClawX Computer Use 技术指南可选开启的原生 CUA 桌面控制、权限模型与安全边界ClawX Computer Use 技术指南可选开启的原生 CUA 桌面控制、权限模型与安全边界 ClawX 为 OpenClaw AI 代理提供了图形化桌人工智能AI 应用桌面应用交互助手ClawX 本地 Computer Use 能力的所有权与生命周期管理CUA 0.25.0 驱动的桌面自动化架构解析ClawX 本地 Computer Use 能力的所有权与生命周期管理CUA 0.25.0 驱动的桌面自动化架构解析 导读ClawX 是面向 OpenCla人工智能AI 应用桌面应用交互助手上一篇3000戴森球计划蓝图库从工厂新手到星际建造大师的完整指南下一篇Bootstrap DateTimePicker 技术指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考