輕松掌控 OpenClaw : 使用,安全,原理與二次開發

張子軒 唐昊宇

相關主題

商品描述

這是一本打通了“使用——原理—開發”的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