第一章：项目概述
📖 本章介绍 MiniClaw 项目的基本信息、核心价值主张和特色亮点。
1.1 项目基本信息
1.1.1 项目名称与定位
| 属性 | 内容 |
|---|---|
| **项目名称** | MiniClaw 🦞 |
| **版本号** | v0.5.0 "The Nervous System" |
| **项目定位** | 微内核智能体（Micro-Kernel Agent） |
| **目标用户** | Claude CoWork、Qoderwork、WorkBuddy 等 MCP 客户端用户 |
┌─────────────────────────────────────────────────────────────┐
│ MiniClaw 项目定位图 │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ │
│ │ OpenClaw │ ◄── 完整版（功能丰富，复杂度高） │
│ │ (Full) │ │
│ └──────┬──────┘ │
│ │ │
│ │ 极简实现 │
│ ▼ │
│ ┌─────────────┐ │
│ │ MiniClaw │ ◄── 轻量版（核心功能，低门槛） │
│ │ (Minimal) │ │
│ └─────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────┐ │
│ │ MCP 客户端生态 │ │
│ │ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐ │ │
│ │ │Claude │ │Cursor │ │Windsurf│ │Qoder │ │ │
│ │ │ Code │ │ │ │ │ │ │ │ │
│ │ └───────┘ └───────┘ └───────┘ └───────┘ │ │
│ └─────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘1.1.2 项目来源与背景
MiniClaw 是爆火开源项目 OpenClaw 的极简实现版本。
项目演进时间线
- 起源：OpenClaw 爆火 → Mac mini 热销 → 社区关注度激增
- 衍生：MiniClaw 诞生 → 极简实现 → 降低入门门槛
- 发展：v0.5.0 发布 → "The Nervous System" → ACE 引擎 → 实体知识图谱
核心理念
| 理念 | 说明 |
|---|---|
| **微内核** | 轻量级核心，可扩展插件 |
| **ACE 引擎** | 自适应上下文引擎，智能管理 Token |
| **生物进化** | 根据用户反馈自我迭代成长 |
设计哲学
💡 最低门槛体验 OpenClaw 核心功能
┌────────────────────────────────────────────────────────┐
│ 设计哲学对比 │
├──────────────────┬─────────────────┬───────────────────┤
│ 特性 │ OpenClaw │ MiniClaw │
├──────────────────┼─────────────────┼───────────────────┤
│ 代码规模 │ 较大 │ ~2,700 行 │
│ 入门门槛 │ 较高 │ 极低 │
│ 核心功能 │ 完整 │ 精简 │
│ 部署方式 │ 复杂 │ npx 一键 │
│ 学习曲线 │ 陡峭 │ 平缓 │
└──────────────────┴─────────────────┴───────────────────┘1.1.3 项目仓库信息
| 信息项 | 内容 |
|---|---|
| **Git 仓库** | https://github.com/8421bit/miniclaw |
| **许可证** | MIT License |
| **作者** | 8421bit |
| **包管理** | npm (public) |
1.2 核心价值主张
1.2.1 产品定位
MiniClaw = 微内核 + 进化 + 记忆
┌─────────────────────────────────────────────────────────────────────┐
│ MiniClaw 核心定位 │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ 微内核 │ │ 进化 │ │ 记忆 │ │
│ │ Micro-Kernel│ │ Evolution │ │ Memory │ │
│ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ MiniClaw 智能体系统 │ │
│ │ │ │
│ │ • 轻量级核心 (~2,700 行代码) │ │
│ │ • 根据用户反馈自我迭代 │ │
│ │ • 长期记忆，真正"懂"用户 │ │
│ │ │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────┘1.2.2 解决的核心问题
| 问题 | MiniClaw 的解决方案 |
|---|---|
| **上下文遗忘** | 通过 DNA 模板和记忆系统，保持跨会话的上下文连续性 |
| **Token 限制** | ACE 引擎智能管理 Token 预算，优先加载关键信息 |
| **重复沟通** | 实体知识图谱记录关键信息，避免重复询问 |
| **个性化不足** | 用户画像和记忆蒸馏，提供个性化服务 |
| **部署复杂** | npx 一键运行，零配置启动 |
1.2.3 目标用户画像
┌─────────────────────────────────────────────────────────────────────┐
│ 目标用户画像 │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ 👤 用户 A：AI 开发爱好者 │
│ • 想体验 OpenClaw 但觉得太复杂 │
│ • 希望快速上手，看到效果 │
│ • 对 AI Agent 技术感兴趣 │
│ │
│ 👤 用户 B：Claude Code 用户 │
│ • 经常使用 Claude Code 进行开发 │
│ • 希望 AI 能"记住"项目细节 │
│ • 需要个性化的编程助手 │
│ │
│ 👤 用户 C：效率工具追求者 │
│ • 追求开发效率最大化 │
│ • 愿意尝试新的工具和方法 │
│ • 重视工具的易用性 │
│ │
│ 👤 用户 D：技术学习者 │
│ • 想学习 AI Agent 的实现原理 │
│ • 代码量适中，易于理解 │
│ • 有完整的文档和示例 │
│ │
└─────────────────────────────────────────────────────────────────────┘1.3 特色亮点
1.3.1 核心特性一览
| 特性 | 描述 | 价值 |
|---|---|---|
| 🧬 **DNA 模板系统** | 9 个 Markdown 文件定义 Agent 行为 | 可配置、可扩展、版本可控 |
| 🧠 **ACE 引擎** | 自适应上下文引擎 | 智能管理 Token，优先加载关键信息 |
| 💾 **记忆系统** | 短期记忆 + 长期记忆 | 跨会话保持上下文，真正"懂"用户 |
| 🦠 **进化机制** | 根据用户反馈自我迭代 | 越用越聪明，持续改进 |
| 🛡️ **安全机制** | 命令白名单 + 权限控制 | 保护用户数据安全 |
| 🔌 **MCP 协议** | 标准化工具调用接口 | 与 Claude Code 等客户端无缝集成 |
1.3.2 技术亮点
┌─────────────────────────────────────────────────────────────────────┐
│ 技术亮点 │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ 🎯 极简架构 │
│ • 核心代码仅 ~2,700 行 │
│ • 单一入口，职责清晰 │
│ • 模块化设计，易于扩展 │
│ │
│ 🎯 TypeScript 严格模式 │
│ • 完整的类型定义 │
│ • 编译时错误检查 │
│ • 更好的 IDE 支持 │
│ │
│ 🎯 零依赖（运行时） │
│ • 纯 Node.js API 实现 │
│ • 减少依赖风险 │
│ • 更快的安装速度 │
│ │
│ 🎯 智能 Token 管理 │
│ • 动态优先级排序 │
│ • 自动截断策略 │
│ • 预算超支保护 │
│ │
└─────────────────────────────────────────────────────────────────────┘1.3.3 与 OpenClaw 的对比
┌─────────────────────────────────────────────────────────────────────┐
│ MiniClaw vs OpenClaw 对比 │
├──────────────────┬─────────────────────┬────────────────────────────┤
│ 维度 │ OpenClaw │ MiniClaw │
├──────────────────┼─────────────────────┼────────────────────────────┤
│ 代码规模 │ ~10,000+ 行 │ ~2,700 行 │
│ 功能完整度 │ 完整功能集 │ 核心功能 │
│ 部署复杂度 │ 需要配置环境 │ npx 一键运行 │
│ 学习曲线 │ 陡峭 │ 平缓 │
│ 定制化 │ 高度可定制 │ 模板化配置 │
│ 社区活跃度 │ 高 │ 成长中 │
│ 适用场景 │ 生产环境 │ 学习/快速体验 │
└──────────────────┴─────────────────────┴────────────────────────────┘1.4 快速开始
1.4.1 安装与运行
# 一键运行（无需安装）
npx miniclaw
# 或全局安装
npm install -g miniclaw
miniclaw1.4.2 首次使用流程
┌─────────────────────────────────────────────────────────────────────┐
│ 首次使用流程 │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ 步骤 1: 运行 miniclaw │
│ └─► 自动创建 ~/.miniclaw/ 目录结构 │
│ │
│ 步骤 2: 编辑 DNA 模板 │
│ └─► 修改 ~/.miniclaw/dna/IDENTITY.md 定义身份 │
│ └─► 修改 ~/.miniclaw/dna/AGENTS.md 定义行为规则 │
│ │
│ 步骤 3: 在 Claude Code 中配置 MCP │
│ └─► 添加 miniclaw 到 MCP 服务器列表 │
│ │
│ 步骤 4: 开始对话 │
│ └─► 享受个性化的 AI 助手体验！ │
│ │
└─────────────────────────────────────────────────────────────────────┘本章小结
┌─────────────────────────────────────────────────────────────────────┐
│ 第一章 核心要点 │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ 🦞 MiniClaw 是 OpenClaw 的极简实现版本 │
│ │
│ 🎯 核心定位：微内核 + 进化 + 记忆 │
│ │
│ 💡 设计哲学：最低门槛体验 OpenClaw 核心功能 │
│ │
│ ✨ 特色亮点： │
│ • DNA 模板系统（9 个 Markdown 文件） │
│ • ACE 自适应上下文引擎 │
│ • 记忆系统（短期 + 长期） │
│ • 进化机制（自我迭代） │
│ │
│ 🚀 快速开始：npx miniclaw │
│ │
└─────────────────────────────────────────────────────────────────────┘本文档是《MiniClaw 深度解析》系列的第一章，后续章节将详细介绍架构设计、核心模块、DNA 模板系统、ACE 引擎、记忆系统等核心内容。
讨论回复
0 条回复还没有人回复