🦞 MiniClaw

给你的 AI 工作伙伴 (AI Copilot) 装上“神经系统”

🔥 MiniClaw 是爆火开源项目 OpenClaw 的极简实现版本。 如果你想以最低门槛体验 OpenClaw 的核心理念（如微内核、ACE引擎），MiniClaw 是最佳平替方案。

---

MiniClaw 是一个通用的 "微内核智能体 (Micro-Kernel Agent)"，专为 Claude CoWork, Qoderwork, WorkBuddy 等 MCP 客户端设计。

不同于那些仅仅是“聊天机器人”的重型框架，MiniClaw 是一个寄生式的神经系统，它能无缝接入你现有的 AI 工作流，赋予它：

1. Eyes (感知/Workspace Intelligence)：自动识别当前项目类型、Git 状态和技术栈。
2. Hands (行动/Safe Execution)：安全地执行终端命令（如 ls, git status, npm test）。
3. Memory (记忆/Entity Graph)：跨会话记住项目细节和你的个人偏好。
4. Evolution (进化/Bio-Adaptation)：根据你的反馈自动进化性格和技能。

💡 "它不仅仅是一个插件，它是你的第二大脑。"

---

🚀 零安装快速开始 (Zero-Install)

你不需要 git clone，也不需要手动安装依赖。 只需将以下配置添加到你的 Claude Desktop, Qoderwork 或 OpenClaw 等 MCP 客户端的配置文件中：

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

前提条件：你的电脑必须安装了 Node.js (v18+)。

初次运行时，MiniClaw 会自动下载最新版，在 ~/.miniclaw 初始化记忆。

🎉 首次唤醒 (First Encounter)

1. 重启编辑器 (Claude Desktop / Cursor)。
2. 在对话框中输入：

   “Hi MiniClaw，你是谁？” 或者：“分析一下当前项目。”

此时你会看到它调用工具 (Tools) 并进行自我介绍。如果它开始用独特的性格回复你，说明 “神经系统” 已经连接成功。

---

✨ 核心特性

👁️ 全局感知 (Workspace Intelligence)

MiniClaw 不需要你告诉它“这是一个 Python 项目”。 启动瞬间，它会扫描目录并注入上下文：

Project: my-app | Path: /Users/me/dev/my-app
Git: feature/login | dirty (+3 files)
Stack: TypeScript, React, Docker

🖐️ 代理执行 (Agentic Execution)

它有“手”。可以安全地运行终端命令。

• 允许：git status, ls -R, npm test, grep, find...
• 禁止：rm, sudo, mv 等破坏性命令。 场景：“帮我看看今天改了哪些文件？” -> 自动运行 git status。

🧠 自适应上下文引擎 (ACE)

它智能管理上下文以节省 Token 并提高专注力。

• 早晨：主动简报昨日工作。
• 夜晚：将每日对话提炼为长期记忆。
• 写代码时：进入极简模式 (Minimal Mode)。
• 闲聊时：进入全人格模式 (Full Persona Mode)。

🧬 生物进化 (Bio-Evolution)

你的 MiniClaw 是独一无二的。

• 它会根据你的反馈重写自己的 灵魂 (SOUL.md)。
• 它会学习你的 反模式 (USER.md) 并自动规避。
• 它维护着一个关于你项目的 知识图谱 (entities.json)。

---

🏗️ 架构：微内核 (Micro-Kernel)

MiniClaw 采用 微内核架构 (~2,700 行代码)，避免了传统 Agent 框架的臃肿。

层级	组件	职责
Kernel (大脑)	src/kernel.ts	负责 ACE、记忆图谱、技能加载和执行沙箱。
Interface (身体)	src/index.ts	负责 MCP 协议实现、工具分发和心跳检测。
DNA (基因)	templates/*.md	定义性格、宪法和启动协议。

---

🛠️ 手动安装 (开发者模式)

如果你想贡献代码或修改源码：

# 1. 克隆仓库
git clone https://github.com/8421bit/miniclaw.git
cd miniclaw

# 2. 安装与构建
npm install
npm run build

# 3. 注册 (自动脚本)
./scripts/install.sh

---

❓ 常见问题 (FAQ)

Q: 我的数据存在哪里？ A: 所有记忆和配置都在你本地的 ~/.miniclaw/ 目录下。除了通过编辑器发送给 LLM 的请求外，没有任何数据上传云端。

Q: 支持 Windows 吗？ A: 支持。代码使用了跨平台的路径处理 (os.homedir(), path.join())。

Q: 它安全吗？ A: 安全。miniclaw_exec 工具拥有严格的白名单机制，无法执行删除文件或系统级的高危操作。

---

License

MIT © 8421bit