輕松掌控 OpenClaw : 使用,安全,原理與二次開發
張子軒 唐昊宇
- 出版商: 機械工業
- 出版日期: 2026-11-01
- 售價: $474
- 語言: 簡體中文
- ISBN: 7111822951
- ISBN-13: 9787111822950
-
相關分類:
Large language model、AI Coding、Chatbot
下單後立即進貨 (約4週~6週)
相關主題
商品描述
這是一本打通了“使用——原理—開發”的OpenClaw實踐指南。本書從安裝啟動與渠道接入講起,逐漸延伸到網關與協議棧、智能體運行時與件工程,不僅能讓你把智能體跑起來,更能讓你的企業能在真實環境中長期、穩定、地使用它。本書始於OpenClaw,卻不止於OpenClaw,它還能幫你從底層技術角度理解OpenClaw的底層邏輯,並掌握開發能幹活的智能體的方法。 本書在邏輯上分為五篇: 署與運維篇:主要介紹本地安裝與次啟動、渠道接入與遠程訪問、服務化運行與生產維護,不僅能讓系統“跑起來”,還能讓它“跑得穩”。 使用與實踐篇:覆蓋日常生活、個人效率與開發效率三類真實場景,從晨間推送到PR評審回傳、CI/CD故障速報,針對每個場景給出完整的配置與執行流程。 與治理篇:重點介紹信任邊界與核心風險、鑒權與訪問控制、四層權限治理、日誌取證與事件響應,幫你構建可執行、可審計的禦體系。 原理與架構篇:深度解讀網關與協議棧、Agent運行時與會話管理、多智能體路由與記憶系統,把“為什麼這樣設計”講清楚。 二次開發篇:從SKILL.md講到件工程,涵蓋開發、調試、測試、打與發布全流程,並以一個端到端實戰項目收口。
目錄大綱
前言
署與運維篇
第1章?本地安裝與次啟動2
1.1?安裝方式對比與選擇2
1.1.1?先判斷你該選哪條路徑2
1.1.2?路徑A:Installer Script(新手推薦)3
1.1.3?路徑B:npm / pnpm(已有Node環境)8
1.1.4?路徑C:From Source(開發與調試)9
1.1.5?路徑D:Docker(容器化署)10
1.2?openclaw onboard --install-daemon向導與個可用會話11
1.3?常見安裝故障排查指南12
1.4?使用Claude Code或Codex等其他智能體完成安裝14
第2章?渠道接入與遠程訪問15
2.1?典型渠道接入實戰:飛書/ WhatsApp / iMessage15
2.1.1?飛書接入:9步打通消息、審批與回覆鏈路16
2.1.2?WhatsApp接入:5步驗證消息閉環20
2.1.3?通過BlueBubbles接入iMessage23
可執行清單25
2.2?雙配對機制:DM Pairing與Node Pairing25
2.2.1?DM Pairing與Node Pairing分別控制什麼26
2.2.2?小權限落地與常見問題排查27
可執行清單28
2.3?遠程訪問方案:Tailscale與SSH隧道內網穿透28
2.3.1?為什麼不建議把Gateway直接暴露到公網28
2.3.2?Tailscale Serve與SSH隧道的兩種實現路徑29
2.3.3?遠程訪問的排查順序與驗收標準31
可執行清單31
第3章?運行與運維32
3.1?服務化運行:使用launchd / systemd實現進程常駐33
3.1.1?為什麼網關需要服務化托管33
3.1.2?安裝服務、檢查狀態與完成驗收34
3.1.3?生命周期命令、平臺差異與排查入口35
可執行清單36
3.2?監控與診斷閉環:openclaw doctor / status / logs實戰36
3.2.1?三層診斷:先看狀態,再做修覆,後追日誌37
3.2.2?標準故障排查SOP39
可執行清單39
3.3?生產環境維護:版本升級、數據遷移、備份與回滾策略39
3.3.1?升級路徑與標準升級流程40
3.3.2?換機遷移與恢覆要點41
3.3.3?備份、回滾與版本鎖定41
可執行清單43
3.4?多實例署:基於--profile的隔離與Rescue Bot配置43
3.4.1?何時需要多實例,以及如何規劃隔離邊界43
3.4.2?基於--profile的署、Rescue Bot兜底與常見沖突處理44
可執行清單47
使用與實踐篇
第4章?日常生活場景50
4.1?Skill:讓Agent具備可覆用的模塊化50
4.1.1?Skill解決的是什麼問題50
4.1.2?從SKILL.md到按需加載:OpenClaw如何識別
並激活Skill51
4.1.3?安裝、配置與管理53
4.1.4?使用社區Skill前的確認55
4.2?早晚生活助手:天氣、通勤、日程與待辦的飛書推送55
4.2.1?生活助手的組成,Cron與Heartbeat的分工56
4.2.2?上線前檢查與晨報創建57
4.2.3?晚間覆盤與日間巡檢59
4.2.4?驗收與排障60
可執行清單61
4.3?本地生活自動化:外賣類Skill案例解析61
4.3.1?外賣類Skill的值邊界與原則61
4.3.2?發現並學習Skill的設計62
4.4?米家智能家居聯動:以臺燈控制為例的場景化編排64
4.4.1?家居聯動分層64
4.4.2?以mijia為例跑通臺燈控制65
4.4.3?確認式執行與定時場景建議66
可執行清單67
4.5?家庭協同提醒:老人用藥、孩子作息與家庭事項廣播67
4.5.1?為什麼家庭提醒要先做分層67
4.5.2?老人用藥:定時、回執與升級68
4.5.3?孩子作息與家庭事項廣播70
可執行清單72
第5章?個人效率場景74
5.1?從“提醒我做事”到“替我推進交付”75
5.2?果叔案例:跑順AI日報和SEO日報主流水線75
5.2.1?果叔主控Skill的核心定位76
5.2.2?一個多Skill的流水線76
5.2.3?完整工作流:從Redol報告到草稿77
5.2.4?在OpenClaw中做一個可維護的工程系統78
可執行清單81
5.3?內容運營自動化:從日報到小紅書圖文卡片81
5.3.1?推薦架構:稿源覆用、卡片生成、瀏覽器發布、人工
審81
5.3.2?一個更適合長期運行的工作流83
5.3.3?調度邊界與模板沈澱84
可執行清單86
5.4?AI員工模式:用多Agent組織一個SEO捕魚網站團隊86
5.4.1?推薦拓撲:1個對人入口,7個崗位Agent86
5.4.2?多Agent構建實戰88
可執行清單97
5.5?讓系統真正可交付:目錄、節奏與回策略97
5.5.1?統一工件目錄與自動化節奏97
5.5.2?失敗與回策略須提前設計99
第6章?提效場景101
6.1?PR審閱與反饋回傳,GitHub飛書的代碼評審閉環102
6.1.1?基礎鏈路確認與Webhook接入點開啟103
6.1.2?推薦接入方式:利用GitHub Actions進行橋接104
6.1.3?進路由配置與結果回傳校準106
6.1.4?驗收、排障與高並發場景下的分流處理108
可執行清單109
6.2?CI/CD監控與故障速報:構建失敗自動讀日誌與診斷推送109
6.2.1?失敗觸發:通過CI調用Webhook接口109
6.2.2?結構化診斷與定時兜底機制111
6.2.3?涉及寫作須配置審批與允許列表112
6.2.4?擴展選項:面向Jenkins用戶的接入路徑113
可執行清單114
6.3?Issue分流與站會摘要:從消息到行動項的自動落地115
6.3.1?統一規範化輸出模板與分流技能115
6.3.2?自動創建工單(進配置)116
6.3.3?站會摘要定時化與多任務並行策略116
可執行清單118
6.4?手機遠程調度開發任務:通過飛書觸發編程Agent118
6.4.1?確認遠程執行環境基線119
6.4.2?署遠程編碼編排技能(以Claude Code為例)120
6.4.3?在開發機環境中啟動Node Host120
6.4.4?在網關側處理節點接入審批121
6.4.5?路由策略與命令邊界配置122
6.4.6?移動端調度實規範123
可執行清單124
6.5?定時巡檢與事件驅動:Cron與Webhook的自動化編排124
6.5.1?編排架構:事件快反結合定時兜底125
6.5.2?兩個核心接入端點與狀態管理125
6.5.3?確立sessionKey與job-id的命名規範及診斷方法126
6.5.4?定時任務署、審計與演練127
可執行清單129
與治理篇
第7章?系統與權限加固132
7.1?AI Agent工具為什麼面臨更大的挑戰132
7.2?始持系統版本更新134
可執行清單134
7.3?先明確暴露面,再盤點核心資產135
可執行清單138
7.4?核心威脅:提示詞註入、工具誤用與供應鏈風險138
可執行清單140
7.5?沙箱:在賦予的同時建立護欄140
可執行清單142
7.6?鑒權與訪問控制:把入口和執行分開處理143
可執行清單145
7.7?建立持續的檢查習慣146
可執行清單148
第8章?事件響應與維護149
8.1?入侵跡象識別與日誌提取149
可執行清單152
8.2?響應流程:隔離、憑證更換、檢查、覆盤152
8.2.1?通用的排查處理順序153
8.2.2?針對竊密型惡意代碼的項應對154
可執行清單155
8.3?個人多項目環境隔離156
可執行清單157
8.4?涉及第三方服務時的聯動響應158
可執行清單159
原理與架構篇
第9章?網關與協議棧162
9.1?網關架構全景162
9.2?網關生命周期管理163
可執行清單167
9.3?WebSocket協議詳解:握手、幀與方法調用167
9.3.1?握手與版本協商168
9.3.2?幀結構、角色權限與常用RPC方法171
9.3.3?主動事件、錯誤返回與HTTP入口173
可執行清單174
9.4?連接建立後的認證、配對與發現175
可執行清單177
9.5?Agent執行管道178
可執行清單180
9.6?定時任務與待交付恢覆180
可執行清單181
9.7?以飛書為例:消息全流程原理181
可執行清單186
第10章?Agent運行時187
10.1?核心數據流:從遠程過程調用到持久化187
10.2?智能體循環:事件驅動與並發模型189
可執行清單191
10.3?上下文構建:系統提示詞與引導文件註入191
可執行清單194
10.4?工具權限過濾與跨模型會話轉錄整理194
可執行清單195
10.5?會話寫鎖與截斷195
可執行清單196
10.6?壓縮、裁剪與上下文窗口護196
可執行清單197
10.7?exec工具與沙箱隔離197
可執行清單198
第11章?多Agent與記憶系統199
11.1?架構全景199
可執行清單200
11.2?多Agent路由與子Agent200
可執行清單206
11.3?記憶系統206
11.3.1?記憶後端、條目結構與混合檢索207
11.3.2?自動召回、自動捕獲與提示詞註入護208
可執行清單210
11.4?模型選擇策略與性權衡210
可執行清單210
11.5?定時調度:Cron系統211
可執行清單213
11.6?對外API集成213
可執行清單214
二次開發篇
第12章?Skill開發實戰216
12.1?Skill機制與SKILL.md佳實踐216
可執行清單220
12.2?實戰:開發自定義Skill220
可執行清單223
12.3?動態Skill:運行時刷新與調試技巧223
可執行清單225
12.4?設計模式:4種常見的Skill寫法225
可執行清單229
第13章?件開發工程230
13.1?件清單、發現順序與生命周期230
可執行清單233
13.2?件註冊API:從工具到服務233
可執行清單239
13.3?Channel件與Provider件240
可執行清單242
13.4?發布與安裝:從package.json到plugins doctor242
可執行清單244
13.5?供應鏈與權限控制244
可執行清單245
13.6?質量障:測試、灰度與回滾245
可執行清單248
13.7?完整參考實現:secureclaw的工程拆解248
可執行清單249
第14章?端到端實戰:A股交易全流程助手250
14.1?需求分析與場景拆解250
可執行清單252
14.2?架構設計:Skill、MCP與狀態流轉252
可執行清單255
14.3?項目骨架與運行時狀態255
可執行清單258
14.4?構建實時行情MCP:xuangubao-mcp258
14.4.1?工具範圍與項目初始化258
14.4.2?HTTP客戶端、工具註冊與聚合輸出259
14.4.3?雙模式啟動與容器化署262
可執行清單264
14.5?構建輿情分析MCP:bettafish-mcp264
14.5.1?檢索、情緒分析與多視角討論組件264
14.5.2?裝為MCP工具並完成容器化267
可執行清單268
14.6?署、註冊與連通性驗證269
14.6.1?自建服務署、第三方接入與mcporter註冊269
14.6.2?Skill加載與連通性驗證270
可執行清單271
14.7?編寫Skill:關註列表與盤前分析272
14.7.1?stock-watchlist:讓狀態管理標準化272
14.7.2?stock-premarket:把盤前準備流程固定下來274
14.7.3?盤前報告模板與競重點篩選275
可執行清單276
14.8?編寫Skill:競助手與盤中監控276
14.8.1?stock-auction:用15分鐘做交驗證276
14.8.2?stock-intraday與飛書通知:低噪聲監控的關鍵277
可執行清單279
14.9?編寫Skill:盤後覆盤279
可執行清單281
14.10?調度與自動化執行281
可執行清單283
14.11?端到端演練與問題排查283
可執行清單284
14.12?擴展方向284
