MiniClaw 项目分析报告

🦞 MiniClaw 是 OpenClaw 的极简实现版本，一个微内核智能体插件，为 AI 工作伙伴提供"神经系统"。

📋 报告目录

本报告共分 10 章，全面解析 MiniClaw 项目：

🎯 核心亮点

1. 微内核架构

传统 Agent 框架：臃肿、耦合、难扩展
MiniClaw：轻量 (~2,700 行) + 插件化 + 易维护

2. 三层架构模型

┌─────────────────────────────────────┐
│  Interface 层 (身体) - MCP 协议实现  │
├─────────────────────────────────────┤
│  Kernel 层 (大脑) - ACE 引擎、记忆   │
├─────────────────────────────────────┤
│  DNA 层 (基因) - 性格、规则、身份    │
└─────────────────────────────────────┘

3. ACE 自适应上下文引擎

• 5 种时间模式：morning/work/break/evening/night
• Token 预算管理：优先级截断，保证核心内容
• 会话延续检测：避免重复加载

4. 双层记忆系统

短期记忆 (每日日志) → 记忆蒸馏 → 长期记忆 (MEMORY.md)
压缩比约 10:1

5. 自动进化协议

用户偏好 → 自动更新 USER.md
性格纠正 → 自动更新 SOUL.md
环境配置 → 自动更新 TOOLS.md

6. 安全机制

• 命令白名单：仅允许安全的只读命令
• 执行限制：超时 10s、输出截断 1MB
• 数据隐私：所有数据本地存储

🚀 快速开始

// MCP 客户端配置
{
  "mcpServers": {
    "miniclaw": {
      "command": "npx",
      "args": ["-y", "github:8421bit/miniclaw"],
      "env": {
        "MINICLAW_TOKEN_BUDGET": "12000"
      }
    }
  }
}

🔗 相关链接

• 项目地址：https://github.com/8421bit/miniclaw
• 许可证：MIT License
• 版本：v0.5.0 "The Nervous System"

💡 提示：本报告基于 MiniClaw v0.5.0 版本源码分析，内容详实，配有丰富的图表和代码示例。