作品简介
这是一本从原理和实战角度教读者打造可靠的生产级Agent系统的著作。它以当下流行的、功能强大的Agent框架OpenClaw为研究和学习的样本，系统地讲解了一个完整的Agent系统的架构设计、代码实现、安全防护、故障转移以及单Agent的决策和多Agent的协作，弥补了理论与工程之间的鸿沟、框架使用与源码理解之间的鸿沟、单一功能与系统思维之间的鸿沟，为Agent 从 Demo 到生产的工程化落地这一核心难题提供完整的解决方案。
全书共 8 章，按照系统架构、核心引擎、关键子系统、安全与扩展、工程实践的顺序展开。
第 1 章 OpenClaw 系统架构全景。说明 OpenClaw 的功能定位、系统边界和整体组成，解析五层架构及各层之间的职责关系，并介绍 TypeScript ESM 模块化设计、Monorepo 代码组织等技术选择及其适用条件。
第 2 章 Agent Loop 核心机制。介绍 ReAct、Plan-and-Execute、Reflexion 等决策架构，并分析 OpenClaw 的三层嵌套 Agent Loop：外层处理重试与整体控制，中层管理单次模型交互，内层负责工具调用和并行执行。本章还涉及事件驱动、流式响应、Thinking 标签处理、错误分类和调试方法。
第 3 章 向量记忆系统。介绍基于 SQLite 与 sqlite-vec 的向量存储方案，分析 BM25 关键词检索、向量语义检索和混合搜索的实现，并讨论 MMR、时间衰减、多语言查询扩展、Agentic RAG 与记忆刷新机制。在工程结构方面，本章还涉及类继承、工厂方法、双层缓存、双后端与索引安全重建。
第 4 章 消息路由与多 Agent 协作。梳理消息从用户终端进入网关、分配给 Agent 并返回响应的完整流程，分析七层路由匹配、Session Key 构建和会话隔离策略；同时比较 MCP 与 A2A 协议的职责边界，说明 OpenClaw 在本地网关架构中的多 Agent 协作方式。
第 5 章 安全与工具策略。介绍由工具策略管道、循环检测熔断器、安全审计和 Docker 沙盒隔离构成的四层防护体系，并讨论间接提示注入、双模型防护、约束性生成和最小权限等安全机制的实现思路与适用范围。
第 6 章 扩展体系与 Hook 机制。分析三层扩展体系、Hook 的注册与执行机制，以及自定义 Hook 的开发流程，说明如何在保持核心框架边界清晰的前提下接入业务逻辑。
第 7 章 上下文管理与故障转移。分析五层上下文管理策略，包括上下文窗口限制、历史消息裁剪与压缩处理，并介绍三级故障转移链的实现。本章重点讨论长时任务中的上下文增长、模型或外部服务不可用，以及相应的控制与恢复方法。
第 8 章 工程实践与实战任务。通过面向不同角色的实践任务，覆盖消息生命周期追踪、自定义 Hook、插件开发、上下文压缩分析、多 Agent 路由和会话管理等场景，用于检验书中方法，并帮助读者迁移到类似系统的设计与实现。