ValueCell-ai / ClawX

ValueCell-ai/ClawX

open_in_new前往仓库

ClawX 是一款桌面应用，为 OpenClaw AI 代理提供图形界面，将基于命令行的 AI 编排转变为无需终端的桌面体验。中国官网：https://clawx.com.cn。

项目概览

项目概述

ClawX 是一款基于 OpenClaw 的桌面应用，为 AI 智能体提供图形化界面，将命令行 AI 编排转变为无需终端的桌面体验。它基于 Electron 和 React 构建，支持 macOS、Windows 和 Linux 平台，并内置了最佳实践的模型提供商配置。项目采用 MIT 许可证，当前最新版本为 v0.5.3。

核心功能

  • 零配置门槛：通过图形界面完成全部设置，无需终端命令或 YAML 文件。
  • 智能聊天界面：支持多会话、流式 Markdown 渲染、语法高亮、CJK 解析、表格、KaTeX 数学公式、@agent 路由和 /skill 卡片。
  • 多频道管理：配置和监控多个 AI 频道，支持多账号、账号绑定和默认账号切换，内置腾讯个人微信插件。
  • 定时任务自动化：基于 Cron 的调度，支持周期性和一次性任务，可插入技能并投递到外部频道。
  • 可扩展技能系统：本地优先的技能管理，支持从多个 OpenClaw 来源发现技能，内置文档处理技能（pdf、xlsx、docx、pptx）。
  • 安全供应商集成：支持 OpenAI、Anthropic、Z.AI / GLM 等，凭证存储在系统密钥链中，支持 OAuth 和自定义供应商。
  • 自适应主题：浅色、深色或跟随系统。
  • 启动控制与更新提示：可设置开机启动，启动时检查更新。

适用与不适用场景

适用场景：

  • 个人 AI 助手：回答问题、起草邮件、总结文档。
  • 自动化监控：定时监控新闻、价格或特定事件。
  • 开发者生产力：代码审查、文档生成、重复编码任务。
  • 工作流自动化：将多个技能串联成自动化流水线。

不适用场景：

  • 需要完全离线运行的环境（依赖外部 AI 提供商）。
  • 需要深度定制底层 OpenClaw 核心的场景（ClawX 封装了运行时）。
  • 对终端操作有强需求的用户（ClawX 旨在替代终端）。

技术架构与依赖

ClawX 采用双进程架构，包含 Electron 主进程和 React 渲染进程，通过类型化 IPC 通信。主进程负责窗口管理、Gateway 进程监督、系统集成和自动更新；渲染进程提供 UI；OpenClaw Gateway 提供 AI 编排、频道和技能能力。聊天使用 ACP（Agent Client Protocol）通过 stdio 桥接。

主要依赖：Electron 40+、React 19、TypeScript、Tailwind CSS、shadcn/ui、Zustand、Vite、electron-builder、Vitest、Playwright、Framer Motion、Lucide React。

安装与快速开始

系统要求

  • 操作系统：macOS 11+、Windows 10+ 或 Linux（Ubuntu 20.04+）
  • 内存：4GB 最低（推荐 8GB）
  • 存储：1GB 可用空间

安装

预构建版本（推荐）：从 Releases 页面下载对应平台的最新版本。

从源码构建：

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

首次启动

首次启动时，设置向导会引导配置语言、AI 提供商、技能包和验证。

典型使用方法

  1. 配置 AI 提供商：在设置中添加 OpenAI、Anthropic 等提供商的 API 密钥或通过 OAuth 登录。
  2. 创建聊天会话：在聊天界面与 AI 智能体对话，可使用 @agent 路由到特定智能体。
  3. 管理频道：在 Channels 页面配置多个频道，绑定账号和智能体。
  4. 设置定时任务：在 Cron 页面创建定时任务，选择频率、插入技能并配置投递目标。
  5. 管理技能：在 Skills 页面启用、禁用或发现技能。

配置与部署要点

  • 代理设置：在设置中配置代理，支持 HTTP、HTTPS 和 SOCKS，保存后自动重启 Gateway。
  • 开发者模式：在设置 -> 高级 -> 开发者模式中可进行高级配置，如自定义 User-Agent、图像生成端点等。
  • Gateway 管理：Gateway 监听 127.0.0.1:18789，确保单实例运行。
  • 安全存储：API 密钥存储在系统密钥链中。
  • 更新机制：启动时检查更新，用户确认后下载安装。

限制、风险与许可证

  • 限制：ClawX 禁用 OpenClaw 的通用 web_search 工具（包括 Moonshot/Kimi 搜索），但保留托管浏览器自动化和 web_fetch。
  • 风险：依赖外部 AI 提供商，可能涉及数据隐私；使用第三方插件需注意安全。
  • 许可证：MIT License，允许自由使用、修改和分发。

官方链接

信息来源和分析时间

本指南基于 GitHub 仓库 ValueCell-ai/ClawX 的 README、文档（docs/en-US、docs/zh-CN 等）和最新发布信息，分析时间为 2026-08-06。