be0a78a523
Some checks failed
CI / Lint & TypeCheck (push) Has been cancelled
CI / Unit Tests (push) Has been cancelled
CI / Build Frontend (push) Has been cancelled
CI / Rust Check (push) Has been cancelled
CI / Security Scan (push) Has been cancelled
CI / E2E Tests (push) Has been cancelled
Model Groups provide logical model names that map to multiple physical models across providers, with automatic failover when one provider's key pool is exhausted. Backend: - New model_groups + model_group_members tables with FK constraints - Full CRUD API (7 endpoints) with admin-only write permissions - Cache layer: DashMap-backed CachedModelGroup with load_from_db - Relay integration: ModelResolution enum for Direct/Group routing - Cross-provider failover: sort_candidates_by_quota + OnceLock cache - Relay failure path: record failure usage + relay_dequeue (fixes queue counter leak that caused connection pool exhaustion) - add_group_member: validate model_id exists before insert Frontend: - saas-relay-client: accept getModel() callback for dynamic model selection - connectionStore: prefer conversationStore.currentModel over first available Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
ZCLAW 🦞 — ZCLAW 定制版 (Tauri Desktop)
基于 ZCLAW —— 用 Rust 构建的 Agent 操作系统，打造中文优先的 Tauri 桌面 AI 助手。
核心定位
ZCLAW Kernel (Rust 执行引擎)
↕ WebSocket / HTTP API
ZCLAW Tauri App (桌面 UI)
+ 中文模型 Provider (GLM/Qwen/Kimi/MiniMax/DeepSeek)
+ 7 个自主 Hands (Browser/Researcher/Collector 等)
+ 40+ 渠道适配器 (飞书/钉钉/Telegram/Discord 等)
+ 16 层安全防护
+ 分身(Clone) 管理
+ 自定义 Skills
为什么选择 ZCLAW?
相比 ZCLAW，ZCLAW 提供了更强的性能和更丰富的功能：
| 特性 | ZCLAW | ZCLAW |
|---|---|---|
| 开发语言 | Rust | TypeScript |
| 冷启动 | < 200ms | ~6s |
| 内存占用 | ~40MB | ~394MB |
| 安全层数 | 16 层 | 3 层基础 |
| 自主 Hands | 7 个内置 | 无 |
| 渠道适配器 | 40 个 | 13 个 |
| LLM 提供商 | 27 个 | ~10 个 |
详细对比：ZCLAW 架构概览
功能特色
- 基于 ZCLAW: 生产级 Agent 操作系统，16 层安全防护，WASM 沙箱
- 7 个自主 Hands: Browser/Researcher/Collector/Predictor/Lead/Clip/Twitter - 预构建的"数字员工"
- 中文模型: 智谱 GLM-4、通义千问、Kimi、MiniMax、DeepSeek (OpenAI 兼容 API)
- 40+ 渠道: 飞书、钉钉、Telegram、Discord、Slack、微信等
- 60+ 技能: 内置技能包 + 自定义 SKILL.md
- 分身系统: 多个独立 Agent 实例，各有自己的角色、记忆、配置
- Tauri 桌面: Rust + React 19，体积小 (~10MB)，性能好
- 设置页面: 对标 AutoClaw — 通用/模型/MCP/技能/IM/工作区/隐私
技术栈
| 层级 | 技术 |
|---|---|
| 执行引擎 | ZCLAW Kernel (Rust, http://127.0.0.1:50051) |
| 桌面壳 | Tauri 2.0 (Rust + React 19) |
| 前端 | React 19 + TailwindCSS + Zustand + Lucide Icons |
| 通信协议 | ZCLAW API (REST/WS/SSE) + OpenAI 兼容 API |
| 安全 | WASM 沙箱 + Merkle 审计追踪 + Ed25519 签名 |
项目结构
ZClaw/
├── desktop/ # Tauri 桌面应用 (React 前端)
│ ├── src/
│ │ ├── components/ # UI 组件
│ │ ├── store/ # Zustand 状态管理
│ │ └── lib/gateway-client.ts # ZCLAW API 客户端
│ └── src-tauri/ # Rust 后端
│
├── skills/ # 自定义技能 (SKILL.md)
│ ├── chinese-writing/ # 中文写作
│ └── feishu-docs/ # 飞书文档操作
│
├── hands/ # 自定义 Hands (HAND.toml)
│ └── custom-automation/ # 自定义自动化任务
│
├── config/ # ZCLAW 默认配置
│ ├── config.toml # 主配置文件
│ ├── SOUL.md # Agent 人格
│ └── AGENTS.md # Agent 指令
│
├── docs/
│ ├── setup/ # 设置指南
│ │ ├── ZCLAW-SETUP.md # ZCLAW 配置指南
│ │ └── chinese-models.md # 中文模型配置
│ ├── architecture-v2.md # 架构设计
│ └── deviation-analysis.md # 偏离分析报告
│
└── scripts/setup.ts # 首次设置脚本
快速开始
1. 安装 ZCLAW
# Windows (PowerShell)
iwr -useb https://zclaw.sh/install.ps1 | iex
# macOS / Linux
curl -fsSL https://zclaw.sh/install.sh | bash
2. 初始化配置
zclaw init
3. 配置 API Key
# 设置智谱 API Key (推荐，有免费额度)
export ZHIPU_API_KEY="your-api-key"
# 或其他中文模型
export DASHSCOPE_API_KEY="your-dashscope-key" # 通义千问
export MOONSHOT_API_KEY="your-moonshot-key" # Kimi
export DEEPSEEK_API_KEY="your-deepseek-key" # DeepSeek
获取 API Key：参考 中文模型配置指南
4. 启动服务
# 启动 ZCLAW Kernel
zclaw start
# 在另一个终端启动 ZCLAW 桌面应用
git clone https://github.com/xxx/ZClaw.git
cd ZClaw
pnpm install
cd desktop && pnpm tauri dev
5. 验证安装
# 检查 ZCLAW 状态
zclaw status
# 运行健康检查
zclaw doctor
ZCLAW Hands (自主能力)
ZCLAW 内置 7 个预构建的自主能力包，每个 Hand 都是一个具备完整工作流的"数字员工"：
| Hand | 功能 | 状态 |
|---|---|---|
| Browser | 网页自动化，Playwright 驱动 | 可用 |
| Researcher | 深度研究，交叉验证，APA 引用 | 可用 |
| Collector | 情报监控，OSINT 级持续监控 | 可用 |
| Predictor | 趋势预测，带置信区间的预测 | 可用 |
| Lead | 线索挖掘，ICP 匹配，评分去重 | 可用 |
| Clip | 视频处理，下载剪辑，字幕生成 | 需 FFmpeg |
| 社媒管理，内容创建，排期发布 | 需 API Key |
支持的中文模型
| 提供商 | 模型 | 特点 | 免费额度 |
|---|---|---|---|
| 智谱 AI | GLM-4-Flash | 快速响应 | 1000 万 tokens |
| 阿里云 | 通义千问 | 性价比高 | 有试用 |
| 月之暗面 | Kimi | 200K 长上下文 | 15 元体验金 |
| DeepSeek | DeepSeek-Chat | 编程能力强 | 低价 |
| MiniMax | 海螺 AI | 语音能力强 | 有试用 |
详细配置请参考 中文模型配置指南
文档
设置指南
- ZCLAW Kernel 配置指南 - 安装、配置、常见问题
- 中文模型配置指南 - API Key 获取、模型选择、多模型配置
架构设计
外部资源
对标参考
| 产品 | 基于 | IM 渠道 | 桌面框架 | 安全层数 |
|---|---|---|---|---|
| QClaw (腾讯) | ZCLAW | 微信 + QQ | Electron | 3 |
| AutoClaw (智谱) | ZCLAW | 飞书 | 自研 | 3 |
| ZCLAW (本项目) | ZCLAW | 飞书 + 钉钉 + 40+ | Tauri 2.0 | 16 |
从 ZCLAW 迁移
如果你之前使用 ZCLAW，可以一键迁移：
# 迁移所有内容：代理、记忆、技能、配置
zclaw migrate --from zclaw
# 先试运行查看变更
zclaw migrate --from zclaw --dry-run
License
MIT