起因很简单,我想自己做一个类似 OpenClaw 的东西。
但找了一圈资料,官方文档全是教你怎么用的,没人认真讲过它内部是怎么实现的。没办法,只能自己啃源码,边看边记笔记,搞了几
个月整理出来一套文档,分享给有需要的佬友。
大概分了三块内容:
第一块是安装教程,147篇,从零开始装 OpenClaw,接 Anthropic、OpenAI、Gemini 这些模型,连 WhatsApp、Telegram、Discord
各种频道,常见的坑和报错基本都覆盖了。没装过的从这开始看就行。
第二块是工程主线,59篇,按实际的调用链路来拆的。一条消息从用户发出来,经过 Gateway、Routing、Agent
执行链,最后模型回复再回到用户,中间过了哪些对象哪些函数,数据怎么流的,我尽量都写清楚了。
第三块是AI 核心框架,22篇,这块最硬核也是我花时间最多的。上下文窗口管理和截断策略、Agent 执行状态机的生命周期、Tool
Use 的完整调用链路、Provider 挂了之后怎么自动降级、向量加 BM25 混合检索的记忆系统、还有 Hook
插件注入机制,这些东西官方文档压根不会告诉你。
说白了官方文档教你怎么配置,但不告诉你为什么这么设计。我写这套文档的目标就是到函数级别的精度,每个核心概念都给出源码入
口,你知道从哪开始读、数据结构长啥样、边界条件在哪。
适合想搞清楚 OpenClaw 内部实现的人,或者自己想做智能体框架、消息通道适配、路由调度这些的。只是想用 OpenClaw
聊天的话看官方文档就够了,不用折腾这个。
文档地址:https://openclaw-docs.dx3n.cn
GitHub: GitHub - yeuxuan/openclaw-docs: openclaw 剖析、拆解、教程在线文档
写了挺久,难免有错的地方,欢迎评论区指正。