OpenClaw 核心架构的教学级精简复现，用最小代码量展示 AI Agent 系统设计（双层循环、EventStream、Session 持久化、三层上下文管理、WebSocket RPC 网关等）。
openclaw-mini 是 OpenClaw 核心架构的教学级精简复现项目，使用 TypeScript 编写（92.2%），运行于 Node.js ≥ 20 环境。项目目标不是提供生产级 Agent 框架，而是以最小代码量展示 AI Agent 系统设计的核心主线。
项目采用四层架构组织：核心层涵盖 Agent 双层循环（外层 follow-up + 内层工具执行）、基于 MiniAgentEvent 判别联合的 20 种类型化事件流、JSONL 格式 Session 持久化（内存缓存 + 磁盘双写）、三层递进上下文管理（Pruning 裁剪 → Compaction 自适应分块摘要 → Bootstrap 按需加载配置）以及 10 个内置可扩展工具；扩展层实现关键词检索长期记忆、SKILL.md frontmatter 技能系统和多来源触发的主动心跳唤醒；工程层包含 Session Key、三级 Tool Policy、Context Window Guard 等生产级防护机制；网关层提供完整的 WebSocket RPC 服务，包括 Challenge-Response 握手、Timing-safe 认证、Pub/Sub 广播与背压控制、ACK-then-stream 消息模式和 150ms Delta 限流。
多模型接入基于 @mariozechner/pi-ai 适配层，支持 Anthropic、OpenAI、Google、Groq 等 22+ 提供商，可通过 baseUrl 配置接入任意 OpenAI 兼容 API。项目同时依赖 grammy 提供 Telegram Bot 集成能力（功能完整度待确认）。代码提炼了 20 种设计模式，保留"为什么这么设计"的注释，建议按核心→扩展→网关→工程的路径阅读。
安装与快速开始#
git clone git@github.com:voocel/openclaw-mini.git
cd openclaw-mini
pnpm install
cp .env.example .env
# 配置至少一个模型 Key 后
pnpm dev
使用方式#
- CLI 模式：
pnpm dev -- --provider openai --model gpt-4o - Gateway 模式：
pnpm gateway -- --port 8080 --token mySecret - 编程接口：
import { Agent } from "openclaw-mini"后通过agent.subscribe()订阅事件、agent.run()执行任务
待确认信息#
- OpenClaw 主仓库地址未在 README 中显式链接，上游项目是否公开可访问无法确认
- npm 注册表上
openclaw-mini是否已实际发布待验证（package.json 中 publishConfig 设为 public，但 GitHub Releases 无发布记录） - GitHub Topics 含
clawdbot，但 README 未解释其与 OpenClaw 的关系 - 项目明确声明不建议用于生产，工程层模块的具体完成度需进一步验证