ClawX：OpenClaw 智能体桌面客户端

项目简介

ClawX 是构建在 OpenClaw 之上的桌面应用，把原本依赖命令行的 AI 智能体编排，变成直观的图形界面体验，无需打开终端即可使用。它直接内嵌 OpenClaw 运行时，不要求另行安装，并尽量与上游保持同步，从而沿用官方最新的能力与生态兼容性。

项目使用 Electron 40+ 与 React 19 开发，采用 TypeScript 编写，支持 macOS、Windows 与 Linux，遵循 MIT 许可证。官网为 https://claw-x.com ，中国站点为 https://clawx.com.cn 。

主要功能

• 零配置门槛：通过图形向导完成全部设置，不必写 YAML 文件或翻找环境变量。
• 智能聊天界面：多会话上下文与历史、流式 Markdown 与语法高亮、表格、KaTeX 数学公式；支持 @agent 直接路由、内联 /skill 卡片、子智能体状态与只读下钻；可只读预览 Markdown、.docx、.pptx 和本地 HTML。使用 Cmd+N（macOS）、Ctrl+N（Windows/Linux）或 File → New Chat 新建对话。
• 语音听写（开发者模式）：在设置中开启开发者模式后，可用麦克风录音，经由用户自行配置的语音转文字服务转写并插入光标处；在 Models -> Speech-to-text 中选择 API 类型与预设，支持自定义端点。
• 智能体生命周期管理：在桌面端创建与管理专用智能体；删除非默认智能体需明确确认，并会永久移除其工作区与聊天历史。
• 问题报告导出：从侧边栏或 Settings > Support 查看打包内容，并生成包含脱敏 OpenClaw 配置与诊断日志的 ZIP 文件。
• 多渠道管理：配置与监控多个独立 AI 频道，支持多账号、按账号绑定智能体、默认账号切换，内置腾讯个人微信官方频道插件，并支持钉钉连接器。
• 定时自动化：定义周期性或一次性计划任务，在提示词中插入技能，并把结果投递到外部频道。
• 可扩展技能系统：本地管理技能而不依赖 Gateway，可从多个 OpenClaw 来源发现技能，并内置 pdf、xlsx、docx、pptx 文档处理技能。
• 安全的模型接入：支持 OpenAI、Anthropic、Z.AI / GLM 等提供商，凭据保存在系统原生钥匙串；中文界面下还提供带浏览器 OAuth 的 TokenDance。
• 本地 Computer Use：在 macOS 13+（Intel 或 Apple 芯片）与 Windows x64 上，智能体可通过内置 CUA CLI 执行窗口、辅助功能、菜单等桌面操作。
• 其他：浅色/深色/跟随系统主题、开机自启动、启动时检查更新并提示是否下载或安装。

安装与使用

系统要求：macOS 11+、Windows 10+ 或 Linux（Ubuntu 20.04+）；内存最低 4GB（推荐 8GB）；磁盘空间 1GB。Computer Use 功能需要 macOS 13+（x64/arm64）或 Windows 10+（x64）。

预编译版本（推荐）：从 Releases 页面下载对应平台的安装包，包括 macOS 的 .dmg（Apple Silicon 与 Intel）、Windows 的 .exe（x64 / ARM64）、Linux 的 .AppImage、.deb、.rpm。

从源码构建：

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

首次启动：设置向导会依次引导你配置语言与地区、AI 提供商（API Key 或支持浏览器/设备登录的 OAuth）、技能包，并在进入主界面前验证配置。向导会优先预选受支持的系统语言，否则回退到英语。

注意事项

• macOS：首次启动可能出现“无法验证开发者”，需前往系统设置 → 安全性与隐私中允许运行。
• Windows：SmartScreen 可能拦截程序，点击“更多信息”→“仍要运行”继续。
• Linux AppImage：先执行 chmod +x ClawX-*.AppImage 添加可执行权限；Ubuntu 22.04 可能还需 sudo apt install libfuse2，Ubuntu 24.04 使用 libfuse2t64。
• Linux .deb（Ubuntu 24.04）：若因缺少依赖安装失败，可先执行 sudo apt install libgtk-3-0t64 libnotify4t64 libxss1t64。
• 删除非默认智能体会同时永久删除其工作区与聊天记录，操作不可恢复。
• 语音听写需要系统麦克风权限；macOS 需在“隐私与安全性 → 麦克风”中启用 ClawX，并完全退出后重启应用。

本作品整理自 GitHub 开源项目 ValueCell-ai/ClawX，原作者 @ValueCell-ai，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。