iven 04ddf94123 feat: implement ZCLAW Agent Intelligence Evolution Phase 1-3
Phase 1: Persistent Memory + Identity Dynamic Evolution
- agent-memory.ts: MemoryManager with localStorage persistence, keyword search, deduplication, importance scoring, pruning, markdown export
- agent-identity.ts: AgentIdentityManager with per-agent SOUL/AGENTS/USER.md, change proposals with approval workflow, snapshot rollback
- memory-extractor.ts: Rule-based conversation memory extraction (Phase 1), LLM extraction prompt ready for Phase 2
- MemoryPanel.tsx: Memory browsing UI with search, type filter, delete, export (integrated as 4th tab in RightPanel)

Phase 2: Context Governance
- context-compactor.ts: Token estimation, threshold monitoring (soft/hard), memory flush before compaction, rule-based summarization
- chatStore integration: auto-compact when approaching token limits

Phase 3: Proactive Intelligence + Self-Reflection
- heartbeat-engine.ts: Periodic checks (pending tasks, memory health, idle greeting), quiet hours, proactivity levels (silent/light/standard/autonomous)
- reflection-engine.ts: Pattern analysis from memory corpus, improvement suggestions, identity change proposals, meta-memory creation

Chat Flow Integration (chatStore.ts):
- Pre-send: context compaction check -> memory search -> identity system prompt injection
- Post-complete: async memory extraction -> reflection conversation tracking -> auto-trigger reflection

Tests: 274 passing across 12 test files
- agent-memory.test.ts: 42 tests
- context-compactor.test.ts: 23 tests
- heartbeat-reflection.test.ts: 28 tests
- chatStore.test.ts: 11 tests (no regressions)

Refs: ZCLAW_AGENT_INTELLIGENCE_EVOLUTION.md updated with implementation progress
2026-03-15 22:24:57 +08:00
2026-03-12 00:23:42 +08:00
2026-03-12 00:23:42 +08:00
2026-03-12 00:23:42 +08:00
2026-03-12 00:23:42 +08:00

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

Description
No description provided
Readme MIT 91 MiB
Languages
HTML 69%
Rust 15%
TypeScript 14.9%
JavaScript 0.4%
Python 0.3%
Other 0.3%