🔱 Fork 声明：本仓库 fork 自 qiuzhi2046/Qclaw，在原项目基础上进行了 Windows 平台适配、Bug 修复及用户体验优化。 原创团队仓库：https://github.com/qiuzhi2046/Qclaw ｜ 本 Fork：https://github.com/sjkncs/Qclaw
- 环境自检 — 自动检测 Node.js 和 OpenClaw CLI，缺失时自动安装
- 支持 OpenClaw 全量模型 — 支持接入 OpenClaw 的所有模型，也支持自定义添加
- IM最新插件接入 — 扫码一键接入飞书、微信、企业微信、钉钉、QQ，自动安装官方插件并写入配置
- 应用即教程 — 小白友好的操作引导和提示
- 功能面板 — 实时监控网关状态、一键重启、修复网关
- Skills管理 — 管理各个来源的skill
- 数据备份 — 提供自动备份和手动备份
- 多平台支持 — 支持 macOS、Windows（开发中），开箱即用
- 自动更新 — 支持OpenClaw最新版本
以下改动均基于原项目 qiuzhi2046/Qclaw 进行，旨在提升 Windows 平台兼容性与整体用户体验。
🪟 Windows 平台适配（回应社区 Issue #6 — 期待 Windows 上线）
| 问题 | 修复内容 | 涉及文件 |
|---|---|---|
| npm 全局安装路径嵌套 | 修复 Windows 下 node_modules\node_modules\openclaw 嵌套路径解析失败 |
electron/main/openclaw-package.ts |
| macOS 专属命令误调用 | 移除在 Windows 上调用 osascript 导致的 spawn EINVAL 错误 |
electron/main/cli.ts |
| CLI 命令映射缺失 | 为 openclaw 添加 .cmd 后缀映射，确保 spawn 正确执行 |
electron/main/cli.ts → resolveCommandForShelllessSpawn |
| Windows 路径发现 | 新增 APPDATA、npm prefix 等 Windows 常见路径的候选查找逻辑 |
electron/main/runtime-path-discovery.ts |
| 版本号解析异常 | 处理 OpenClaw 2026.x.x 前缀格式的版本号提取 |
src/shared/openclaw-version-policy.ts → normalizeVersionCore |
⌨️ Enter 键发送模式优化（回应社区 Issue #2 — Enter 发送太容易误触）
- 新增发送模式切换：用户可在设置页面选择发送方式
Enter直接发送（原始行为）Shift + Enter发送（默认，Enter 换行）Alt + Enter发送（Enter 换行）
- 新增模块
src/lib/chat-composer-enter-send-preference.ts：管理用户偏好的本地存储读写 - 涉及文件：
App.tsx、ChatPage.tsx、SettingsPage.tsx、DashboardChatPanel.tsx
- ARIA 无障碍属性修复：修正
ModelCenter.tsx中aria-valuemin/aria-valuemax/aria-valuenow的 ESLint 误报，使用块级eslint-disable覆盖多行属性 - OpenClaw CLI 升级兼容：验证 2026 年 2 月版本的安全升级路径，修复飞书插件
package.json中workspace:*依赖问题 - TypeScript 编译清理：解决所有 TypeScript 编译错误，开发服务器
npm run dev可正常启动
| Issue | 标题 | 状态 |
|---|---|---|
| #2 | enter 发送太容易误触了 | ✅ 已在本 Fork 中修复（Enter 键发送模式可配置） |
| #6 | 秋芝加油期待 Windows 上线 | ✅ 已在本 Fork 中适配 Windows 平台 |
| #5 | [RFC] AMCP 协议集成提案 | 🔍 关注中，待社区讨论 |
| #12 | 支持 OpenClaw 配置及多 Agent 可视化与 IM 渠道绑定 | 🔍 关注中，待评估 |
开发 Qclaw 的初心很简单：做一个简单好用的 OpenClaw 桌面管家，让每个人都能轻松装上、用上OpenClaw。
- 降低门槛：将复杂的配置转化为简单的桌面交互
- 打破壁垒：让人人都能用上好用、强大的AI工具
- 零基础上手——教程即操作，边看边用，快速入门
- 下载并打开 Qclaw Lite 客户端
- 官网：https://qclawai.com/
- GitHub Release：下载最新版本
- 阅读安全提醒内容并确认继续
- 运行环境检测
- 如果系统检测到已有的 OpenClaw 配置，可直接导入
- 按界面提示，准备开始配置
- 进入 AI 提供商界面，等待模型列表加载
- 选择你要用的模型（支持 OpenClaw 全量模型，部分模型支持 OAuth 授权）
- 在客户端直接发起对话
- 或者前往你刚刚配置的 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| 命令 | 说明 |
|---|---|
npm run dev |
启动开发服务器 |
npm run build |
构建并打包应用 |
npm test |
运行测试 |
npm run typecheck |
TypeScript 类型检查 |
electron/
main/ 主进程（窗口管理、CLI 调用、IPC 处理）
preload/ 预加载脚本（安全桥接）
src/
pages/ 页面组件（向导步骤、Dashboard、聊天等）
components/ UI 组件
lib/ 业务逻辑（渠道注册、提供商注册等）
shared/ 共享模块（配置流程、网关诊断等）
assets/ 图标与静态资源
docs/ 项目相关文档（架构说明、变更日志等）
scripts/ 构建与发布脚本（签名公证、版本管理、COS 发布等）
build/ 应用图标与打包资源
| 层 | 技术 |
|---|---|
| 桌面框架 | Electron |
| 前端 | React + TypeScript |
| 构建 | Vite + vite-plugin-electron |
| UI | Mantine + Tailwind CSS |
| 打包 | electron-builder |
┌─────────────────────────────────────────────────────────┐
│ 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 11 (Big Sur)+
- Windows 10+（x64）(开发中)
- Linux（计划中）
欢迎每一个有想法、愿意动手的朋友参与到Qclaw的贡献中来！正是因为有你们，这个项目才能不断进步。
本指南将帮助你了解如何参与项目开发，无论是报告 Bug、提出新功能建议，还是提交代码，我们都非常欢迎。
另外我们也非常鼓励和欢迎使用各类AI编程工具编写、提交代码（这也是我们的日常），哪怕你不是专业开发者。
如果Qclaw能成为你的第一个开源贡献项目，我们荣幸之至。
贡献指南：
小白贡献指南：
- Qclaw开源交流群
- 尊重每一位参与者
- 保持友好和建设性的讨论
- 欢迎提问，也欢迎帮助他人
微信公众号
欢迎开发相关的人才加入我们（简历请投：join@qiuzhi2046.com）。
虽然暂时不能提供大厂级别的薪资福利，但我们能给你一个纯粹、没有会议和 PPT 内耗的创造环境——AI 工具不限量！
如果你热爱 AI，骨子里有一点极客精神，别犹豫，把简历砸过来吧！
基于 Apache-2.0 协议分发。详情参见 LICENSE。·
本项目 Fork 自 qiuzhi2046/Qclaw，由 秋芝团队（qiuzhi2046） 原创开发。
感谢秋芝团队构建了如此优秀的 OpenClaw 桌面管家——简洁的交互设计、完善的 IM 接入能力、以及对小白用户极致友好的体验，为整个 OpenClaw 社区降低了巨大的使用门槛。我们在此基础上进行了 Windows 适配和体验优化，所有改动均以 PR 形式回馈上游。
感谢 OpenClaw——没有它就没有 Qclaw，我们只是站在巨人肩膀上搭了个小梯子。
感谢 Electron、React、Vite、Mantine 等众多开源项目，以及所有默默贡献的开源作者。Qclaw 的每一行代码背后，都有你们的影子。
感谢参与内测的朋友们，你们的每一条 bug 反馈和建议都在让产品进步。你们的飞书 ID 我们都记下了 👀
更多见：反馈用户（排名不分先后）
最后，感谢每一个愿意尝试、愿意分享、愿意让技术变得更有温度的人。
| 仓库 | 作者 | 依赖包 |
|---|---|---|
| openclaw/openclaw | OpenClaw | openclaw (CLI) |
| electron/electron | Electron Community | electron |
| facebook/react | Meta | react, react-dom |
| mantinedev/mantine | Vitaly Rtishchev | @mantine/core, @mantine/modals, @mantine/notifications |
| vitejs/vite | Evan You | vite |
| tailwindlabs/tailwindcss | Tailwind Labs | tailwindcss |
| electron-userland/electron-builder | Vladimir Krivosheev | electron-builder, electron-updater |