d3a4de2480
- Add OpenFang Kernel configuration guide (docs/setup/OPENFANG-SETUP.md) - Add Chinese models configuration guide (docs/setup/chinese-models.md) - Add quick start guide (docs/quick-start.md) - Add quick start scripts for Windows and Linux/macOS - Add ErrorNotification component for centralized error display These additions help users: - Quickly set up development environment - Configure OpenFang backend correctly - Configure Chinese LLM providers (GLM, Qwen, Kimi, MiniMax) - See error notifications in a consistent UI Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
ZCLAW 🦞 — OpenClaw 定制版 (Tauri Desktop)
像 AutoClaw (智谱) 和 QClaw (腾讯) 一样，对 OpenClaw 进行定制化封装，打造中文优先的 Tauri 桌面 AI 助手。
核心定位
OpenClaw Gateway (执行引擎)
↕ WebSocket
ZCLAW Tauri App (桌面 UI)
+ 中文模型 Provider (GLM/Qwen/Kimi/MiniMax)
+ 飞书 Channel Plugin
+ 分身(Clone) 管理
+ 自定义 Skills
功能特色
- 基于 OpenClaw: 真实工具执行 (bash/file/browser)、Skills 生态、MCP 协议、心跳引擎
- 中文模型: 智谱 GLM-5、通义千问、Kimi K2.5、MiniMax (OpenAI 兼容 API)
- 飞书集成: 飞书 Channel Plugin，在飞书中直接对话指挥电脑
- 分身系统: 多个独立 Agent 实例，各有自己的角色、记忆、配置
- Tauri 桌面: Rust + React 19，体积小 (~10MB)，性能好
- 设置页面: 对标 AutoClaw — 通用/模型/MCP/技能/IM/工作区/隐私
技术栈
| 层级 | 技术 |
|---|---|
| 执行引擎 | OpenClaw Gateway (Node.js, ws://127.0.0.1:18789) |
| 桌面壳 | Tauri 2.0 (Rust + React 19) |
| 前端 | React 19 + TailwindCSS + Zustand + Lucide Icons |
| 自定义插件 | TypeScript (OpenClaw Plugin API) |
| 通信协议 | OpenClaw Gateway WebSocket Protocol v3 |
项目结构
ZClaw/
├── desktop/ # Tauri 桌面应用 (React 前端)
│ ├── src/
│ │ ├── components/ # UI 组件
│ │ ├── store/ # Zustand 状态管理
│ │ └── lib/gateway-client.ts # Gateway WebSocket 客户端
│ └── src-tauri/ # Rust 后端 (TODO)
│
├── src/gateway/ # Gateway 管理层
│ ├── manager.ts # OpenClaw 子进程管理
│ ├── ws-client.ts # Node.js WebSocket 客户端
│ └── index.ts
│
├── plugins/ # ZCLAW 自定义 OpenClaw 插件
│ ├── zclaw-chinese-models/ # 中文模型 Provider (GLM/Qwen/Kimi/MiniMax)
│ ├── zclaw-feishu/ # 飞书 Channel Plugin
│ └── zclaw-ui/ # UI 扩展 RPC 方法
│
├── skills/ # 自定义 Skills
│ ├── chinese-writing/ # 中文写作
│ └── feishu-docs/ # 飞书文档操作
│
├── config/ # OpenClaw 默认配置
│ ├── openclaw.default.json # Gateway 配置模板
│ ├── SOUL.md # Agent 人格
│ ├── AGENTS.md # Agent 指令
│ ├── IDENTITY.md # Agent 身份
│ └── USER.md # 用户偏好
│
├── scripts/setup.ts # 首次设置脚本
├── docs/ # 文档
│ ├── architecture-v2.md # 架构设计
│ ├── deviation-analysis.md # 偏离分析报告
│ └── autoclaw界面/ # AutoClaw 参考截图
└── src/core/ # [归档] v1 旧代码
快速开始
1. 安装 OpenClaw
# Windows
iwr -useb https://openclaw.ai/install.ps1 | iex
# macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash
2. 安装 ZCLAW
git clone https://github.com/xxx/ZClaw.git
cd ZClaw
pnpm install
pnpm setup # 注册插件 + 复制配置
3. 配置 API Key
openclaw configure # 交互式配置
# 或手动编辑 ~/.openclaw/openclaw.json
4. 启动
openclaw gateway # 启动 OpenClaw Gateway
cd desktop && pnpm tauri dev # 启动 Tauri 桌面应用
对标参考
| 产品 | 基于 | IM 渠道 | 桌面框架 |
|---|---|---|---|
| QClaw (腾讯) | OpenClaw | 微信 + QQ | Electron |
| AutoClaw (智谱) | OpenClaw | 飞书 | 自研 |
| ZCLAW (本项目) | OpenClaw | 飞书 (+ 微信/QQ 计划中) | Tauri 2.0 |
文档
License
MIT