build-your-own-openclaw vs OpenClaw：教学版与生产版差异、取舍与刻意简化全对比

• 示例工程

build-your-own-openclaw 是 OpenClaw 的"教学版"：一个用 18 个渐进步骤教你从零搭建 AI Agent 的开源教程项目。而 OpenClaw 是功能完整的生产级 AI 智能体系统。本文帮你逐层对比教学版与生产版的差异、设计取舍和那些被刻意简化掉的部分，让你快速判断该从哪个版本入手。

📌 一句话定位：它们到底是什么关系？

教学版的思路很清晰：每个步骤都是上一步骤的增量。你读一个 README、跑一遍代码，就能看到智能体长出一块新能力。官方在 README.md 中把 18 步划为四个阶段：

• 阶段一（步骤 0-6）：能干的单智能体 —— 聊天、工具、技能、持久化、压缩、联网
• 阶段二（步骤 7-10）：事件驱动架构 —— 事件总线、热重载、多渠道接入、WebSocket
• 阶段三（步骤 11-15）：自主与多智能体 —— 路由、定时任务、多层提示词、消息回发、子智能体调度
• 阶段四（步骤 16-17）：生产就绪 —— 并发控制、长期记忆

📈 规模对比：从 582 行到 4781 行代码

教学版每一步的代码量是精心控制过的，你可以直观看到复杂度是如何一步步"涨"起来的：

💡 对比生产版 OpenClaw：教学版终点 4781 行代码覆盖了 OpenClaw 的核心骨架，但功能面远小于完整版——这正是"教学 vs 生产"的分水岭。

✂️ 刻意简化：教学版"永不补上"的功能

项目专门用 GAP.md 记录了哪些生产版功能永远不会加进教程。这是理解两者差异最有价值的文档：

1. 模板变量替换被移除了

• 生产版：AGENT.md/SKILL.md中支持{{variable}}占位符替换
• 教学版：直接硬编码路径

工作区里的 default_workspace/BOOTSTRAP.md 和 default_workspace/skills/cron-ops/SKILL.md 中还保留着{{workspace}}、{{crons_path}}这类占位符——它们是从生产版搬来的参考资料，教程代码并不支持替换，属于"给你看一眼，但不教你实现"。

2. REST API 只留了 WebSocket

• 生产版：完整的 REST API，覆盖 skills / agents / crons / sessions / memories 等资源的增删改查（FastAPI 路由）
• 教学版：只有一个/wsWebSocket 端点

理由写得很直白：REST 端点"增加复杂度却不教核心概念"，而教程要聚焦实时通信这条主线。

⚖️ 四大设计取舍：为什么这么教

取舍一：事件总线，而不是更简单的直接调用

07-event-driven 是全程改动最大的一步。消息源和智能体执行之间插入了一个 EventBus（发布/订阅），代码量从 2041 行直接跳到 2464 行。

为什么值得？后续所有能力——手机渠道接入（09-channels）、定时任务、多智能体路由——都建立在"入站事件 → 工作进程 → 出站事件"这条流水线上。教学版用 2464 行实现了生产版架构的同构骨架，只是砍掉了渠道生态。

取舍二：记忆用"子智能体"而不是向量数据库

17-memory 对比了四种记忆方案，教学版选择了最"笨"也最透明的一种：专门的记忆智能体 cookie 管理memories/目录下的 Markdown 文件（topics / projects / daily-notes 三层结构）。

你在 default_workspace/agents/cookie/AGENT.md 里能直接看到 cookie 的职责定义，配合 default_workspace/AGENTS.md 中的调度规则，整个记忆系统完全可读可改——这就是教学版的取舍逻辑：宁可简单可解释，不要黑盒高性能。

取舍三：并发控制只到"信号量"这一层

16-concurrency-control 用asyncio.Semaphore实现每智能体max_concurrency限制，达到上限就阻塞。生产版在队列削峰、失败退避、多进程隔离上还有大量工程细节，教学版一概不做——src/mybot/server/agent_worker.py 里的信号量实现就是全部。

取舍四：上下文压缩只用"截断 + 总结"两板斧

05-compaction 的 src/mybot/core/context_guard.py 逻辑只有三步：Token 超阈值 → 先截断过大的工具结果 → 还超就把旧消息总结后滚动到新会话。没有生产版的分段记忆、滑动窗口等复杂策略，但 80 行左右的代码把"上下文会爆"这个核心问题讲透了。

🎯 该用哪个版本？一张表帮你选

🚀 快速上手教学版

git clone https://gitcode.com/gh_mirrors/bu/build-your-own-openclaw cd build-your-own-openclaw # 配置 API 密钥 cp default_workspace/config.example.yaml default_workspace/config.user.yaml # 编辑 config.user.yaml 填入你的 LLM provider 和 key # 跑第一步 cd 00-chat-loop uv run my-bot chat

配置模板见 default_workspace/config.example.yaml，各家 LLM 提供商的写法参考 PROVIDER_EXAMPLES.md。

小结：build-your-own-openclaw 与 OpenClaw 不是"简化版 vs 完整版"的功能差距，而是**"会教 vs 会干"**的定位差异。教学版刻意砍掉了模板替换、REST API 等生产功能（详见 GAP.md），把 4781 行代码全部花在讲清核心架构上。想学会造智能体，跟教程走；想要直接用，上生产版。

• 示例工程