OpenClaw 核心原理與工程實踐

王硯舒

清華大學計算機系工學博士，北京大學講師，主要研究方向包括AI Agent設計、大語言模型推理優化、分布式機器學習系統與網絡系統。長期從事智能體系統、模型優化與高性能計算相關研究，在AI Agent工作流設計、自動化數據采集與分析、垂直領域智能系統構建等方面積累了豐富經驗。圍繞OpenClaw框架，開展了新手教程、架構分析及中文技術資料整理工作，並參與國際學術會議論文發表和審稿工作。

劉睿

清華大學軟件學院工學碩士，雲研發工程師。長期從事雲產品管控系統和內核系統開發，在存儲系統、分布式系統及相關工程領域具有豐富經驗，對Apache Kafka、Apache RocketMQ等消息隊列和分布式技術有深入研究。作為Apache RocketMQ Committer、Apache IoTDB PMC成員，參與多個國際知名開源項目。目前負責團隊AI Agent基礎設施建設及下一代AI流計算引擎系統研發，在覆雜系統運行、擴展機制和工程化實踐方面具有紮實積累。

第1章 OpenClaw的問題邊界與系統定位
1.1 OpenClaw的問題邊界
1.1.1 從聊天助手到可執行Agent
1.1.2 OpenClaw的切入點
1.1.3 OpenClaw與單點AI工具的區別
1.1.4 Agent框架的市場格局
1.2 OpenClaw的系統定位
1.2.1 本地優先的個人Agent框架
1.2.2 多渠道而非單入口
1.2.3 面向擴展的框架而非固定產品
1.2.4 OpenClaw與其他主流Agent框架的定位對比
1.3 OpenClaw值得寫成一本技術書的原因
1.3.1 足夠完整的系統要素
1.3.2 對通用架構問題的代表性
1.3.3 中文技術書的空白與機會
第2章 OpenClaw的整體架構與運行機制
2.1 系統總覽
2.1.1 五個核心構成
2.1.2 核心結構圖
2.1.3 消息與任務的區分
2.2 網關的中心架構
2.3 技術棧概覽
2.4 OpenClaw的分層思路
2.4.1 傳輸層
2.4.2 路由與控制層
2.4.3 智能與執行層
2.5 OpenClaw的關鍵數據流
2.5.1 入站數據流
2.5.2 決策數據流
2.5.3 出站數據流
2.6 設計原則與工程取向
2.6.1 插件優先
2.6.2 本地優先
2.6.3 工程上優先穩定邊界
2.6.4 可觀測性
第3章 網關、協議與控制平面
3.1 網關是OpenClaw的中心
3.1.1 網關不是簡單的轉發器
3.1.2 控制平面與執行平面的區分
3.1.3 中心化並非落後設計
3.2 協議層的作用
3.2.1 請求、響應與事件
3.2.2 驗證機制的重要性
3.2.3 協議對象本質上是在定義系統邊界
3.2.4 協議穩定性直接影響客戶端演進
3.3 網關內部的核心職責
3.4 RPC分發方法為何是網關的骨架
3.4.1 網關方法按領域聚合，而不是按文件堆疊
3.4.2 處理器分組意味著問題域分組
3.4.3 聚合器讓入口保持穩定而內部繼續演化
3.5 從請求到處理結果的路徑
3.6 網關與會話、渠道、Agent之間的關系
3.7 角色、作用域與寫入預算
3.7.1 角色模型說明誰有資格進入哪一層
3.7.2 作用域進一步限制同一角色的可見面
3.7.3 寫入預算體現了控制平面的防濫用意識
3.8 本章與後續章節的關系
3.9 網關設計對後續章節內容的影響
第4章 Agent運行時與上下文組織
4.1 Agent不是一次性調用，而是運行時對象
4.1.1 必須從運行時視角理解Agent的原因
4.1.2 運行時對象的三個維度
4.1.3 工作區是運行時的邊界容器
4.2 工作區、身份文件與Agent個性
4.2.1 身份文件不是裝飾層
4.2.2 SOUL.md、IDENTITY.md與USER.md的分工
4.2.3 身份信息對執行過程的影響
4.2.4 工作區身份文件是一種工程化人格機制
4.2.5 身份文件與配置文件的邊界必須區分
4.2.6 核心身份文件各自對應不同語義層
4.2.7 工作區還容納了多Agents與工具邊界信息
4.3 輸入並非上下文的全部
4.3.1 一次推理實際依賴的內容
4.3.2 上下文組織是Agent能力的核心
4.3.3 輸入來源具有明顯層次
4.3.4 上下文構造不是簡單拼接
4.3.5 不同信息來源具有不同穩定性
4.3.6 上下文構造決定Agent是否是一個穩定系統
4.3.7 運行時與提示詞的本質區別
4.4 會話是運行時的連續性來源
4.4.1 沒有會話，就沒有連續任務
4.4.2 會話不僅用於回憶，也用於定位
4.4.3 會話狀態與任務執行互相影響
4.4.4 會話結構決定多輪任務是否可解釋
4.4.5 會話也是記憶系統的上遊
4.4.6 會話結構還決定了壓縮與檢索能否成立
4.5 Agent的執行循環
4.5.1 Agent執行循環的流程
4.5.2 執行循環的關鍵在於可中斷與可恢覆
4.5.3 推理循環並不等於無限自治
4.5.4 模型提供商切換也屬於運行時能力的一部分
4.5.5 工具快照讓Agent看到的是當前能力，而非全部能力
4.6 Heartbeat與Cron：Agent的主動執行能力
4.6.1 Heartbeat：周期性上下文感知檢查
4.6.2 Cron：在精確時間點觸發的獨立任務
4.7 工作區是理解運行時的關鍵入口
4.8 本章在全書中的支點作用
4.9 Agent運行時的邊界意識
第5章 工具系統與Skill機制
5.1 Agent必須擁有工具系統的原因
5.1.1 僅有語言能力無法構成完整的Agent
5.1.2 工具系統解決的是能力外接問題
5.1.3 技能化是能力的組織方式，而非功能堆疊
5.2 工具抽象：從能力描述到受控執行
5.2.1 工具首先是一種運行時協議
5.2.2 描述層與執行層必須分離
5.2.3 統一抽象才能支撐多來源能力
5.3 OpenClaw中的工具類型
5.3.1 Agent工具：承擔主要執行職責
5.3.2 渠道工具：服務於消息環境
5.3.3 系統工具：具有連接宿主能力
5.4 從模型意圖到執行工具
5.4.1 構建工具可見性
5.4.2 工具選擇
5.4.3 參數構造與執行
5.5 技能系統的結構意義
5.5.1 技能是能力包而不是單一函數
5.5.2 技能的最小結構體現了模塊邊界