Qclaw

Qclaw

不用命令行，小白也能轻松玩转 OpenClaw

[访问官网 »](https://qclawai.com/)
  

  

[English](https://github.com/qiuzhi2046/Qclaw/blob/main/README.en.md)
·
[简体中文](https://github.com/qiuzhi2046/Qclaw/blob/main/README.md)
·
[报告 Bug](https://github.com/qiuzhi2046/qclaw/issues/new?labels=bug)
·
[功能建议](https://github.com/qiuzhi2046/qclaw/issues/new?labels=enhancement)

👋 雷猴哇，朋友们，我们决定暂停 Qclaw 的更新了~

OpenClaw官方已经出了Mac版安装包（也还没出win），虽然目前非常不好用

但相信不久后就能成为主流了（期望吧。。。。。如果他们未来做得还是不好，那我就再回来搞！！！）

而且最近OpenClaw已经变成2天一更了，这更新频率是真跟不上了😂

综上所述，我觉得Qclaw的使命已经完成啦，如果它有帮到过你，我们真的会很开心🤗

点进来的朋友希望大家都能动手拉代码改改呀，练习下Vibe Coding，嘿嘿~

我们也在筹备新的项目啦，希望未来尽快能跟大家见面~❤️

Star History

目录

[功能特性](#功能特性)
[为什么会有这个项目](#为什么会有这个项目)
[快速上手](#快速上手)
[快速开发](#快速开发)
[已知问题](#已知问题)
[支持环境](#支持环境)
[贡献指南](#贡献指南)
[加入社区](#加入社区)
[加入我们](#加入我们)
[开源许可](#开源许可)
[贡献者](#贡献者)
[致谢](#致谢)

功能特性

• 环境自检 — 自动检测 Node.js 和 OpenClaw CLI，缺失时自动安装
• 支持 OpenClaw 全量模型 — 支持接入 OpenClaw 的所有模型，也支持自定义添加
• IM最新插件接入 — 扫码一键接入飞书、微信、企业微信、钉钉、QQ，自动安装官方插件并写入配置
• 应用即教程 — 小白友好的操作引导和提示
• 功能面板 — 实时监控网关状态、一键重启、修复网关
• Skills管理 — 管理各个来源的skill
• 数据备份 — 提供自动备份和手动备份
• 多平台支持 — 支持 macOS、Windows（开发中），开箱即用
• 自动更新 — 支持OpenClaw最新版本

为什么会有这个项目

开发 Qclaw 的初心很简单：做一个简单好用的 OpenClaw 桌面管家，让每个人都能轻松装上、用上OpenClaw。

• 降低门槛：将复杂的配置转化为简单的桌面交互
• 打破壁垒：让人人都能用上好用、强大的AI工具
• 零基础上手——教程即操作，边看边用，快速入门

快速上手

Step 1：下载安装

• 下载并打开 Qclaw Lite 客户端
  • 官网：https://qclawai.com/
  • GitHub Release：下载最新版本
• 阅读安全提醒内容并确认继续

Step 2：环境准备

• 运行环境检测
  • 如果系统检测到已有的 OpenClaw 配置，可直接导入
• 按界面提示，准备开始配置

Step 3：配置模型

• 进入 AI 提供商界面，等待模型列表加载
• 选择你要用的模型（支持 OpenClaw 全量模型，部分模型支持 OAuth 授权）

Step 4：接入 IM（可选）

• 进入 IM 渠道界面
• 选择你常用的平台（飞书 / 钉钉 / QQ / 企微）
• 按照界面指引完成接入，各平台详细指南：
  • 飞书接入指南
  • 钉钉接入指南
  • QQ 接入指南
  • 企业微信接入指南

Step 5：开始使用

• 在客户端直接发起对话
• 或者前往你刚刚配置的 IM 工具中，测试你的专属 AI 助手

💡 关闭 Qclaw Lite 窗口不会影响后台的 OpenClaw 运行，IM 渠道照常可用。

快速开发

推荐开发环境

• macOS
• Qclaw(OpenClaw)
• Codex 或 Claude Code
• Node.js 24（至少22）

源码安装

# 克隆仓库
git clone https://github.com/qiuzhi2046/Qclaw.git
cd Qclaw

# 安装依赖
npm install

# 启动开发环境
npm run dev

# 构建生产版本
npm run build

常用命令

项目结构

electron/
  main/             主进程（窗口管理、CLI 调用、IPC 处理）
  preload/          预加载脚本（安全桥接）
src/
  pages/            页面组件（向导步骤、Dashboard、聊天等）
  components/       UI 组件
  lib/              业务逻辑（渠道注册、提供商注册等）
  shared/           共享模块（配置流程、网关诊断等）
  assets/           图标与静态资源
docs/               项目相关文档（架构说明、变更日志等）
scripts/            构建与发布脚本（签名公证、版本管理、COS 发布等）
build/              应用图标与打包资源

技术栈和架构

┌─────────────────────────────────────────────────────────┐
│                           Qclaw                         │
│                                                         │
│  ┌──────────────────┐         ┌──────────────────────┐  │
│  │   Main Process   │         │  Renderer Process    │  │
│  │   (Node.js)      │   IPC   │  (Chromium)          │  │
│  │                  │◄───────►│                      │  │
│  │  ┌────────────┐  │         │  ┌────────────────┐  │  │
│  │  │  cli.ts    │  │         │  │  React + Vite  │  │  │
│  │  │  OpenClaw  │  │         │  │  Mantine + TW  │  │  │
│  │  │  CLI 调用  │  │         │  │                │  │  │
│  │  └─────┬──────┘  │         │  │  向导页面       │  │  │
│  │        │         │         │  │  Dashboard     │  │  │
│  │  ┌─────▼──────┐  │         │  └────────────────┘  │  │
│  │  │ 系统集成   │  │         │                      │  │
│  │  │ 文件读写   │  │         └──────────────────────┘  │
│  │  │ 进程管理   │  │                                   │
│  │  └────────────┘  │                                   │
│  └──────────────────┘                                   │
│                                                         │
│           │                                             │
│           ▼                                             │
│  ┌──────────────────┐                                   │
│  │  OpenClaw CLI     │                                  │
│  │  ~/.openclaw/     │                                  │
│  └──────────────────┘                                   │
└─────────────────────────────────────────────────────────┘

已知问题

• 这个文档记录了当前项目的已知缺陷和bug（AI有待调教，多多包容）
• 请查看 Issues 了解具体问题和功能建议。

支持环境

• macOS 12+

贡献指南

我们欢迎每一个致力于让前沿 AI Agent 变得更好用、更易用的朋友加入贡献者行列！ 无论你是否贡献过代码，只要有想法、有热情，都欢迎加入我们一起交流！🤗

贡献指南

• Qclaw贡献者交流群

  如果你希望给 Qclaw 做贡献，欢迎加入贡献者交流群！

加入社区

• Qclaw用户交流群

  如果你对Qclaw有疑问、希望与其他朋友交流等，欢迎加入用户交流群！

社区规范

• 尊重每一位参与者
• 保持友好和建设性的讨论
• 欢迎提问，也欢迎帮助他人

社交媒体

微信公众号

加入我们

欢迎开发相关的人才加入我们（简历请投：join@qiuzhi2046.com）。

虽然暂时不能提供大厂级别的薪资福利，但我们能给你一个纯粹、没有会议和 PPT 内耗的创造环境——AI 工具不限量！

如果你热爱 AI，骨子里有一点极客精神，别犹豫，把简历砸过来吧！

开源许可

基于 Apache-2.0 协议分发。详情参见 LICENSE。·

贡献者

致谢

感谢 OpenClaw——没有它就没有 Qclaw，我们只是站在巨人肩膀上搭了个小梯子。

感谢 Electron、React、Vite、Mantine 等众多开源项目，以及所有默默贡献的开源作者。Qclaw 的每一行代码背后，都有你们的影子。

感谢参与内测的朋友们，你们的每一条 bug 反馈和建议都在让产品进步。你们的飞书 ID 我们都记下了 👀

更多见：反馈用户（排名不分先后）

最后，感谢每一个愿意尝试、愿意分享、愿意让技术变得更有温度的人。

本项目使用的开源项目

查看所有依赖开源项目 »