


这是一本从原理和实战角度教读者打造可靠的生产级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 路由和会话管理等场景,用于检验书中方法,并帮助读者迁移到类似系统的设计与实现。
封面
前折页
书名页
版权页
前言
目录
第1章 OpenClaw系统架构全景
1.1 OpenClaw产品定位与核心价值
1.1.1 开源个人AI助手网关的市场定位
1.1.2 多平台连接能力:10余个消息通道支持
1.1.3 本地优先的隐私保护设计
1.1.4 生产级工程化设计理念
1.2 五层架构设计深度解析
1.2.1 架构全景图与层次职责
1.2.2 控制面:系统启动与配置管理
1.2.3 网关层:WebSocket协议设计
1.2.4 消息通道层:平台适配器实现
1.3 技术栈与项目结构
1.3.1 TypeScript ESM模块化设计
1.3.2 Node.js 22及以上版本运行时特性
1.3.3 Monorepo架构与代码组织
1.3.4 开发环境与工具链
第2章 Agent Loop核心机制
2.1 Agent决策架构演进
2.1.1 ReAct架构:推理与行动的协同
2.1.2 Plan-and-Execute架构:规划与执行的解耦
2.1.3 Reflexion架构:自我反思与经验学习
2.1.4 推理拓扑的演进:从链到图
2.1.5 Ralph Loop范式:让AI持续工作直到真正完成
2.2 OpenClaw三层嵌套架构
2.2.1 “感知—思考—行动”循环的哲学基础
2.2.2 外层循环:run.ts负责重试控制
2.2.3 中层循环:attempt.ts负责单次大模型交互管理
2.2.4 内层循环:subscribe.ts负责工具调用与并行执行
2.3 事件驱动与流式处理
2.3.1 事件驱动架构设计
2.3.2 流式响应与Thinking标签解析
2.3.3 错误分类与处理策略
2.3.4 代码追踪与调试实战
第3章 向量记忆系统
3.1 向量数据库技术选型
3.1.1 主流向量数据库技术对比
3.1.2 sqlite-vec嵌入式向量搜索引擎
3.1.3 向量索引算法:HNSW与IVF对比
3.1.4 OpenClaw的存储架构设计
3.2 混合搜索算法
3.2.1 混合搜索的设计动机
3.2.2 BM25关键词搜索
3.2.3 向量语义搜索
3.2.4 混合搜索
3.2.5 搜索主流程编排
3.3 记忆优化与Agentic RAG
3.3.1 MMR算法
3.3.2 时间衰减机制
3.3.3 多语言查询扩展
3.3.4 Agentic RAG与记忆刷新
3.4 系统架构深度解析
3.4.1 三层类继承体系
3.4.2 工厂方法与双层缓存
3.4.3 Embedding Provider工厂与Auto选择
3.4.4 双后端架构
3.4.5 数据存储模式
3.4.6 安全重建索引
第4章 消息路由与多Agent协作
4.1 全链路消息流转机制
4.1.1 消息生命周期全景图
4.1.2 七层路由匹配引擎
4.1.3 Session Key构建与会话隔离策略
4.1.4 跨通道身份关联技术
4.2 多Agent协作架构设计
4.2.1 三种协作架构模式对比
4.2.2 MCP:统一工具连接标准
4.2.3 A2A协议:跨供应商的Agent协作
4.2.4 OpenClaw的多Agent实现
第5章 安全与工具策略
5.1 纵深防御四层安全架构
5.1.1 Layer 1:工具策略管道
5.1.2 Layer 2:循环检测熔断器
5.1.3 Layer 3:安全审计系统
5.1.4 Layer 4:Docker沙盒隔离
5.2 提示注入防护
5.2.1 间接提示注入攻击原理与案例
5.2.2 双重大模型防护模式
5.2.3 约束性生成与JSON Schema设计
5.2.4 最小权限原则与Human-in-the-loop机制
第6章 插件与扩展生态
6.1 三层扩展体系架构
6.1.1 插件层
6.1.2 扩展层
6.1.3 Skill层
6.1.4 插件生态案例分析
6.2 Hook机制
6.2.1 Hook机制的设计原理
6.2.2 核心Hook详解
6.2.3 Hook全景
6.3 自定义Hook实战
第7章 上下文管理与故障转移
7.1 五层递进式上下文管理
7.1.1 大模型上下文窗口的物理限制与“Lost in the Middle”现象
7.1.2 Layer 1和2:预防性策略
7.1.3 Layer 3和4:恢复性策略
7.1.4 Layer 5:历史消息裁剪
7.2 上下文压缩前沿技术
7.2.1 Token估算推导
7.2.2 自适应压缩比算法
7.2.3 链式摘要算法深度解析
7.2.4 降级策略与边界处理
7.3 三级故障转移链设计
7.3.1 故障分类
7.3.2 Level 1:Profile轮换与指数退避策略
7.3.3 Level 2:Thinking Budget降级
7.3.4 Level 3:模型回退
7.4 故障检测与恢复策略
7.4.1 超时检测:isTimeoutError函数递归检测实现
7.4.2 熔断器状态:开启→半开→关闭
7.4.3 健康检查与自动恢复机制
7.4.4 AI网关:故障转移能力的下沉
第8章 从配置到代码的全景演练实践
8.1 实践任务总览与学习路径
8.1.1 双视角任务矩阵
8.1.2 推荐的学习路径
8.2 任务A1:安装部署与初始化
8.2.1 环境准备与依赖检查
8.2.2 源码获取与构建
8.2.3 交互式引导向导
8.2.4 核心配置文件结构
8.2.5 启动与验证
8.3 任务A2:编写自定义Skill
8.3.1 Skill工作原理
8.3.2 六级优先级加载机制
8.3.3 门控检查机制
8.3.4 系统限制常量
8.3.5 编写实践:会议纪要助手
8.4 任务A3:多渠道接入配置
8.4.1 OpenClaw支持的渠道生态
8.4.2 OpenClaw的渠道安全策略
8.4.3 OpenClaw的渠道配置实践
8.5 任务A4:安全策略与审计
8.5.1 安全审计工具
8.5.2 四大审计维度
8.5.3 审计报告解读
8.5.4 安全加固实施
8.6 任务A5:定时任务与自动化
8.6.1 Cron调度配置
8.6.2 定时任务完整配置
8.6.3 Webhook触发配置
8.6.4 内置Hook说明
8.7 任务A6:多Agent路由与会话管理
8.7.1 七层路由优先级体系
8.7.2 Agent矩阵设计
8.7.3 路由绑定配置
8.7.4 会话管理
8.8 任务B1:消息生命周期追踪
8.8.1 核心源文件索引
8.8.2 完整生命周期时序
8.8.3 外层重试机制分析
8.9 任务B2:自定义Hook开发
8.9.1 Hook双层架构
8.9.2 三种执行模式
8.9.3 消息统计仪表盘开发
8.9.4 Hook注册与测试
8.10 任务B3:插件开发
8.10.1 两阶段生命周期
8.10.2 配置Schema定义
8.10.3 DisclaimerPlugin完整实现
8.10.4 插件部署与配置
8.11 任务B4:上下文压缩策略分析
8.11.1 压缩触发时机
8.11.2 四阶段流水线
8.11.3 核心参数
8.11.4 关键信息保留机制
后折页
封底
机械工业出版社 京icp备14043556号-1 (署)网出证(京)字第214号 Copyright (C) 2001 CmpBook. All Rights Reserved