ClawX

OpenClaw AI 智能体的桌面操作界面

功能特性 • 为什么选择 ClawX • 快速开始 • 架构设计 • 开发指南 • 贡献代码

English | 简体中文 | 日本語 | Русский

---

概述

ClawX 架起了强大 AI 智能体与普通用户之间的桥梁。它基于 OpenClaw 构建，将命令行式的 AI 任务编排转变为易用且美观的桌面体验——无需终端操作。

无论您是要自动化工作流程、管理 AI 驱动的渠道，还是调度智能任务，ClawX 都能提供所需的界面，助您高效驾驭 AI 智能体。

ClawX 预配置了最佳实践的模型提供商，原生支持 Windows 系统及多语言设置。当然，您也可以通过 设置 → 高级 → 开发者模式 进行高级配置的微调。

如需企业版、专属服务支持，或针对业务场景的定制化部署指导，请通过 public@valuecell.ai 与我们联系。

---

截图

---

为什么选择 ClawX

构建 AI 智能体不应要求您精通命令行。ClawX 的设计理念简单而明确：强大的技术理应搭配一个尊重您时间的界面。

挑战	ClawX 解决方案
复杂的命令行界面设置	一键安装，搭配引导式设置向导
配置文件	可视化设置，支持实时验证
进程管理	网关生命周期自动管理
应用更新	启动时检查更新，下载或安装前提示确认
多 AI 服务提供商	统一的提供商配置面板
技能/插件安装	内置技能市场及管理功能

内置 OpenClaw

ClawX 直接基于官方 OpenClaw 核心构建。无需单独安装，我们将运行时嵌入应用程序中，提供无缝的“开箱即用”体验。

我们致力于与上游 OpenClaw 项目保持严格一致，确保您始终能够获取官方版本所提供的最新功能、稳定性改进和生态系统兼容性。

启用开发者模式后，侧边栏还会提供原生的 Dreams 页面，用于 OpenClaw 内存查看、梦境日志检查和基本维护操作。当需要更深入的诊断时，可从该页面访问完整的上游 OpenClaw Dreams 用户界面。

---

功能特性

🎯 零配置门槛

通过直观的图形界面完成从安装到首次 AI 交互的整个设置流程。无需终端命令、无需 YAML 文件、无需查找环境变量。

💬 智能聊天界面

通过现代化的聊天体验与 AI 智能体进行交互。支持多对话上下文、消息历史记录、Markdown 富内容渲染（包括 GitHub 风格表格和 KaTeX 驱动的 LaTeX 数学公式：$inline$、$$block$$、\(inline\) 和 \[block\]），以及在主编辑器中使用 @agent 直接路由至多智能体设置。 从编辑器插入的技能将显示为 /skill-name 芯片；点击芯片可打开预览侧边栏，阅读该技能的 SKILL.md。 当使用 @agent 指向其他智能体时，ClawX 会直接切换到该智能体自己的对话上下文，而非通过默认智能体进行中继。智能体工作区默认保持分离，更强的隔离性取决于 OpenClaw 沙箱设置。 每个智能体还可以覆盖其自身的 provider/model 运行时设置；未进行覆盖的智能体将继续继承全局默认模型。

📡 多渠道管理

同时配置和监控多个 AI 渠道。每个渠道独立运行，让您可以为不同任务运行专用智能体。 每个渠道现在支持多账户、按账户智能体绑定，以及直接从渠道页面切换渠道默认账户。 对于自定义渠道账户 ID，ClawX 强制使用 OpenClaw 兼容的规范 ID（[a-z0-9_-]，小写，最多 64 个字符，必须以字母/数字开头），以防止路由不匹配。 ClawX 现在还捆绑了腾讯官方个人微信渠道插件，您可以通过应用内二维码流程直接从渠道页面关联微信。

⏰ 基于 Cron 的自动化

安排 AI 任务自动运行。定义触发器、设置时间间隔，让您的 AI 智能体无需人工干预即可全天候工作。 Cron 页面现在允许您在任务表单中直接配置外部交付，包含独立的发送者账户和接收者目标选择器。对于受支持的渠道，接收者目标会从渠道目录或已知会话历史中自动发现，因此您不再需要手动编辑 jobs.json。

🧩 可扩展技能系统

通过预置技能扩展您的 AI 智能体。无需包管理器，直接通过集成的技能面板浏览、安装和管理技能。

ClawX 还预捆绑了完整的文档处理技能（pdf、xlsx、docx、pptx），启动时会自动将其部署到托管技能目录（默认 ~/.openclaw/skills），并在首次安装时默认启用。额外的捆绑技能（find-skills、self-improving-agent、tavily-search）也默认启用；如果缺少所需的 API 密钥，OpenClaw 会在运行时显示配置错误。
技能页面可展示从多个 OpenClaw 来源（托管目录、工作区和额外技能目录）发现的技能，现在还会显示每个技能的实际位置，方便您直接打开真实文件夹。

捆绑搜索技能的环境变量：

• TAVILY_API_KEY 用于 tavily-search（上游技能运行时可能也支持 OAuth）
• find-skills 和 self-improving-agent 不需要 API 密钥

🔐 安全的服务提供商集成

连接多个 AI 服务提供商（OpenAI、Anthropic 等），凭据安全存储在系统原生密钥链中。OpenAI 支持 API 密钥和浏览器 OAuth（Codex 订阅）两种登录方式。

对于与 OpenAI 兼容网关配合使用的自定义服务提供商，您可以在设置 → AI 服务提供商 → 编辑提供商中设置自定义 User-Agent，以适应对兼容性敏感的端点。

当兼容网关因非身份验证原因拒绝 /models 请求时，ClawX 在 API 密钥验证过程中会自动回退到轻量级的 /chat/completions 或 /responses 探测。

🌙 自适应主题

亮色模式、暗色模式或系统同步主题。ClawX 会自动适应您的偏好设置。

🚀 启动控制

在设置 → 通用中，您可以启用系统启动时运行，使 ClawX 在登录后自动启动。

🔔 更新提示

ClawX 可在启动时自动检查新版本。当有更新可用时，会在应用内显示提示；下载和安装仅在您选择操作后进行。

---

开始使用

系统要求

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

安装

预构建版本（推荐）

从 Releases 页面下载适用于您平台的最新版本。

从源代码构建

# Clone the repository
git clone https://github.com/ValueCell-ai/ClawX.git
cd ClawX

# Initialize the project
pnpm run init

# Start in development mode
pnpm dev

首次启动

首次启动 ClawX 时，设置向导将引导你完成以下步骤：

1. 语言与地区 – 配置你偏好的区域设置
2. AI 提供商 – 添加带有 API 密钥的提供商，或使用 OAuth（适用于支持浏览器/设备登录的提供商）
3. 技能包 – 为常见使用场景选择预配置的技能
4. 验证 – 在进入主界面之前测试你的配置

当系统语言受支持时，向导会默认选择该语言，否则将回退为英语。

关于 Moonshot（Kimi）的注意事项：ClawX 默认启用 Kimi 网络搜索功能。
配置 Moonshot 后，ClawX 还会将 Kimi 网络搜索同步至 OpenClaw 配置中的中国区端点（https://api.moonshot.cn/v1）。

代理设置

ClawX 内置代理设置，适用于 Electron、OpenClaw Gateway 或 Telegram 等渠道需要通过本地代理客户端访问互联网的环境。

打开 设置 → 网关 → 代理 进行配置：

• 代理服务器：所有请求的默认代理
• 绕过规则：应直接连接的主机，使用分号、逗号或换行符分隔
• 在 开发者模式 下，你可以选择性覆盖：
  • HTTP 代理
  • HTTPS 代理
  • ALL_PROXY / SOCKS

推荐的本地示例：

Proxy Server: http://127.0.0.1:7890

注意事项：

• 仅包含 host:port 的值将被视为 HTTP 协议。
• 若高级代理字段留空，ClawX 将回退使用“代理服务器”设置。
• 保存代理设置后，Electron 网络配置会立即重新应用，且网关将自动重启。
• 当 Telegram 功能启用时，ClawX 会将代理设置同步至 OpenClaw 的 Telegram 频道配置。
• 若当前 ClawX 代理处于禁用状态，网关重启后将保留已有的 Telegram 频道代理。
• 若需从 OpenClaw 配置中显式清除 Telegram 频道代理，请在禁用代理的状态下保存代理设置。
• 在 设置 → 高级 → 开发者 中，可运行 OpenClaw 诊断工具 来执行 openclaw doctor --json，无需离开应用即可查看诊断输出。
• 在打包的 Windows 版本中，捆绑的 openclaw 命令行界面/终端用户界面通过随附的 node.exe 入口点运行，以确保终端输入行为的稳定性。

---

架构

ClawX 采用双进程架构，并配备统一的宿主 API 层。渲染器与单一客户端抽象层通信，而 Electron 主进程负责协议选择和进程生命周期管理：

┌──────────────────────────────────────────────────────────────────┐
│                        ClawX Desktop App                         │
│                                                                  │
│  ┌────────────────────────────────────────────────────────────┐  │
│  │              Electron Main Process                         │  │
│  │  • Window & application lifecycle management               │  │
│  │  • Gateway process supervision                             │  │
│  │  • System integration (tray, notifications, keychain)      │  │
│  │  • Auto-update orchestration                               │  │
│  └────────────────────────────────────────────────────────────┘  │
│                              │                                   │
│                              │ IPC (authoritative control plane) │
│                              ▼                                   │
│  ┌────────────────────────────────────────────────────────────┐  │
│  │              React Renderer Process                        │  │
│  │  • Modern component-based UI (React 19)                    │  │
│  │  • State management with Zustand                           │  │
│  │  • Unified host-api/api-client calls                       │  │
│  │  • Rich Markdown rendering                                 │  │
│  └────────────────────────────────────────────────────────────┘  │
└──────────────────────────────┬───────────────────────────────────┘
                               │
                               │ Main-owned transport strategy
                               │ (WS first, HTTP then IPC fallback)
                               ▼
┌──────────────────────────────────────────────────────────────────┐
│                Host API & Main Process Proxies                   │
│                                                                  │
│  • hostapi:fetch (Main proxy, avoids CORS in dev/prod)           │
│  • gateway:httpProxy (Renderer never calls Gateway HTTP direct)  │
│  • Unified error mapping & retry/backoff                         │
└──────────────────────────────┬───────────────────────────────────┘
                               │
                               │ WS / HTTP / IPC fallback
                               ▼
┌──────────────────────────────────────────────────────────────────┐
│                     OpenClaw Gateway                             │
│                                                                  │
│  • AI agent runtime and orchestration                            │
│  • Message channel management                                    │
│  • Skill/plugin execution environment                            │
│  • Provider abstraction layer                                    │
└──────────────────────────────────────────────────────────────────┘

设计原则

• 进程隔离：AI 运行时在独立进程中运行，确保即使在大量计算期间 UI 也能保持响应
• 前端调用单一入口：渲染器请求通过 host-api/api-client 进行；协议细节隐藏在稳定接口之后
• 主进程传输所有权：Electron 主进程控制 WS/HTTP 的使用，并回退到 IPC 以确保可靠性
• 优雅恢复：内置重连、超时和退避逻辑，可自动处理瞬时故障
• 安全存储：API 密钥和敏感数据利用操作系统的原生安全存储机制
• 原生 CORS 安全：本地 HTTP 访问由主进程代理，避免渲染器端出现 CORS 问题

进程模型与网关故障排除

• ClawX 是一款 Electron 应用，因此一个应用实例通常会显示为多个操作系统进程（主进程/渲染进程/zygote/实用进程）。这是正常现象。
• 单实例保护使用 Electron 的锁以及本地进程文件锁作为备用，可防止在桌面 IPC/会话总线不稳定的环境中重复启动应用。
• 在滚动升级过程中，新旧应用版本混合可能仍会出现非对称保护行为。为确保最佳可靠性，请将所有桌面客户端升级到相同版本。
• OpenClaw 网关监听器应仍为单一所有者：只有一个进程应在 127.0.0.1:18789 上进行监听。
• 网关就绪状态基于 OpenClaw 核心信号，如 system-presence、health 和 status；内存、Dreams 或通道故障会显示为功能降级，而非全局网关故障。
• 要验证活动监听器：
  • macOS/Linux：lsof -nP -iTCP:18789 -sTCP:LISTEN
  • Windows（PowerShell）：Get-NetTCPConnection -LocalPort 18789 -State Listen
• 点击窗口关闭按钮（X）会将 ClawX 隐藏到托盘；不会完全退出应用。使用托盘菜单中的退出 ClawX 以完全关闭。

---

使用场景

🤖 个人 AI 助手

配置一个通用 AI 代理，它可以回答问题、起草电子邮件、总结文档并协助处理日常任务——所有这些都通过简洁的桌面界面完成。

📊 自动化监控

设置定时智能体以监控新闻动态、跟踪价格或关注特定事件。结果将发送至您偏好的通知渠道。

💻 开发者效率

将 AI 集成到您的开发工作流中。使用智能体进行代码审查、生成文档或自动完成重复性编码任务。

🔄 工作流自动化

将多项技能串联，创建复杂的自动化流程。处理数据、转换内容并触发操作——全程可视化编排。

---

开发

前提条件

• Node.js：22+（推荐 LTS 版本）
• 包管理器：pnpm 9+（推荐）或 npm

项目结构

├── electron/                 # Electron Main Process
│   ├── api/                 # Main-side API router and handlers
│   │   └── routes/          # RPC/HTTP proxy route modules
│   ├── services/            # Provider, secrets and runtime services
│   │   ├── providers/       # Provider/account model sync logic
│   │   └── secrets/         # OS keychain and secret storage
│   ├── shared/              # Shared provider schemas/constants
│   │   └── providers/
│   ├── main/                # App entry, windows, IPC registration
│   ├── gateway/             # OpenClaw Gateway process manager
│   ├── preload/             # Secure IPC bridge
│   └── utils/               # Utilities (storage, auth, paths)
├── src/                      # React Renderer Process
│   ├── lib/                 # Unified frontend API + error model
│   ├── stores/              # Zustand stores (settings/chat/gateway)
│   ├── components/          # Reusable UI components
│   ├── pages/               # Setup/Dashboard/Chat/Channels/Skills/Cron/Settings
│   ├── i18n/                # Localization resources
│   └── types/               # TypeScript type definitions
├── tests/
│   ├── e2e/                 # Playwright Electron end-to-end smoke tests
│   └── unit/                # Vitest unit/integration-like tests
├── resources/                # Static assets (icons/images)
└── scripts/                  # Build and utility scripts

可用命令

# Development
pnpm run init             # Install dependencies + download uv
pnpm dev                  # Start with hot reload (auto-prepares bundled skills if missing)

# Quality
pnpm lint                 # Run ESLint
pnpm typecheck            # TypeScript validation

# Testing
pnpm test                 # Run unit tests
pnpm run test:e2e         # Run Electron E2E smoke tests with Playwright
pnpm run test:e2e:headed  # Run Electron E2E tests with a visible window
pnpm run comms:replay     # Compute communication replay metrics
pnpm run comms:baseline   # Refresh communication baseline snapshot
pnpm run comms:compare    # Compare replay metrics against baseline thresholds

# Build & Package
pnpm run build:vite       # Build frontend only
pnpm build                # Full production build (with packaging assets)
pnpm package              # Package for current platform (includes bundled preinstalled skills)
pnpm package:mac          # Package for macOS
pnpm package:win          # Package for Windows
pnpm package:linux        # Package for Linux

在无图形界面的 Linux 系统上，需在显示服务器环境下运行 Electron 测试，例如 xvfb-run -a pnpm run test:e2e。

通信回归检查

当 PR 更改通信路径（网关事件、聊天运行时发送/接收流程、通道交付或传输回退）时，运行：

pnpm run comms:replay
pnpm run comms:compare

comms-regression 在 CI 中强制执行必要场景和阈值检查。

Electron 端到端测试

Playwright Electron 测试套件从 dist/ 和 dist-electron/ 启动打包后的渲染进程和主进程，因此无需先手动运行 pnpm dev。

pnpm run test:e2e 会自动：

• 通过 pnpm run build:vite 构建渲染器和 Electron 包
• 使用临时 HOME 以隔离的端到端模式启动 Electron
• 使用临时的 ClawX userData 目录
• 跳过资源密集型的启动副作用，如网关自动启动、捆绑技能安装、托盘创建和 CLI 自动安装

前两个基准测试用例涵盖：

• 全新配置文件下首次启动设置向导的可见性
• 跳过设置并在 Electron 应用内导航至模型页面

将未来的 Electron 流程添加到 tests/e2e/ 下，并复用 tests/e2e/fixtures/electron.ts 中的共享测试装置。

技术栈

层级	技术
运行时	Electron 40+
UI 框架	React 19 + TypeScript
样式	Tailwind CSS + shadcn/ui
状态管理	Zustand
构建工具	Vite + electron-builder
测试	Vitest + Playwright
动画	Framer Motion
图标	Lucide React

---

贡献指南

我们欢迎社区贡献！无论是错误修复、新功能、文档改进还是翻译，每一份贡献都有助于让 ClawX 变得更好。

贡献步骤

1. Fork 本仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交带有清晰说明的更改
4. 推送到你的分支
5. 打开 Pull Request

贡献准则

• 遵循现有代码风格（ESLint + Prettier）
• 为新功能编写测试
• 按需更新文档
• 保持提交独立且描述清晰

---

致谢

ClawX 站在优秀开源项目的肩膀上构建而成：

• OpenClaw – AI 代理运行时
• Electron – 跨平台桌面框架
• React – UI 组件库
• shadcn/ui – 设计精美的组件
• Zustand – 轻量级状态管理

---

社区交流

加入我们的社区，与其他用户建立联系、获取支持并分享您的使用体验。

企业微信	飞书群	Discord

ClawX 合作伙伴计划 🚀

我们正式启动 ClawX 合作伙伴计划，诚邀能够助力 ClawX 触达更多客户的合作伙伴加入，尤其欢迎那些有定制化 AI 智能体或自动化需求的客户资源方。

合作伙伴负责为我们对接潜在用户与项目，ClawX 团队则提供全面的技术支持、定制开发及集成服务。

如果您的客户群体对 AI 工具或自动化解决方案感兴趣，我们期待与您携手合作。

欢迎私信我们或发送邮件至 public@valuecell.ai 了解更多详情。

---

星标历史

---

许可协议

ClawX 基于 MIT License 开源发布。您可以自由使用、修改和分发本软件。

---

_{由 ValueCell 团队匠心打造 ❤️}