OpenClaw 技術內幕
劉琦
- 出版商: 機械工業
- 出版日期: 2026-09-01
- 售價: $474
- 語言: 簡體中文
- 頁數: 212
- ISBN: 7111817079
- ISBN-13: 9787111817079
下單後立即進貨 (約4週~6週)
相關主題
商品描述
這是一本從原理和實戰角度教讀者打造可靠的生產級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 路由和會話管理等場景,用於檢驗書中方法,並幫助讀者遷移到類似系統的設計與實現。
作者簡介
劉琦 互聯網大廠高級算法研究員,擁有近10年算法與AI應用研發經驗。近年主要研究方向為大語言模型應用、AI Agent架構設計與遊戲智能化落地。 當前研究方向包含遊戲AI教練和遊戲智能NPC,曾深入研究及參與領域大模型基礎研發,以及短視頻AI創作的算法研發,在大語言模型、AI 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 TypeScriptESM模塊化設計
1.3.2 Node.js22及以上版本運行時特性
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 RalphLoop範式:讓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-vcc嵌入式向量搜索引擎
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 記憶優化與AgentRAG
3.3.1 MMR算法
3.3.2 時間衰減機制
3.3.3 多語言查詢擴展
3.3.4 AgenticRAG與記憶刷新
3.4 系統架構深度解析
3.4.1 三層類繼承體系
3.4.2 工廠方法與雙層緩存
3.4.3 EmbeddingProvider工廠與Auto選擇
3.4.4 雙後端架構
3.4.5 數據存儲模式
3.4.6 安全重建索引
第4章 消息路由與多Agent協作
4.1 全鏈路消息流轉機制
4.1.1 消息生命周期全景圖
4.1.2 七層路由匹配引擎
4.1.3 SessionKey構建與會話隔離策略
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 Layer1:工具策略管道
5.1.2 Layer2:循環檢測熔斷器
5.1.3 Layer3:安全審計系統
5.1.4 Layer4:Docker沙盒隔離
5.2 提示註入防護
5.2.1 間接提示註入攻擊原理與案例
5.2.2 雙重大模型防護模式
5.2.3 約束性生成與JSONSchema設計
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 大模型上下文窗口的物理限制與“LostintheMiddle”現象
7.1.2 Layer1和2:預防性策略
7.1.3 Layer3和4:恢覆性策略
7.1.4 Layer5:歷史消息裁剪
7.2 上下文壓縮前沿技術
7.2.1 Token估算推導
7.2.2 自適應壓縮比算法
7.2.3 鏈式摘要算法深度解析
7.2.4 降級策略與邊界處理
7.3 三級故障轉移鏈設計
7.3.1 故障分類
7.3.2 Level1:Profile輪換與指數退避策略
7.3.3 Level2:Thinking Budget降級
7.3.4 Level3:模型回退
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 六級優先級加載
