## 项目概述

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](https://github.com/ValueCell-ai/ClawX/releases) 页面下载对应平台的最新版本。

**从源码构建**：
```bash
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 仓库：https://github.com/ValueCell-ai/ClawX
- 中国官网：https://clawx.com.cn
- 最新版本：v0.5.3（发布于 2026-08-06）
- 社区：Discord（https://discord.com/invite/84Kex3GGAh）

## 信息来源和分析时间

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