人工智能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 仓库中的任务规范 harness/specs/tasks/cua-025-upgrade.md 为骨架系统讲解 ClawX 将内置 CUAComputer Use AgentSDK、原生驱动与官方 computer-use Skill 一并升级并固定到 0.25.0 的完整工程实践。你将掌握版本固定与来源校验方式、CUA_DRIVER_RS_TELEMETRY_ENABLEDfalse的双通道遥测禁用方案、Windows PE 控制台转 GUI 补丁的保留原因、ASAR 外物理加载原生 SDK 的实现细节以及 ClawX 对~/.openclaw/skills/computer-use目录的整体替换托管策略并了解仓库内对应的验证边界与验收清单。升级契约一条任务规范如何锁定整个技术栈cua-025-upgrade是 ClawX 内部以 harness 任务规范形式存在的版本升级契约taskType:runtime-bridgescenario:gateway-backend-communication其核心意图是将 CUA SDK、原生驱动与 computer-use Skill 三者同时升级到 0.25.0恢复受支持的守护进程daemon遥测抑制能力并保留 Windows PE 控制台修复。它明确了三个可独立实施、文件所有权互不重叠的实施单元SDK / artifacts / runtime驱动二进制的固定、下载校验与运行时加载官方 Skill 与窄范围的已安装包升级离线打包与启动时的安装目录治理产品 / 参考文档与验证多语言 README、harness 参考文档与测试。该任务规范同时划定了明确的边界见 harness/specs/tasks/cua-025-upgrade.md 末段不做上游 moving-main 拉取、不做运行时依赖下载、不新增 action wrapper、不引入 MCP 集成、不扩展平台、不做全局/持久化的遥测设置变更。版本固定与来源指纹整个升级以固定的上游发布点为锚而非跟随上游main发布标签cua-driver-rs-v0.25.0固定提交45d78fedcf2c7033ba33f10dd30f8af8ba31ec3f演进背景遥测变量的 SDK 安全白名单修复在0.22.0引入并延续到 0.25.0仓库中 scripts/cua-driver-artifacts.mjs 将该契约固化为可执行配置其中声明了CUA_DRIVER_VERSION 0.25.0、发布标签以及 macOS universal 与 Windows x64 两个归档的 SHA256 校验值// scripts/cua-driver-artifacts.mjs export const CUA_DRIVER_VERSION 0.25.0; export const CUA_DRIVER_RELEASE_TAG cua-driver-rs-v${CUA_DRIVER_VERSION}; const MAC_ARTIFACT Object.freeze({ asset: cua-driver-rs-${CUA_DRIVER_VERSION}-darwin-universal-binary.tar.gz, sha256: 29984f5363c12d9901588e814a3a519b8015a1255d7a59d658fbf2d3e51f8983, }); const WINDOWS_X64_ARTIFACT Object.freeze({ asset: cua-driver-rs-${CUA_DRIVER_VERSION}-windows-x86_64-binary.zip, sha256: 314f5df05933810499deaa61022c714341aff64f8e45157a589df6a4b1724fa4, });归档覆盖darwin-x64、darwin-arm64、win32-x64三个目标而上游的 Linux 或 Windows ARM64 文档不会扩大 ClawX 的支持范围。遥测抑制从 0.21.0 的 CLI 临时方案到 0.25.0 的双通道覆盖这是本次升级最核心的技术点恢复守护进程侧的遥测抑制能力。要理解它需要先回顾 0.21.0 时代的历史问题。0.21.0 的失败与 CLI-only 临时方案在 0.21.0 中cua-driver-sdk的嵌入式安全白名单safe allowlist不接受CUA_DRIVER_RS_TELEMETRY_ENABLED变量导致 Main 构造EmbeddedDriverHostOptions时直接抛出Configuration failure。当时的临时方案只能退而求其次仅在 Gateway 启动的 CLI 子进程环境中注入该变量守护进程侧无法覆盖。这组历史证据与限制记录在 harness/reference/computer-use-cli-validation.md。0.22.0 起白名单放行0.25.0 双通道落地从 0.22.0 起上游cua-driver-sdk/src/embedded.rs的安全环境白名单开始允许CUA_DRIVER_RS_TELEMETRY_ENABLED以及CUA_TELEMETRY_ENABLED。因此在 0.25.0 契约下ClawX 可以在两条路径同时关闭 CUA 产品遥测且只作用于 ClawX 自己管理的进程Main 的嵌入式守护进程选项见 electron/utils/cua-runtime.tsCuaRuntimeManager.startInternal()构造EmbeddedDriverHostOptions.new()时显式传入const options sdk.EmbeddedDriverHostOptions.new({ binaryPath, hostBundleId: CUA_APP_ID, // app.clawx.desktop permissionMode: sdk.EmbeddedPermissionMode.Unrestricted, dangerouslyBypassApprovals: true, approveCapabilityManifest: false, approveSessionPolicy: false, inheritStderr: true, environment: [{ name: CUA_DRIVER_RS_TELEMETRY_ENABLED, value: false }], });Gateway 启动的 CLI 子进程环境见 electron/gateway/config-sync-env.tswithCuaConnectionFileEnv()在 macOS/Windows 上同时注入连接文件路径与遥测关闭变量if (platform darwin || platform win32) { next[CLAWX_CUA_CONNECTION_FILE_ENV] getCuaConnectionFilePath(userDataPath); // CLI processes are Gateway children, not children of the managed CUA daemon. next.CUA_DRIVER_RS_TELEMETRY_ENABLED false; }对应的单元测试在 tests/unit/gateway-process-launcher.test.ts 中验证了子进程环境同时携带CUA_DRIVER_RS_TELEMETRY_ENABLED: false与连接文件变量tests/unit/cua-runtime.test.ts 与 tests/unit/cua-sdk.test.ts 则验证了构造选项中的environment数组。三条不可越过的边界显式覆盖在env_clear()与safe_environment过滤后依然存活不得改动 Main 的父进程环境、不得改动持久化的 CUA 独立安装设置、不得改动 ClawX 自身的遥测偏好真实原生构造验证只构造 host不得启动守护进程也不得请求系统权限。README 在 README.md、README.zh-CN.md、README.ja-JP.md 三处对该行为有同步描述内置 CUA SDK 与 Driver 为 0.25.0macOS 与 Windows 上双通道均设CUA_DRIVER_RS_TELEMETRY_ENABLEDfalseSDK 自 0.22.0 起允许该变量取代 0.21.0 的 CLI-only 临时方案。Windows PE 补丁为什么升级遥测不等于修复闪窗一个容易误读的点是既然 0.25.0 的遥测白名单放行了Windows 下 CUA 驱动启动时的控制台闪窗是否就自动消失了答案是否定的。固定提交的上游源码cua-driver/src/telemetry.rs::os_version在 Windows 上仍通过cmd /c ver收集系统版本且没有携带 no-window 标志。因此遥测抑制环境变量与 PE 子系统改写构建期补丁解决的是两条不同的进程路径必须同时保留CUA_DRIVER_RS_TELEMETRY_ENABLEDfalse与既有 Windows 可执行文件PE 子系统 console-to-GUI 改写补丁0.25.0 不是上游自动的无窗口修复。验收要求明确macOS universal 与 Windows x64 归档在解包前必须逐一核对 SHA256并在校验后保留 PE 子系统改写。harness/reference/computer-use.md 进一步强调此前 Windows 用户反馈针对 0.21.0重建后的 Windows 0.25.0 的启动、CLI 输出与闪窗行为仍需原生验证PE32 GUI x86-64的元数据检查不等于 Windows 实际执行。原生 SDK 加载ASAR 之外的物理路径升级 0.25.0 后原生 SDK 的加载方式必须针对新包的导出布局重新验证。ClawX 的加载策略是物理路径优先见 electron/utils/cua-sdk.tsexport function getCuaSdkSpecifier(entry: keyof CuaSdkModules): string { if (!app.isPackaged) return trycua/cua-driver/${entry}; const appPath app.getAppPath(); const root appPath.endsWith(.asar) ? ${appPath}.unpacked : appPath; // Pinned CUA 0.25.0 exports. Its UniFFI loader derives native paths from // import.meta.url; unpacking files alone leaves virtual ASAR module URLs. return pathToFileURL(join(root, node_modules/trycua/cua-driver/dist, ${entry}.js)).href; }历史教训来自 0.21.0 复现ubjs/node的resolveLibPath通过createRequire(callerUrl).resolve定位同平台包Electron 虚拟文件系统可能让 JS 层找到位于app.asar路径下的文件而原生 addon 的dlopen无法解析该路径macOS 返回 ENOTDIR / errno 20。因此不仅trycua/cua-driver要解包到app.asar.unpackedubjs/core与ubjs/node也必须一并解包——物理 ESM 导入无法解析仅存在于相邻归档中的 JS 依赖。该物理路径要求在 0.25.0 下仍然有效0.25.0 的导出映射、库布局与重建包初始化需要按新字节做校验0.21.0 的历史结果不能用来为 0.25.0 背书。仓库提供pnpm cua:smoke:asar app Resources directory冒烟脚本可基于打包后的 SDK 字节构建最小真实 ASAR 应用分别用--baseline裸导入应复现旧虚拟路径错误与--artifact真实解包依赖树只读验证导出映射、懒加载、app.isPackaged、每个入口的新 Electron Main 进程以及进程报告中物理加载的 dylib/DLL。computer-use Skill官方快照 vendoring 与目录级整体托管固定来源离线分发升级契约要求将0.25.0 随附的官方 Skill 快照与 MIT 许可证一起 vendoring 到仓库并记录精确的源文件哈希。实现细节见 harness/reference/computer-use-skill.md上游 8 份 Markdown 文档本地保留SKILL.md更名为UPSTREAM-SKILL.md另有MACOS.md、WINDOWS.md、LINUX.md、BROWSER.md、RECORDING.md、EMBEDDING.md、README.md仓库根LICENSE.mdMIT随包离线分发UPSTREAM.json记录源标签/提交、路径、文件名映射与文件哈希只有 ClawX 自己的SKILL.md是活跃的发现入口保留/computer-use选择器命令computer-use仍是唯一活跃 Skill 入口。历史来源0.21.0 的cua-driver-rs-v0.21.0、上游规划时观察到的 0.24.0均为被取代的旧选择不构成当前包的权威来源。managed-computer-use-skill整体替换、跳过一致、失败回滚升级契约明确表示harness/specs/tasks/cua-025-upgrade.md中已知原封不动known-pristine才保留安装的旧策略被 harness/specs/tasks/managed-computer-use-skill.md取代。新契约要点ClawX 拥有~/.openclaw/skills/computer-use整个目录。每次启动将当前 bundle 与目标目录做动态全量对比相对路径 文件内容任何差异用户编辑、缺失文件、额外文件/目录、同名的未知 Skill都触发整体替换内容一致则不动不维护历史安装哈希、不做旧版本检测、目录内无用户内容保留例外自定义版本必须改用其他 Skill 名称与目录全新安装与替换安装都先在 Skill 发现范围之外暂存完整 bundle发布保留回滚与清理复制或发布失败时尽可能保留旧安装并允许重试同名符号链接只替换链接本身不跟随也不删除其外部目标其他名称的 Skill 与设置包括 Computer Use 启用偏好保持不变选择 Skill 既不会启用服务也不会授予系统权限。四语言 Skill E2Etests/e2e/computer-use-skill.spec.ts会在隔离测试 home 中预置被编辑过的同名 bundle 与额外文件/目录启动后断言所有内置路径与字节被还原、额外内容被移除、另一个自定义 Skill 被保留并验证/computer-use选择不会启用或启动 Computer Use。CLI 契约更新不是字符串替换而是按新命令面更新指导升级验收特别强调ClawX 特有的 CLI 指导要对照新的命令/会话/截图契约更新而非盲目的版本号替换。仓库参考文档明确的关键点包括命名会话路由固定提交的cli.rs::run_call将非空、非默认的显式会话标签路由到守护进程共享的cli-explicit命名空间并为匿名调用发送一次性session_end。因此每次接受的调用应使用唯一的显式非默认工作流会话用end_session清理而不是关闭守护进程标签不授予权限也不跨守护进程代际存活。截图契约状态捕获优先使用守护进程写入的 JSONscreenshot_out_file而不是客户端解图的 CLI--screenshot-out-file后者在 0.25.0 分发中仍会解码响应图像块写失败可能只记日志而不报错。使用get_window_state/get_desktop_state不再使用已移除的独立screenshot工具与退役的capture_scope设置。验证语义嵌套工具错误与部分截图写失败可能以退出码 0 结束与输入确认都不等于语义成功不确定完成时不得盲目重放输入。按键别名CLI 指导使用cmd表达 Command/Win 组合键ClawX 没有适配器归一化别名历史 0.21.0 诊断macOS 的modifier_key_code_and_flag会忽略未知修饰键而不报错。平台、生命周期与安全边界支持平台macOS 13Intel 与 Apple silicon与 Windows 10 x64electron/utils/cua-platform.ts 中isCuaPlatformSupported()通过平台/架构/系统版本判断darwin 需 x64/arm64 且大版本 ≥ 22win32 仅 x64。Main 持有生命周期Main 是内置cua-driver serve --embedded守护进程的直接父进程拥有权限策略、退出监控、关停与父进程存活行为二进制保持版本固定、SHA256 校验、ASAR 之外、随 macOS 应用签名。连接发现CLAWX_CUA_CONNECTION_FILE是 ClawX 用户数据下的稳定发现路径Main 原子发布 owner-private 描述符{ v: 2, generation, driverVersion, binaryPath, socketPath }Skill 在任务启动及重启/不可用后读取实时描述符不存在 MCP 启动参数或双格式读取器。无附加组件不使用 ClawXcomputer工具、OpenClaw 插件、MCP 代理或 action wrapper无模型控制的权限授予无不确定输入重放。验证策略与验收清单升级契约给出了完整的验收条目见 harness/specs/tasks/cua-025-upgrade.md 的 acceptance 与 requiredTests验收维度要求版本固定trycua/cua-driver及其原生依赖与发布的 0.25.0 一致且与随附 CLI 版本匹配归档校验macOS universal 与 Windows x64 的 SHA256 解包前核对保留 PE console-to-GUI 改写原生构造真实原生 SDK 构造接受遥测关闭选项不启动守护进程、不请求系统授权遥测双通道Gateway CLI 子进程保持CUA_DRIVER_RS_TELEMETRY_ENABLEDfalse嵌入式守护进程选项加入白名单覆盖原生加载保持 ASAR 外物理 SDK 加载验证 0.25.0 升级后的导出/库布局Skill 打包vendoring 0.25.0 官方 Skill 快照与 MIT 许可证源哈希精确仅computer-use为活跃入口CLI 指导对照新命令/会话/截图契约更新而非盲目版本替换目录托管按 managed-computer-use-skill 做整体替换、一致跳过、失败回滚保留其他 Skill 与设置生命周期Main 持有生命周期、仅本地 CLI 调用、无模型控制的权限授予、无不确定输入重放文档同步更新四个语言环境与三个 READMEWindows 原生与重建包验证需与合成测试分开报告测试覆盖集中在 tests/unit/cua-runtime.test.ts、tests/unit/cua-driver-artifacts.test.ts、tests/unit/cua-sdk.test.ts、tests/unit/gateway-process-launcher.test.ts、tests/unit/cua-cli-contract.test.ts、tests/unit/cua-cli-exec.test.ts、tests/unit/builtin-computer-use-skill.test.ts以及 tests/e2e/computer-use.spec.ts 与 tests/e2e/computer-use-skill.spec.ts。需要清醒认识验证边界见 harness/reference/computer-use-cli-validation.md历史 0.25.0 升级结果如 macOS arm64 上 201 套件通过、原生 macOS--version报告 0.25.0、归档 SHA256 匹配是被取代策略下的历史证据Windows 实际执行、Intel macOS 执行、实时命名会话连续性、签名 macOS 权限归属、打包 Windows stdout/stderr/PowerShell 与取消行为等仍属于独立验收项不得把合成测试或 0.21.0 的旧证据当作 0.25.0 的通过证明。小结CUA 0.25.0 升级在 ClawX 中远不止一次依赖版本 bump它通过 harness 任务规范把固定上游来源、双通道遥测抑制、Windows PE 补丁保留、ASAR 外原生加载、官方 Skill 离线 vendoring、安装目录整体托管、文档与验证同步串成一条可独立实施又相互咬合的工程链路。对希望理解 ClawX Computer Use 架构的读者建议顺次阅读 harness/reference/computer-use.md生命周期与安全边界、harness/reference/computer-use-skill.mdSkill 来源与集成与 harness/reference/computer-use-cli-validation.md验证历史与剩余缺口并结合 electron/utils/cua-runtime.ts 与 scripts/cua-driver-artifacts.mjs 的源码佐证即可完整还原这条升级链路的前因后果。赞分享人工智能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点击查看免费下载相关推荐7个维度深度解析Spring PetClinic企业级Spring应用架构实战指南7个维度深度解析Spring PetClinic企业级Spring应用架构实战指南 Spring PetClinic不仅仅是一个简单的宠物诊所管理系统示例它人工智能AI 应用桌面应用交互助手ClawX 内置 computer-use Skill随包分发官方 CUA 0.25.0 的托管式安装与安全发现机制ClawX 内置 computer use Skill随包分发官方 CUA 0.25.0 的托管式安装与安全发现机制 本文聚焦 ClawX 仓库中内置 com人工智能AI 应用桌面应用交互助手猫抓浏览器扩展3分钟掌握网页视频下载的终极解决方案猫抓浏览器扩展3分钟掌握网页视频下载的终极解决方案 你是否曾遇到过这样的烦恼在线看到精彩的教学视频却无法保存想要收藏喜欢的音乐却找不到下载入口或者需要将人工智能AI 应用桌面应用交互助手上一篇FFmpegFreeUI40视频编码器的Windows图形界面终极解决方案下一篇3分钟搞定Axure全版本汉化告别英文界面困扰的终极指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
