【MiniClaw 深度解析】第一章：项目概述

# 第一章：项目概述 > 📖 本章介绍 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 安装与运行 ```bash # 一键运行（无需安装） npx miniclaw # 或全局安装 npm install -g miniclaw miniclaw ``` ### 1.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 引擎、记忆系统等核心内容。*