A desktop management client for the OpenClaw multi-agent AI system
OpenClaw 多智能体 AI 系统的桌面管理客户端 — 可视化管理 AI 智能体、会话、定时任务、技能和日志
Latest Release Downloads License Stars
Download · Features · Development · Structure · Changelog
Keywords: AI agent multi-agent desktop app electron chatbot management LLM openclaw feishu bot telegram bot cron scheduler agent orchestration
让每一个用户都能以最简单的方式,享受 AI 科技带来的福利。
Make AI accessible to everyone through the simplest possible experience.
我们相信 AI 不应该只属于技术专家。OpenClaw Desktop 致力于将复杂的多智能体 AI 系统包装成人人可用的桌面工具,降低使用门槛,让普通用户也能轻松部署和管理自己的 AI 智能体。
OpenClaw Desktop is an Electron-based desktop application that provides a visual management dashboard for the OpenClaw multi-agent AI system. Monitor and manage AI agents, chat sessions, scheduled tasks, logs, instances, and skills — locally or remotely.
OpenClaw Desktop 是一款基于 Electron 的桌面应用,为 OpenClaw 多智能体 AI 系统提供可视化管理界面。支持本地安装和远程连接两种模式,内置零基础引导流程。
即使你从未接触过 OpenClaw,也不用担心。应用内置了完整的零基础安装引导,从环境检测、运行时安装、渠道配置到智能体创建,全程图形化向导,一步步带你完成所有配置。
Cron 定时任务
| 模块 | Module | 说明 |
|---|---|---|
| 🤖 智能体管理 | Agent Management | 创建、配置、监控 AI 智能体,支持性能分析、配置加密导入/导出、克隆 |
| 💬 会话管理 | Session Management | 实时查看和管理智能体会话,支持异步消息发送和对话记录回放 |
| ⏰ 定时任务 | Scheduled Tasks | 可视化创建和管理定时任务调度(Cron / Interval / One-time) |
| 📊 仪表板 | Dashboard | 系统状态总览,健康检查、CPU/内存/运行时长监控 |
| 🔧 配置中心 | Config Center | 图形化编辑 OpenClaw 核心配置,渠道路由、广播群组、配对管理 |
| 🧩 技能管理 | Skills Management | 安装、卸载和管理智能体技能包,支持 ClawHub 市场搜索 |
| 🌐 远程连接 | Remote Connection | 支持通过 SSH / Tailscale 连接远程 OpenClaw 实例 |
| 🎨 主题切换 | Theme | 亮色 / 暗色 / 跟随系统 |
| 🌍 国际化 | i18n | 中文和英文界面完整覆盖 |
| 🖥️ 原生体验 | Native UX | macOS 隐藏式标题栏、无边框窗口 |
从 Releases 页面下载对应平台的安装包:
| 平台 | 架构 | 格式 |
|---|---|---|
| macOS | Apple Silicon (arm64) | .dmg |
| macOS | Intel (x64) | .dmg |
| Windows | x64 | .exe 安装包 / .zip 便携版 |
- 本地模式:已安装 OpenClaw 运行时
- 远程模式:可访问的远程 OpenClaw 实例
- 打开应用,进入引导流程
- 选择「本地安装」或「远程连接」模式
- 按照引导完成运行时配置、渠道添加、智能体创建
- 配置完成后进入主界面
| 类别 | 技术 |
|---|---|
| 运行时 | Electron 38 (TypeScript 主进程, CJS preload) |
| 前端框架 | React 19 + React Router DOM 7 (HashRouter) |
| 语言 | TypeScript 5.9 |
| 构建工具 | Vite 7 |
| 样式 | Tailwind CSS 4 + CSS 自定义属性主题 |
| 存储 | electron-store |
| 打包 | electron-builder |
| 图标 | lucide-react + @iconify/react |
| Markdown | react-markdown + remark-gfm |
| 测试 | Vitest 4 + fast-check (属性测试) |
- Node.js >= 20
- npm >= 10
# 克隆仓库 git clone https://github.com/Luohao-Yan/Openclaw-Desktop.git cd Openclaw-Desktop # 安装依赖 npm install # 启动开发模式(Vite + Electron 并行) npm run dev
npm run dev # 开发模式 npm run type-check # 类型检查 npm run build # 生产构建(Vite + tsc + electron-builder) npm run pack:mac:dmg:arm64 # 打包 macOS DMG (Apple Silicon) npm run pack:mac:dmg:x64 # 打包 macOS DMG (Intel) npm run pack:win:nsis # 打包 Windows 安装包(当前架构) npm run pack:win:nsis:x64 # 打包 Windows 安装包 (x64) npm run pack:win:nsis:arm64 # 打包 Windows 安装包 (ARM64)
| 目录 | 说明 |
|---|---|
dist/ |
Vite 渲染进程构建输出 |
dist-electron/ |
tsc 主进程编译输出 |
release-artifacts/ |
electron-builder 打包产物 |
electron/ # Electron 主进程
main.ts # 应用入口、窗口创建、IPC 注册
preload.ts / .cjs # Context Bridge(暴露 window.electronAPI)
ipc/ # 按领域划分的 IPC 处理模块
config/ # 运行时清单配置
src/ # React 渲染进程
App.tsx # 根组件:Provider 嵌套、路由、Setup/Main 切换
components/ # 共享 UI 组件(Sidebar, TitleBar, GlassCard 等)
contexts/ # React Context(DesktopRuntime, SetupFlow, Theme)
i18n/ # 国际化(I18nContext + translations.ts)
help-docs/ # 帮助文档(USER_GUIDE.md, FEATURE_LIST.md)
pages/ # 页面组件(与路由 1:1 对应)
setup/ # 引导流程页面
settings/ # 设置子页面
sessions/ # 会话模块(列表、聊天面板、统计卡片)
services/ # 非 IPC 业务逻辑
types/ # TypeScript 类型定义
types/ # 主进程与渲染进程共享类型
resources/ # 应用图标(png, svg, ico, icns)
- 页面与路由 1:1 对应,路由定义在
App.tsx - 新增 IPC 领域:在
electron/ipc/新建文件,导出setup*IPC(),在electron/main.ts注册 - 新增渲染进程 API:扩展
src/types/electron.ts和types/electron.ts类型,通过electron/preload.ts暴露 - 主题值使用 CSS 自定义属性,禁止硬编码颜色
- 国际化字符串写入
src/i18n/translations.ts,组件中使用useI18n()Hook
0.4.9.x系列对应 OpenClaw 4.9 运行时(当前)0.4.5.x系列对应 OpenClaw 4.5 运行时0.3.24.x系列对应 OpenClaw 3.24 运行时0.3.13.x系列对应 OpenClaw 3.13 运行时0.3.8.x系列对应 OpenClaw 3.8 运行时preview标识表示预览版本- 版本格式:
0.主版本.次版本-preview-预览号
详细更新记录请查看 CHANGELOG.md。
欢迎提交 Issue 和 Pull Request。
- Fork 本仓库
- 创建特性分支 (
git checkout -b feature/your-feature) - 提交更改 (
git commit -m 'feat: add some feature') - 推送到分支 (
git push origin feature/your-feature) - 创建 Pull Request
感谢所有为本项目做出贡献的开发者 🎉
Contributors| 贡献者 | GitHub | 贡献内容 |
|---|---|---|
| Leon(Louis) Yan | @Luohao-Yan | 项目创建者与核心开发 |
| sevico | @sevico | 修复 Windows/Linux 默认菜单栏隐藏 (#4) |
本项目基于 AGPL-3.0 许可证开源。
本项目基于 OpenClaw 开源项目构建。感谢 OpenClaw 团队打造了如此出色的多智能体 AI 系统,让我们能够在此基础上为用户提供更友好的桌面管理体验。
- OpenClaw — 多智能体 AI 系统核心
Made with ❤️ by Luohao Yan