人工智能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 是一款把 OpenClaw 命令行 AI 编排体验搬进桌面的 Electron 应用其核心工程难点在于桌面 UIRenderer与 OpenClaw 运行时Gateway之间所有数据的流动方式。本文以仓库中的运行时桥接场景规格 gateway-backend-communication.md 为骨架结合 shared/host-api/contract.ts、src/lib/host-api.ts、electron/services/gateway-api.ts 与 electron/gateway/manager.ts 等源码系统讲解 ClawX 前后端通信的唯一合法路径、类型化 RPC 桥的实现细节、配置交付事务、心跳存活检测以及 Gateway 会话目录、定时任务、本地 HTML 预览和 Computer Use 等功能的 Main 进程所有权边界。读完本文你将掌握 ClawX 通信架构的分层职责划分能准确判断哪些代码该放 Renderer、哪些必须由 Electron Main 拥有并理解 Gateway 心跳与恢复的完整安全模型。通信全景允许的数据流只有一条ClawX 中桌面 UI 与 OpenClaw 后端服务之间的数据移动覆盖了聊天、Agent、频道、定时任务、Skills、文件、语音、浏览器等所有路径。这条路径被严格限定为一个方向、三层跳转Renderer 页面/组件 - src/lib/host-api.ts 或 src/lib/api-client.ts类型化门面 - Electron Main 的类型化宿主服务或 IPC 处理器 - Main 进程持有的 OpenClaw Gateway WebSocket - 运行时结果回传 - store/UI 更新这条链路在场景规格中被标记为Allowed flow即唯一允许的流程。反过来规格明确禁止 Renderer 承担以下任何职责不得拥有传输选择权HTTP 还是 WebSocket、走哪条协议由 Main 进程决定Renderer 不参与。不得直接调用 IPC 通道禁止window.electron.ipcRenderer.invoke(...)。不得直接调用 Gateway HTTP 接口包括127.0.0.1:18789与localhost:18789两个地址。不得自建重试策略与协议回退逻辑WS - HTTP - IPC的协议切换属于 Main 进程的传输策略。不得创建直连 Gateway 的 WebSocket 连接Gateway 帧级诊断必须由 Main 进程的 Gateway 日志输出而不是让 Renderer 直连观测。这些禁令不是建议而是硬约束。场景规格的forbiddenPatterns元数据直接列出了会被拒绝的模式清单src/pages/**与src/components/**中出现window.electron.ipcRenderer.invoke、src/**中出现指向127.0.0.1:18789或localhost:18789的fetch/new WebSocket均属于违规。配套规则 backend-communication-boundary.md 进一步规定新后端接口必须先经由 Electron Main 或宿主 API 层暴露Renderer 才能消费任何通信路径变更必须运行comms测试档位若通信结果改变了可见 UI 状态还必须补齐对应的 Electron E2E 覆盖。传输策略红线为什么 Renderer 永远不碰传输层api-client-transport-policy.md 把这条原则表述得最为直接Gateway RPC 传输是 IPC-only。Renderer 代码不得启用指向 OpenClaw Gateway 的 WebSocket 或 HTTP 传输Renderer 只能通过类型化 host-api 或遗留 IPC 包装器调用 Main而 Main 独占 Gateway WebSocket。host-api-fallback-policy.md 则记录了历史上曾经存在、如今已被移除并禁止复辟的本地 Host API HTTP 服务器与浏览器回退到http://127.0.0.1:13210方案。也就是说ClawX 曾经尝试过让 Renderer 走本地 HTTP 服务获取后端数据后来整体收敛为typedhostApi.module.action()门面 host:invoke桥这一唯一通道。这个历史演进恰好解释了为什么 src/lib/host-api.ts 中的每个方法都只是薄薄一层包装它们统一调用invokeHost(module, action, payload)实现在 src/lib/host-api-client.ts把类型化参数转发给 preload 暴露的桥接通道。Host API 契约全景一个文件定义全部后端能力类型化桥的契约全部收敛在 shared/host-api/contract.ts 的HostApiContract类型中。它按模块组织覆盖了 ClawX 桌面端几乎全部的后端能力模块代表动作说明appopenClawDoctor运行 OpenClaw Doctor 诊断/修复diagnose/fix 两种模式openclawstatus、getConfigPath、getSkillsDir、getCliCommandOpenClaw 安装状态与路径信息shellopenExternal、showItemInFolder、openPath系统级文件/链接操作webBrowsernavigate、openExternal受管 Web Browser 的导航与外部打开dialogopen、message原生文件选择与消息对话框windowminimize、maximize、close、syncTrafficLightPosition主窗口控制updatescheck、download、install、setChannel更新检查与安装settingsgetAll、set、setMany、reset桌面设置快照读写computerUsestatus、setEnabled、requestPermissions本地 Computer Use 的启用与权限gatewaystatus、start、stop、restart、health、controlUi、rpcGateway 生命周期、健康检查与泛型 RPClogsrecent、memory、listFiles、readFile日志查看channelsaccounts、validateCredentials、saveConfig、bindingSave、dingtalkWorkspaceAuth*频道账号、凭据校验、绑定与工作区授权agentslist、create、update、delete、assignChannelAgent 生命周期diagnosticsgatewaySnapshot、acpTrace、exportIssueReport诊断快照、ACP 轨迹与问题报告导出providerslist、validateKey、save、createAccount、requestOAuth模型供应商与账户管理filesstagePaths、readText、listTree、resolveAttachment文件暂存、读取、附件解析mediathumbnails、saveImage、imageGenerationSettings缩略图与图片生成sessionsdelete、rename、summaries、history、turnTimings会话管理chatgetAcpSessionFamily、loadAcpSession、sendAcpPrompt、cancelAcpSession、respondAcpPermissionACP 聊天桥cronlist、create、trigger、sessionHistory定时任务管理skillslocal、updateConfig、clawhubSearch、clawhubInstall本地 Skills 与 ClawHub 市场usagerecentTokenHistoryToken 用量历史asrgetMicrophoneAccess、getConfig、transcribe语音听写ASR其中gateway.rpc的载荷类型值得单独注意。契约中的GatewayRpcPayload只有三个字段export type GatewayRpcPayload { method: string; params?: unknown; timeoutMs?: number; };这印证了场景规格的判断ClawX 的泛型 RPC 通道是无特化的裸通道——没有针对 Chat 历史/发送的专用逻辑没有轮询队列、合并或背压层。所有面向具体业务的语义如 ACP 的session/load、session/prompt、session/cancel由各自独立的服务层在更高层级实现。泛型 Gateway RPC 的实现gateway-api.ts 的校验与直接委派泛型 RPC 的 Main 侧实现在 electron/services/gateway-api.ts 的createGatewayApi(gatewayManager)中。它暴露出status/start/stop/restart/health/controlUi/rpc七个动作其中rpc的动作最有代表性方法名校验method必须是非空字符串先trim()再判空否则抛出Invalid gateway RPC method。硬性拒绝talk.*前缀任何talk.*方法直接抛出Talk Gateway RPCs are not supported从入口处封死未经授权的对话类调用。超时参数校验parseTimeoutMs要求timeoutMs必须是有限正数Number.isFinite且 0否则抛出Invalid gateway RPC timeout。直接委派校验通过后调用gatewayManager.rpc(method, params, timeoutMs)把请求原样交给 GatewayManager。与之对应的 Renderer 侧用法见 src/lib/host-api.tsgateway: { status: () invokeHost(gateway, status), health: (probe false) invokeHost(gateway, health, { probe }), controlUi: () invokeHost(gateway, controlUi), rpc: T unknown(method: string, params?: unknown, timeoutMs?: number) ( invokeHost(gateway, rpc, { method, params, timeoutMs }) as PromiseT ), },从调用链看GatewayManager.rpc是唯一通向 Gateway WebSocket 的委托点electron/gateway/manager.ts也是心跳探针后文详述使用的同一通道。这种单点委派设计保证任何新增的 Gateway 能力只要它走泛型 RPC都自动获得统一的校验、超时与日志治理。配置交付事务config.get / config.set 的协调者契约ClawX 对 OpenClaw 配置的修改不是写完就通知的草率设计而是由一个 Main 进程独占的协调者统一执行。其完整契约记录在 openclaw-config-delivery.md核心是五步事务Gateway 运行时以运行态配置为准调用config.get要求返回运行态形状的config对象与hash只有旧版响应才接受raw作为兼容回退。克隆-修改-提交克隆运行态配置应用 mutatorProvider、Agent、Channel、Skill、Proxy、图片生成、插件安装等模块的配置变更都以 mutator 表达然后调用config.set提交序列化结果与baseHash: hash。规格特别提醒以源码形状的raw作为基线可能与 OpenClaw 运行态还原基线错位导致脱敏密钥路径失配。冲突重试与丢包自愈遇到一次baseHash冲突从全新的config.get重试一次其他 RPC 错误直接失败绝不绕过运行中的 Gateway 自行写盘。若config.set已持久化写入但响应因 OpenClaw 原生 code-1012 重载而丢失则在 Gateway 离开运行态后核对已持久化的快照确认后接受既有提交而不重放无法确认时将 mutator 重放于持久化文件并从变更前快照恢复__OPENCLAW_REDACTED__字段。收敛即止提交成功视为收敛不发送SIGUSR1也不安排冗余的 ClawX 进程替换。Gateway 未运行时走文件Gateway 停止或启动中时在共享配置锁下把同一 mutator 应用到resolveOpenClawConfigPath()且不启动 Gateway。这条契约还包含两个安全细节Gateway WebSocket 追踪必须对config.set、config.patch、config.apply的完整序列化raw载荷做整体脱敏基于 key 的结构化脱敏无法检查内嵌在字符串中的密钥协调者托管的读取遵循同样的权威规则——Gateway 运行时优先读运行态config.get.config否则用 JSON5 解析配置文件复合视图的所有配置字段必须来自同一份快照。此外OpenClaw 2026.7.1-2 在内存中持有认证配置文件的 SQLite 快照ClawX 在认证写入批次完成后、Gateway 运行时调用一次secrets.reloadconfig.set不替代该刷新而 Agent 的models.json因 OpenClaw 会在文件指纹变化时重读无需额外 RPC。网关心跳与存活检测180 秒沉默与 5000ms 探针Gateway WebSocket 心跳是 ClawX 通信可靠性的最后防线其规则由 gateway-heartbeat-safety.md 与场景规格共同定义。核心设计哲学是心跳丢失只是诊断性可用性信号绝不能直接打断 socket 或进程。具体模型如下可信存活证据收到 pong、收到任何入站 Gateway 帧、或一次成功的 Gateway RPC三者任一即视为存活重置 180 秒的无存活静默截止线。Chat、工具、cron 或其他工作负载的进行不能延长该截止线。单次探针仅当连续 180 秒没有任何可信存活证据Main 才执行恰好一次system-presence核心 RPC 验证超时 5000ms。system-presence在 electron/gateway/manager.ts 中正是通过this.rpc(system-presence, {}, 5_000)发出。探针成功记录存活、取消恢复流程不重连、不重启。探针失败后的分级处置只有当 Gateway 是 ClawX 自有进程且自动恢复与生命周期状态允许时才可能走守卫式的GatewayManager.restart对于外部托管的 GatewayClawX 只能重连自己的传输、把不可用状态暴露为诊断绝不自动stop、shutdown或restart该 Gateway。独立生命周期路径保持不变权威的子进程退出、普通 WebSocket 关闭、Gateway 重启的 code-1012 关闭、显式用户重启都继续走各自原有的生命周期处理不受心跳逻辑影响。场景规格补充了一个细节观测到 OpenClaw 的[compaction-diag] start日志时只允许在探针失败后推迟自有进程的升级处置且推迟必须在[compaction-diag] end或有界超时后结束不能推迟截止线或探针本身。相关的单测覆盖包括 gateway-connection-monitor.test.ts、gateway-manager-heartbeat.test.ts 与 recovery-controller.test.ts。桌面工具策略预启动配置净化器维护的双层拒绝清单ClawX 的预启动配置净化器同时负责桌面工具策略在 Agent 层与 Gateway 层两个层面维护拒绝清单必须保留web_search拒绝web_search在 Agent 级与 Gateway 级拒绝清单中都保持拒绝状态同时不得替换已有拒绝条目也不得禁用受管的浏览器自动化与web_fetch。必须拒绝面向 Agent 的管理类工具gateway、nodes、create_goal、get_goal、update_goal必须在两层同时拒绝但保留应用自有的 Gateway RPC 通道不受影响。消息、会话编排与 Agent 发现工具保持可用除非另有显式策略拒绝这些工具不得被净化器误伤。这一策略体现了场景规格反复强调的能力所有者原则哪些工具 Agent 能见、哪些只有应用内部的 RPC 能触达由 Main 进程的预启动逻辑统一裁决Renderer 无权调整。定时任务历史cron.runs 是权威数据源定时任务cron历史属于 Main 进程拥有的后端数据。规则如下优先走 Gateway RPC当前 OpenClaw 版本必须通过 Gateway 的cron.runsRPC 查询运行历史。文件读取仅为兼容回退直接读取运行日志文件只允许作为旧版文件型运行时的兼容性回退。截断恢复规则当一条运行的有界摘要以 OpenClaw 的截断省略号结尾时Main 可以从该cron.runs条目标识的运行转录中恢复完整的最终助手回复前提是转录中的回复更长且与摘要前缀完全一致。历史时间线投影当 cron 基础会话没有 ACP 回放时Renderer 可以把类型化宿主结果投影为生成作用域、内存中的历史 ACP 时间线但不得替换或重复非空的 ACP 回放。本地 HTML 预览桥与 Web Browser 边界本地 HTML 预览是一个由 Main 进程拥有的特权桥Renderer 只能通过类型化 Host API 加载一个已经过校验的本地 HTML 文件或把当前文件交给外部程序打开。规格明确说明guest预览宿主只是现有preview标签页的实现细节不存在web-browser制品标签页也不提供通用地址栏导航可持久化的 guest 契约见 web-browser.md。这条边界防止了本地文件预览被滥用为任意网页浏览入口属于 Web Browser 安全与生命周期治理web-browser-security-and-lifecycle.md的一部分。本地 Computer UseMain 进程的独占权本地 Computer Use 是另一个典型的 Main 独占能力默认关闭其侧边栏页面受 Developer Mode 门控持久化 opt-in 与只读权限状态通过类型化 host-api 管理对应契约中的computerUse.status/setEnabled/requestPermissions只有显式的启用权限动作才能弹窗提示启动与激活过程绝不弹窗。Main 独占底层EmbeddedCuaHostDriver、原生 SDK/ASAR 加载、串行化的生命周期变更、内嵌守护进程监督全部由 Main 持有。连接描述符Main 原子性地发布私有描述符{ v: 2, generation, driverVersion, binaryPath, socketPath }到CLAWX_CUA_CONNECTION_FILE环境变量指定的位置禁用时停止守护进程并移除描述符不做插件策略对账。模型操作使用现有 OpenClawexec携带描述符中的绝对内置二进制与显式 socket以及支持图像能力的read读取工作区作用域的截图文件。无自定义扩展不引入自定义computer工具、OpenClaw 插件、MCP 代理、CLI 动作包装、node host、配对机制或node.invoke。原生窗口/AX/菜单/验证等固定 CLI 能力在受支持的平台上可用与主屏捕获/输入并列而非 ClawX 动作子集。版本固定CUA SDK、原生驱动与官方 Skill 一起固定在 0.25.0tagcua-driver-rs-v0.25.0commit45d78fedcf2c7033ba33f10dd30f8af8ba31ec3fMain 守护选项与 macOS/Windows Gateway CLI 子环境都设置CUA_DRIVER_RS_TELEMETRY_ENABLEDfalseSDK 自 0.22.0 起支持该白名单同时保留 Windows 的 console-to-GUI PE 补丁——上游遥测仍走cmd /c ver升级不是自动的无窗口修复。配套的computer-useSkill 保留/computer-use命令包含 MIT 许可的离线文档与简短的 ClawX 入口。ClawX 拥有同名安装的完整管理权见 managed-computer-use-skill.md每次启动比较路径/内容与当前 bundle替换所有差异包括用户编辑与多余文件/目录跳过无历史安装哈希的匹配内容全新安装与替换安装都在发现范围外暂存完整 bundle 并保留发布回滚/清理替换目标符号链接本身而不跟随或删除其外部指向自定义变体必须使用其他名称其他命名的 Skills 与设置不受影响。会话目录与 subagent 侧边栏订阅、标题与删除生命周期Gateway 会话目录session-catalog的订阅、归一化、有序列表/事件回放、注意力转换与重连恢复完整记录在 sidebar-session-attention.md场景规格补充了几条关键语义首条 prompt 决定标题发给新建非默认 Agent 的第一条 prompt 必须为其agent:id:main会话定标题ACP之类的合成传输显示名不得替换该标签重载后转录摘要水合必须恢复该标题。删除 Agent 是目录生命周期边界Main 确认破坏性配置/文件系统操作后Renderer 必须立即遗忘每条规范的agent:deletedId:行保留内存墓碑以拦截过期列表行与延迟事件并在不等待 Gateway 重启的情况下修复选择。带有相同 ID 的权威 Agent 快照可以清除墓碑以支持重建而先于已确认变更发出的 Agent 列表请求不得在之后发布或对账。会话索引或条目已缺失属于幂等的会话删除成功畸形索引与不安全的转录路径仍是失败。subagent 隐藏只是展示层完整的四段式键agent:agentId:subagent:childId仍保留在共享 Gateway 目录中用于精确键注意力、运行状态、路由、工作区清理与精确非级联删除但被排除在侧边栏分组与所有隐式回退候选集之外。血缘与标题的唯一权威Main 通过类型化 Host API 查询有界 ACPsession/listsession/list是所选会话直属家庭的唯一血缘成员关系与标题权威而一次已完成的sessions_spawn结构化结果只是失效信号。目录中最新精确键的存在性门控着当前子项的可见性、可操作性及直接父项返回目标可用性但存在性本身不产生血缘成员关系或标题。运行状态权威对可见子项Gatewaystatus与hasActiveRun是共享运行投影的唯一权威精确键observedBusy只是既有未知状态回退显式终态覆盖该回退ACP prompt 与本地发送状态不是子运行状态权威。被动订阅已加载的 ACP 会话可保留一个被动、Main 拥有的sessions.messages订阅使后续该精确会话无待处理announce:v1运行时能按记录的 ACP 更新发出适配器在获取回放前订阅并缓冲精确会话的 Chat 与 Agent 事件直到回放基线建立。Renderer 与 Main 都不把 Gateway 历史或转录文本当作替代的 Chat 传输。频道与插件的迁移守卫频道/插件迁移也是本场景的一部分ClawX 在 Gateway 启动前重写 OpenClaw 配置时升级必须保持迁移后的插件支撑频道如飞书/Lark的单所有者频道注册。桌面 Chat 会话没有频道账户上下文内置的 WeCom 业务工具仅当恰好配置了一个 WeCom 账户时才允许回退多账户歧义选择必须被拒绝。相关守卫见 channel-plugin-migration-guards.md 与 wecom-plugin-account-fallback.test.ts。工程落地规则、测试档位与质量保障场景规格通过requiredProfiles、requiredRules与conditionalProfiles把上述全部约束绑定到具体工程流程comms档位任何通信路径变更必须通过comms测试档位若通信结果改变可见 UI 状态还必须运行或新增相关 Electron E2E 覆盖e2e条件档位触发条件包括用户可见的 Gateway 状态变化、Chat 收发行为变化、频道/Agent/设置 UI 依赖新后端响应形状、Web Browser 或 Computer Use 行为变化、语音听写权限检测变化等。规则清单renderer-main-boundary、backend-communication-boundary、api-client-transport-policy、host-api-fallback-policy、gateway-readiness-policy、gateway-heartbeat-safety、capability-owner-resolution、sidebar-session-attention-authority、web-browser-security-and-lifecycle、local-computer-use等规则共同构成通信与能力归属的宪法。测试覆盖核心链路有 host-api-facade.test.ts、host-invoke.test.ts、gateway-ws-client.test.ts、gateway-manager-heartbeat.test.ts、gateway-connection-monitor.test.ts、session-status.test.ts、session-catalog.test.ts、session-attention.test.ts、session-key-utils.test.ts 与 E2E 的 chat-sidebar-session-attention.spec.ts 等Electron 测试进程隔离与全局资源调度见 e2e-parallelism.md。小结一套能力所有者驱动的通信架构纵览整个场景ClawX 后端通信架构可以浓缩为三条原则传输单一化Renderer 永远经由类型化 Host API 走 IPCMain 独占 Gateway WebSocket、能力所有者化配置交付、cron 历史、HTML 预览、Computer Use、会话目录与工具策略都由明确的 Main 进程所有者负责Renderer 只消费结果、恢复保守化心跳丢失只是诊断信号探针只在 180 秒静默后运行一次外部托管的 Gateway 永不被自动停止或重启。理解这三条原则就理解了 ClawX 为什么能在不暴露终端的前提下把 OpenClaw 的全部运行时能力安全、可控地搬进桌面体验。赞分享人工智能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 桌面端完整指南基于 OpenClaw 的 AI 智能体图形化界面、本地 Computer Use 与 Gateway 架构解析ClawX 桌面端完整指南基于 OpenClaw 的 AI 智能体图形化界面、本地 Computer Use 与 Gateway 架构解析 ClawX 是面向人工智能AI 应用桌面应用交互助手ClawX 桌面 AI 代理客户端指南基于 OpenClaw 的图形化编排、架构与开发实战ClawX 桌面 AI 代理客户端指南基于 OpenClaw 的图形化编排、架构与开发实战 ClawX 是一款构建于 OpenClaw AI 代理运行时之上的人工智能AI 应用桌面应用交互助手3层保护机制大气层Atmosphere如何为Switch玩家打造安全稳定的自定义系统环境3层保护机制大气层Atmosphere如何为Switch玩家打造安全稳定的自定义系统环境 当您想要为Nintendo Switch解锁更多可能性时面临的最大人工智能AI 应用桌面应用交互助手上一篇终极指南5步掌握Alist-strm批量生成strm文件下一篇高效macOS菜单栏任务管理工具Reminders MenuBar使用全攻略创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考