MiniClaw 深度研究报告

📋 项目概述

设计哲学

💡 "最低门槛体验 OpenClaw 核心功能"

🏗️ 架构设计

核心公式

技术栈

• 语言: TypeScript (2个核心源文件)
• 协议: MCP (Model Control Protocol)
• 存储: 本地文件系统 (~/.miniclaw/)
• 运行环境: Node.js v18+

🚀 零安装快速开始

{
  "mcpServers": {
    "miniclaw": {
      "command": "npx",
      "args": [
        "-y",
        "github:8421bit/miniclaw"
      ],
      "env": {
        "MINICLAW_TOKEN_BUDGET": "12000"
      }
    }
  }
}

支持的客户端: Claude Desktop、Cursor、Qoderwork、WorkBuddy 等支持 MCP 协议的编辑器

🧬 DNA 模板系统（9个核心文件）

⚡ 核心机制

1. ACE 自适应上下文引擎 (Adaptive Context Engine)

• 动态管理上下文窗口
• 自动压缩和归档历史记录
• Token 预算控制

2. 心跳与进化机制

• 心跳周期: 每 30 分钟
• 自动进化: 根据用户反馈自动更新 SOUL.md、USER.md 等文件
• 文件健康检查: 检测文件更新状态，提示维护

3. 记忆系统

• 所有记忆本地存储 (~/.miniclaw/)
• 不上传云端
• MEMORY.md 仅在主会话加载（安全考虑）

🔒 安全机制

命令执行白名单

执行限制

• 超时: 10秒
• 输出截断: 1MB

数据安全

• 所有数据本地存储
• 无云端上传
• 除了发送给大模型的对话，从不上云

🆚 与 OpenClaw 的关系

💡 核心价值

1. 有温度的 AI 助手 - 不只是工具，而是有性格、会记住你的"第二大脑" 2. 零配置上手 - 几行 JSON 配置即可使用 3. 持续进化 - 随着对话自动成长，越来越了解用户 4. 数据隐私 - 所有记忆本地存储

📚 相关资源

• GitHub: https://github.com/8421bit/miniclaw
• 智柴深度解析: https://zhichai.net/topic/176922682
• LobeHub MCP: https://lobehub.com/mcp/8421bit-miniclaw
• 上游项目: https://github.com/openclaw/openclaw