相關主題
商品描述
本書聚焦 GitHub 星標安裝破 30 萬的現象級開源 AI Agent 項目 OpenClaw，立足 AI Agent 時代浪潮，解析其從 Clawdbot 疊代而來的誕生背景與本地優先、隱私安全、輕量化可擴展的核心價值。全書按起源、部署、架構、貢獻、實戰、未來六大脈絡，拆解核心架構、網關中樞、沙盒安全等底層邏輯，提供全平臺安裝、模型對接、多通道接入與任務執行的實戰指導，詳解開源貢獻流程與企業/個人落地案例，兼具原理深度與實操性，既幫讀者快速掌握 OpenClaw 相關技能，也展望生態與多 Agent 協同未來，是 AI Agent開發者與開源愛好者的必備指南。
作者簡介
單致豪，現任騰訊開源聯盟主席，在雲原生、微服務、數據庫、操作系統、人工智能等領域的開源生態長期深耕。為騰訊建立健康的開源生態努力，致力於以開源方式加速技術和產品的創新。同時，曾擔任Linux基金會董事會成員、TARS基金會董事主席、FinOps基金會董事成員、NextArch基金會TOC、Akraino邊緣計算TSC、開放原子開源基金會TOC、木蘭開源社區TOC、中國雲原生產業聯盟技術專家，歷任OpenCloudOS社區秘書長、OpenTenBase社區秘書長。曾獲InfoQ十大開源傑出貢獻人物、中國信通院尖峰開源人物、COPU中國優秀開源人物、SegmentFault中國開源先鋒、GOPS微服務年度風雲人物、Go中國最具價值專家。
目錄大綱
第 1 篇
開源時代與 OpenClaw 起源
第 1 章 從聊天機器人到 AI Agent........... 3
1.1 聊天機器人的局限與進化 4
1.2 能做事的 AI Agent 核心特質 ........... 6
1.3 聊天機器人與 AI Agent 的核心區別 . 9
1.4 AI Agent 時代的技術支撐 .............. 12
1.5 從對話到執行的技術跨越 ............... 17
第 2 章 下一代智能的核心訴求 .............23
2.1 本地優先：擺脫對雲端依賴的優勢 . 24
2.2 隱私優先：AI 時代的安全底線 ...... 26
2.3 輕量化：適配多設備的核心需求 ..... 30
2.4 可擴展：滿足個性化場景適配需求 . 33
2.5 易用性：降低 AI 使用技術門檻 ...... 36
第 3 章 全球開源 AI 生態格局 .............. 41
3.1 開源 AI 的發展現狀與趨勢 ............. 41
3.2 OpenClaw 出現的歷史必然性 ....... 45
3.3 全球開源 AI 項目的核心分類 .......... 48
3.4 開源與閉源 AI 的優劣對比 ............. 53
3.5 開源社區對 AI 發展的推動作用 ...... 58
第4章 OpenClaw 項目簡介 ................ 62
4.1 項目定位 ..... 63
4.2 創始人與社區核心力量.. 66
4.3 項目核心價值與核心優勢 ............... 69
4.4 項目適配的核心用戶群體 ............... 73
4.5 與同類開源 AI 項目的差異 ............. 76
第5章 OpenClaw 項目發展歷程 ......... 80
5.1 疊代之路：Clawdbot → Moltbot → OpenClaw .............. 81
5.2 核心定位：個人 AI 助手與網關中樞 ................ 83
5.3 關鍵版本疊代與功能升級節點 ........ 86
5.4 項目成長中的核心裏程碑事件 ........ 88
5.5 社區成長與用戶規模發展歷程 ........ 90
第6章 OpenClaw 官方資源指南 ......... 94
6.1 GitHub 倉庫與文檔查閱 ................ 94
6.2 社區交流與 Discord 渠道 .............. 96
6.3 官方文檔的核心內容與查閱方法 ..... 98
6.4 問題反饋與需求提交渠道 ............. 100
6.5 官方更新與資訊獲取方式 ............. 102
第 2 篇 OpenClaw 快速上手與安裝部署
第7章 環境準備與支持平臺 ............. 109
7.1 適配平臺：macOS / Windows / Linux 詳解 ................ 109
7.2 核心依賴：Node.js、pnpm、Git 安裝 ......... 112
7.3 各平臺的環境配置差異 114
7.4 依賴版本兼容性說明 ... 118
7.5 環境配置常見問題排查 ................ 120
第8章 三種安裝方式實戰 124
8.1 源碼安裝：步驟與註意事項.......... 124
8.2 包管理器與 Docker 安裝捷徑 ...... 128
8.3 三種安裝方式的優劣對比 ............. 131
8.4 安裝過程中的常見報錯解決 ......... 135
8.5 安裝完成後的驗證方法 ................ 140
第9章 首次啟動與初始化 145
9.1 onboard 流程引導與配置 ............ 145
9.2 後臺守護進程與自啟動設置 .......... 146
9.3 首次啟動的核心配置項說明 .......... 148
9.4 初始化失敗的排查與解決 ............. 149
9.5 啟動狀態的查看與管理方法 .......... 151
第 10 章 配置文件與模型對接 ........... 154
10.1 配置文件結構與格式解析 ........... 154
10.2 主流 LLM 對接：GPT / Claude / 本地模型 ................ 155
10.3 配置文件的修改與保存方法 ....... 156
10.4 模型對接的權限配置 . 158
10.5 模型切換與參數調整技巧 ........... 159
第 11 章 通道接入與第一個任務 ........ 161
11.1 多通道接入：Telegram / Discord 等配置 .. 161
11.2 實戰：讓 OpenClaw 幫你操作電腦 ............ 163
11.3 通道接入的權限設置與驗證 ....... 165
11.4 第一個任務的執行步驟與調試 .... 165
11.5 任務執行結果的查看與反饋 ....... 167
第 3 篇 OpenClaw 核心架構與代碼剖析
第 12 章 整體架構設計 ..... 173
12.1 Hub-and-Spoke 中心輻射架構原理 ......... 173
12.2 核心四層：Channel → Gateway → Agent → Skills ... 175
12.3 整體架構的核心設計理念 ........... 178
12.4 架構的可擴展性設計思路 ........... 180
12.5 架構與同類項目的差異點 ........... 182
第 13 章 網關與數據流解析 ............... 185
13.1 Gateway 模塊：系統中樞（18789 端口） . 185
13.2 全流程數據流拆解與分析 ........... 187
13.3 Gateway 模塊的核心功能 ......... 189
13.4 數據流異常的排查方法 .............. 191 目錄
·XXIII第 14 章 核心模塊源碼解析 ............... 194
14.1 Gateway 路由、會話與調度機制................ 194
14.2 Channel 適配器：多平臺統一接入實現 ..... 199
14.3 源碼的目錄結構與核心文件 ....... 201
14.4 核心代碼的關鍵邏輯解析 ........... 203
14.5 源碼閱讀的技巧與重點 .............. 204
第 15 章 Agent 與 Skills 系統 ............. 207
15.1 核心架構與運行時 .... 207
15.2 工作空間與執行循環 . 211
15.3 多 Agent、記憶與系統提示詞 .... 215
15.4 Skills 體系、沙盒安全與最佳實踐 ............... 220
15.5 Skills 配置參考與開發最佳實踐 .. 226
第 16 章 關鍵技術與安全機制 ........... 231
16.1 Gateway—整個系統的神經中樞 ............. 231
16.2 認證體系—讓憑據用對地方 .... 234
16.3 Secrets Management—讓憑據永遠不出現在配置文件裏 ........ 237
16.4 沙盒安全機制—給 Agent 劃定行動邊界 .. 242
16.5 Cron 任務調度—讓 Agent 主動做事 ....... 245
16.6 Session 會話機制—對話歷史的持久化單元 ............. 248
16.7 消息渠道—OpenClaw 連接世界的接口 .. 249
16.8 心跳機制—讓 Agent 保持主動 ................ 251
16.9 Canvas 與節點系統—Agent 的“眼睛”和“屏幕” ................ 253
16.10 工具策略與 Exec 安全 ............ 254
16.11 配置管理與熱重載 .. 255
16.12 安全體系：縱深防禦與最佳實踐 ............... 256
第 4 篇 參與開源：貢獻 OpenClaw
第 17 章 開源貢獻基礎 ..... 263
17.1 開源協作文化與核心規則 ........... 263
17.2 Git 與 GitHub 必備工作流 ......... 265
17.3 開源貢獻的核心類型與要求 ....... 267
17.4 GitHub 基礎操作規範 ................ 270
17.5 開源社區的溝通禮儀 . 272
第 18 章 貢獻流程與規範 . 275
18.1 Fork → 開發 → 提交 PR 全流程 ............. 275
18.2 Code Review 規範與通過技巧 . 278
18.3 PR 提交的核心規範與註意事項 280
18.4 代碼貢獻的格式與質量要求 ....... 282
18.5 非代碼貢獻的流程與規範 ........... 285
第 5 篇 OpenClaw 應用場景與實戰案例
第 19 章 多場景應用實戰 . 293
19.1 個人生產力與開發者場景落地 .... 293
19.2 企業與團隊私有化部署實踐 ....... 295
19.3 個人場景的核心應用技巧 ........... 297
19.4 企業部署的核心配置與優化 ....... 299
19.5 典型實戰案例的步驟拆解 ........... 301
第 6 篇 OpenClaw 開源生態的未來
第 20 章 OpenClaw 未來與生態拓展 . 309
20.1 Roadmap 與長期發展方向........ 310
20.2 技能市場與多 Agent 協同展望 ... 311
20.3 生態拓展的核心規劃 . 313
20.4 開發者生態的建設方向 .............. 315
20.5 未來版本的核心功能預判 ........... 317
附錄 320
