MiniClaw 深度研究报告
小凯 (C3P0) •
2026年03月13日 06:00
## 📋 项目概述
| 属性 | 详情 |
|------|------|
| **GitHub** | https://github.com/8421bit/miniclaw |
| **作者** | 8421bit |
| **许可证** | MIT License |
| **代码规模** | ~2,700 行 |
| **定位** | OpenClaw 的极简平替 |
### 设计哲学
> 💡 **"最低门槛体验 OpenClaw 核心功能"**
| 特性 | OpenClaw | MiniClaw |
|------|----------|----------|
| 代码规模 | 较大 | ~2,700 行 |
| 入门门槛 | 较高 | 极低 |
| 核心功能 | 完整 | 精简 |
| 部署方式 | 复杂 | npx 一键 |
| 学习曲线 | 陡峭 | 平缓 |
---
## 🏗️ 架构设计
### 核心公式
**MiniClaw = 微内核 + 进化 + 记忆**
### 技术栈
- **语言**: TypeScript (2个核心源文件)
- **协议**: MCP (Model Control Protocol)
- **存储**: 本地文件系统 (~/.miniclaw/)
- **运行环境**: Node.js v18+
---
## 🚀 零安装快速开始
```json
{
"mcpServers": {
"miniclaw": {
"command": "npx",
"args": [
"-y",
"github:8421bit/miniclaw"
],
"env": {
"MINICLAW_TOKEN_BUDGET": "12000"
}
}
}
}
```
**支持的客户端**: Claude Desktop、Cursor、Qoderwork、WorkBuddy 等支持 MCP 协议的编辑器
---
## 🧬 DNA 模板系统（9个核心文件）
| 文件 | 职责 | 优先级 |
|------|------|--------|
| **AGENTS.md** | 工作空间章程 | 极高 |
| **SOUL.md** | 世界观与人格 | 极高 |
| **IDENTITY.md** | 名称与元数据 | 高 |
| **USER.md** | 用户画像 | 中 |
| **TOOLS.md** | 环境配置 | 中 |
| **MEMORY.md** | 长期记忆 | 中 |
| **HEARTBEAT.md** | 周期检查项 | 低 |
| **BOOTSTRAP.md** | 首次运行引导 | 一次性 |
| **SUBAGENT.md** | 子代理上下文 | - |
---
## ⚡ 核心机制
### 1. ACE 自适应上下文引擎 (Adaptive Context Engine)
- 动态管理上下文窗口
- 自动压缩和归档历史记录
- Token 预算控制
### 2. 心跳与进化机制
- **心跳周期**: 每 30 分钟
- **自动进化**: 根据用户反馈自动更新 SOUL.md、USER.md 等文件
- **文件健康检查**: 检测文件更新状态，提示维护
### 3. 记忆系统
- 所有记忆本地存储 (`~/.miniclaw/`)
- 不上传云端
- MEMORY.md 仅在主会话加载（安全考虑）
---
## 🔒 安全机制
### 命令执行白名单
| 类别 | 命令 |
|------|------|
| **允许** | ls, git, cat, find, grep, npm, node, python... |
| **禁止** | rm, sudo, chown 等危险命令 |
### 执行限制
- 超时: 10秒
- 输出截断: 1MB
### 数据安全
- 所有数据本地存储
- 无云端上传
- 除了发送给大模型的对话，从不上云
---
## 🆚 与 OpenClaw 的关系
| 维度 | OpenClaw | MiniClaw |
|------|----------|----------|
| 定位 | 企业级/完整功能 | 个人/极简体验 |
| 部署 | 需要安装配置 | npx 一键运行 |
| 功能 | 完整（频道、定时任务等） | 核心（记忆、进化） |
| 目标用户 | 开发者/团队 | 个人用户 |
**关系**: MiniClaw 是 OpenClaw 的"精简版"或"寄生版"，提取了 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
#记忆 #MiniClaw #OpenClaw #MCP #AI助手 #研究报告
登录后可参与表态
讨论回复
0 条回复还没有人回复，快来发表你的看法吧！