ClawX 桌面端 AI Agent 图形编排客户端

这是什么？适合谁？

ClawX（ValueCell-ai/ClawX）是 OpenClaw AI Agents 的桌面图形界面客户端：OpenClaw 的编排能力原本以 CLI 形态存在，ClawX 把它变成「下载、安装、点选」的桌面体验——Setup Wizard 引导完成 Provider 配置与验证，Skill Bundles 预置常见场景技能包，会话、工具调用、执行过程全部可视化，全程不碰终端。技术栈 Electron 40+ / React 19，TypeScript，MIT 协议，官网 claw-x.com（中国站 clawx.com.cn）。2026-09-25 核验：GitHub 7,607★ / 1,143 fork，最近 push 2026-09-23，迭代活跃。

适合人群：

• 想用 OpenClaw Agent 编排但不想碰命令行的运营/创作者：自动化工作流、频道管理、定时任务
• 需要「桌面级」Agent 管理体验的 Windows 用户：原生支持 Windows 与多语言设置
• 团队推广 Agent 使用时给非技术成员的入口：图形化配置降低上手门槛

不适合谁：需要深度定制 Agent 内核的开发者（直接用 OpenClaw CLI 更灵活）；完全离线环境（Provider 调用需联网）。

准备工作

• 运行环境：macOS 11+ / Windows 10+ / Linux（Ubuntu 20.04+）；内存 4GB 起步（8GB 推荐）；磁盘 1GB；Computer Use 需 macOS 13+（x64/arm64）或 Windows 10+ x64
• 账号与费用：软件免费开源（MIT）；AI 能力费用取决于你接入的 Provider（自带 API key 或 OAuth 登录）；企业版/专属服务支持另议（见官网）
• 时间预算：安装 5 分钟；Setup Wizard 10 分钟；跑通第一个 Agent 15 分钟
• 前置知识：零（Setup Wizard 引导一切）；会用一个 AI Provider 的账号即可
• 替代方案：OpenClaw 原生 CLI（同能力、终端形态）；其他 Agent 桌面客户端

五步核心流程

第一步：下载安装

从 Releases 下载对应平台安装包。开发者可源码构建：

git clone https://github.com/ValueCell-ai/ClawX.git
cd ClawX
pnpm run init
pnpm dev

第二步：Setup Wizard

首次启动四步引导：语言与地区（自动预选系统语言）→ AI Provider（API key 或支持浏览器/设备 OAuth 的 Provider）→ Skill Bundles（按常见用例预配置的技能包）→ 验证（测试配置通过后进入主界面）。

第一步验证：跑通第一个 Agent

主界面创建会话，直接下达任务：

每天早上 8 点汇总我关注的三个 Telegram 频道的要点，生成一页简报

预期产出：Agent 的规划、工具调用、执行进度在图形界面逐步呈现；任务产物（简报）出现在会话中。全程未打开终端即完成 OpenClaw 编排。

第四步：代理与 Gateway 设置

Settings → Gateway → Proxy：配置默认代理（如 http://127.0.0.1:7890）、bypass 规则、开发者级 HTTP/HTTPS/ALL_PROXY/SOCKS 覆盖。Telegram 等需要经本地代理出网的频道同步依赖此设置。

第五步：按需开启 Computer Use

默认关闭。路径：Settings 开启 Developer Mode → 侧栏出现 Computer Use → 启用；macOS 需显式选择 Request Permissions（辅助功能 + 屏幕录制，未授权时页面会显示指引而非静默失败）。捆绑 CUA SDK/Driver 0.25.0，启动即以 CUA_DRIVER_RS_TELEMETRY_ENABLED=false 关闭 CUA 产品遥测；~/.openclaw/skills/computer-use 目录由 ClawX 全权管理（每次启动替换同名差异安装，自定义变体须换名）。

常见踩坑

1. Computer Use 开了却「看不见」屏幕：截图成功 ≠ 模型能看到图——必须用支持图像输入的模型与 Provider 端点；报「screenshots unsupported」时先查模型，别继续盲打键盘（官方 README 明示）。
2. macOS 权限授予后仍不生效：授权对象要看准——开发模式启动时权限可能归属于终端或 IDE（如 Ghostty/VS Code）而非 ClawX 本体；改授权后需重启 ClawX 及其启动器。
3. web_search 用不了不是 bug：ClawX 在 Agent 与 Gateway 两层禁用了 OpenClaw 通用 web_search 工具（含 Kimi 搜索）；托管浏览器自动化与 web_fetch 仍可用。
4. 同名 computer-use Skill 被覆盖：ClawX 每次启动都会把 ~/.openclaw/skills/computer-use 替换为当前捆绑版（含你的手动修改）；自定义变体必须换 Skill 名与目录。
5. Computer Use 不受「取消」保护：取消 exec 无法撤回已放行的原生操作，不是紧急停止保证；重要外部动作务必开确认。
6. 上下文压缩后行为变化：Compaction 预留 25% 上下文窗口（无元数据时保守回落 50,000 token），完成轮次经摘要继续而非原样重放——对话风格可能变化，Developer Mode 可查实际预留值。

常见问题 FAQ

Q1：ClawX 和 OpenClaw 什么关系？

A：ClawX 是 OpenClaw 的桌面 GUI 客户端——编排引擎、Skills 生态都是 OpenClaw 的，ClawX 提供安装配置、会话管理、Gateway 设置、频道同步的图形化体验，不替代 CLI。

Q2：支持哪些系统？

A：macOS 11+、Windows 10+、Linux（Ubuntu 20.04+）；Computer Use 子功能需 macOS 13+ 或 Windows 10+ x64，其余平台照常运行（无此功能）。

Q3：数据安全吗？

A：桌面本地运行，会话数据在本机；AI 调用走你配置的 Provider。注意：截图喂给视觉模型会把截图内容发给 Provider——敏感窗口别出现在捕获范围（官方明示）。

Q4：内置了哪些 Agent 工具的取舍？

A：禁用 web_search、gateway、nodes、create_goal、get_goal、update_goal（双层策略）；消息、会话编排、Agent 发现与托管浏览器自动化、web_fetch 保留。

Q5：企业团队怎么用？

A：官网提供 enterprise edition、专属服务支持与定制（claw-x.com）；OSS 版功能完整可自用，MIT 协议。

权限、安全、成本与限制

• 许可：MIT。
• 安全：Computer Use 涉及屏幕捕获与系统级操控，macOS 权限显式申请、可随时禁用（禁用不撤销系统授权，需在系统设置移除）；CUA 遥测默认关闭；web_search 等工具双层禁用收窄攻击面。
• 成本：软件免费；AI 费用 = 你接入的 Provider 计费；Computer Use 需视觉模型（通常更贵）。
• 限制：Computer Use 平台受限（macOS 13+/Win10 x64）；Windows 0.25.0 的启动/CLI 输出/闪窗行为官方标注仍需原生验证；本文基于官方 README 撰写，未做长期生产实测。

小技巧

1. 先在 Setup Wizard 里只配一个 Provider 跑通验证，再回 Settings 加多 Provider——一次配多个出问题时难定位。
2. Skill Bundles 按「当前最想自动化的场景」选，别贪多全装，桌面端管理开销会上升。
3. Developer Mode 里能看到 Compaction 实际预留值与高级配置，长会话任务前先看一眼，避免中途压缩风格漂移。
4. 中国大陆用户直接用 clawx.com.cn 获取安装与文档，网络路径更稳。
5. Discord 社区（README 徽章入口）活跃，安装问题先搜再问，响应很快。

进阶学习方向

• OpenClaw 生态纵深：ClawX 之外直接学 OpenClaw CLI 与 Skills 机制，理解 GUI 之下发生什么（exec/read 工具链、Gateway RPC）。
• Computer Use 工程细节：读仓库 harness/reference/computer-use-cli-validation.md 与 computer-use-skill.md，理解 0.25.0 的遥测抑制与 Windows PE patch 的验证历史。
• 频道自动化：Telegram 同步 + 代理设置的组合是高频场景，官方 docs/en-US/proxy-settings.md 有完整 fallback 行为说明。
• 企业部署：官网 enterprise 页面了解集中配置与服务支持形态。

参考链接

• 官方仓库
• 官网
• 中国官网
• Releases 下载