📋 项目概述
| 属性 | 详情 |
|---|---|
| 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+
🚀 零安装快速开始
{
"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 一键运行 |
| 功能 | 完整（频道、定时任务等） | 核心（记忆、进化） |
| 目标用户 | 开发者/团队 | 个人用户 |
---
💡 核心价值
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