《OpenClaw橙皮書：從入門到精通》是一份關(guān)于開源AI Agent平臺(tái)OpenClaw的一站式綜合參考手冊(cè)，版本為v1.0，適用于v2026.3.7版本。文檔旨在多面介紹OpenClaw，幫助用戶從零開始掌握其使用。內(nèi)容涵蓋了對(duì)OpenClaw的基本認(rèn)識(shí)、技術(shù)架構(gòu)原理、多種部署方案、國(guó)內(nèi)外主流消息渠道的接入方法、Skills（技能）系統(tǒng)的工作機(jī)制與市場(chǎng)、豐富的模型配置方案、至關(guān)重要的安全與成本控制，以及其d特的社區(qū)生態(tài)。文檔強(qiáng)調(diào)OpenClaw的核心定位是將AI從被動(dòng)的“聊天工具”轉(zhuǎn)變?yōu)槟苤鲃?dòng)連接各類平臺(tái)并執(zhí)行任務(wù)的“數(shù)字員工”，其采用自托管方式，保障用戶數(shù)據(jù)完全本地化，并通過開源社區(qū)和ClawHub技能市場(chǎng)實(shí)現(xiàn)了高度的可擴(kuò)展性。截至2026年3月，OpenClaw已成為GitHub上星標(biāo)數(shù)D一的軟件項(xiàng)目，擁有超過27.8萬(wàn)星標(biāo)和1.3萬(wàn)多個(gè)社區(qū)技能，形成了d特的“養(yǎng)蝦”文化

部署方案

OpenClaw支持從本地到云端的多種部署方式，用戶可根據(jù)自身技術(shù)水平和預(yù)算選擇。本地安裝主要通過npm全局安裝或使用一鍵腳本，需要Node.js 22+環(huán)境，并可安裝守護(hù)進(jìn)程實(shí)現(xiàn)后臺(tái)持續(xù)運(yùn)行。Docker部署則提供了標(biāo)準(zhǔn)、slim、沙箱等多種鏡像變體，適合需要環(huán)境隔離和方便遷移的場(chǎng)景，部署時(shí)需注意掛載配置和工作空間目錄以實(shí)現(xiàn)數(shù)據(jù)持久化。對(duì)于國(guó)內(nèi)用戶，主流云廠商均提供了一鍵部署方案：阿里云方案（約9.9元/月起，預(yù)裝鏡像，內(nèi)置通義千問模型）資源Z豐富；騰訊云方案（約17元/月起）對(duì)企微/QQ生態(tài)支持Z佳；百度云方案（月0.01元體驗(yàn)）試錯(cuò)成本Z低；火山引擎方案（組合套餐19.8元/月，含服務(wù)器和模型）綜合性價(jià)比高，且與飛書深度集成；華為云方案則主打企業(yè)J安全與合規(guī)。此外，扣子編程提供了無(wú)需服務(wù)器的零門檻方案，完全在平臺(tái)內(nèi)運(yùn)行；而Railway、Zeabur等海外平臺(tái)則適合海外開發(fā)者。文檔強(qiáng)調(diào)，服務(wù)器成本已很低，真正的持續(xù)成本在于模型API調(diào)用，因此選擇平臺(tái)時(shí)應(yīng)重點(diǎn)考慮模型套餐的價(jià)格和靈活性。次配置需要設(shè)置Gateway認(rèn)證模式（token或password），并至少配置一個(gè)模型的API Key，安裝后可通過openclaw doctor命令進(jìn)行環(huán)境診斷。

Skills系統(tǒng)

Skills是OpenClaw的能力擴(kuò)展單元，通過純文本的SKILL.md文件定義。Skill的加載遵循三層優(yōu)先J：Z高是項(xiàng)目工作區(qū)內(nèi)的Skills，其次是用戶全局目錄下的Skills，Z后是OpenClaw內(nèi)置的55個(gè)Skills，高優(yōu)先J會(huì)覆蓋低優(yōu)先J。ClawHub是官方的Skill注冊(cè)表，截至2026年3月已收錄超過13,729個(gè)技能，但文檔警告其中存在大量垃圾、重復(fù)甚至惡意技能，社區(qū)精選列表（awesome-openclaw-skills）從中篩選出約5,494個(gè)相對(duì)可靠的技能。技能市場(chǎng)涵蓋編碼Agent、Web開發(fā)、DevOps、搜索研究、瀏覽器自動(dòng)化、生產(chǎn)力、AI與LLM、CLI工具、Git、圖片視頻生成等十大分類。文檔推薦了十個(gè)必裝技能，包括Gmail/Google集成、瀏覽器自動(dòng)化、內(nèi)容摘要、GitHub管理、Claude Code橋接、聯(lián)網(wǎng)搜索、文件管理、日歷、翻譯和圖片生成。用戶可以創(chuàng)建自定義Skill，只需一個(gè)包含SKILL.md的目錄即可，并可通過ClawHub發(fā)布分享。然而，Skills安全是重大風(fēng)險(xiǎn)點(diǎn)，2026年初爆發(fā)的“ClawHavoc”供應(yīng)鏈攻擊事件導(dǎo)致ClawHub上約20%的技能被確認(rèn)為惡意，攻擊者通過篡改SOUL.md和MEMORY.md文件來“洗腦”Agent。因此，文檔強(qiáng)烈建議用戶在安裝任何第三方Skill前審查源碼，并可使用SecureClaw等工具進(jìn)行安全掃描。

模型配置

OpenClaw支持十余家模型提供商，包括國(guó)際廠商（Anthropic Claude、OpenAI GPT、Google Gemini）和國(guó)內(nèi)廠商（DeepSeek、智譜GLM、通義千問、豆包、Kimi、百度文心、MiniMax等），并支持通過Ollama或LM Studio運(yùn)行本地模型，實(shí)現(xiàn)了高度的模型自由。配置的核心是通過openclaw.json文件設(shè)置主力模型和Fallback備選鏈，這是控制成本的關(guān)鍵策略。文檔提供了截至2026年3月的詳細(xì)模型價(jià)格對(duì)比，例如DeepSeek-V3.2.2輸入價(jià)格低至$0.14/百萬(wàn)tokens，極具性價(jià)比；GLM-5（$0.80/百萬(wàn)tokens）在代碼能力上表現(xiàn)出色；而Claude Sonnet 4.6（$3.00/百萬(wàn)tokens）則在Agent任務(wù)效果上公認(rèn)Z佳。對(duì)于國(guó)內(nèi)用戶，各大廠商和云平臺(tái)推出了面向AI編程的Coding Plan包月套餐，如阿里云百煉、騰訊云、火山引擎等提供的聚合套餐，月價(jià)格可低至7.9元，包含多家模型自由切換，是低成本入門的好選擇。本地模型方案（如Ollama運(yùn)行Qwen3.5-Coder:32B）則能實(shí)現(xiàn)零API成本，但需要較強(qiáng)的本地硬件（推薦32GB RAM）。文檔給出了五套推薦配置方案，從“極致省錢”（月均<$5，以DeepSeek為主力）到“國(guó)際平衡”（月均$10-30，以Claude為主力），并強(qiáng)烈推薦“混合Z優(yōu)”方案（月均$5-20），即復(fù)雜任務(wù)用Claude Sonnet，日常對(duì)話用DeepSeek，心跳任務(wù)用免費(fèi)模型，通過Fallback鏈自動(dòng)調(diào)度以兼顧效果與成本。

生態(tài)與社區(qū)及附錄

OpenClaw已形成d特的“養(yǎng)蝦”文化生態(tài)。其吉祥物龍蝦衍生了“養(yǎng)蝦人”社區(qū)文化，并催生了Moltbook這一專供AI Agent互動(dòng)的社交網(wǎng)絡(luò)，截至2026年2月底已有超過3.2萬(wàn)個(gè)AI Agent注冊(cè)。在國(guó)內(nèi)，“云養(yǎng)蝦”社區(qū)用戶超10萬(wàn)，深圳地方政府甚至出臺(tái)了相關(guān)的支持政策征求意見稿。社區(qū)也涌現(xiàn)出一些輕量J替代項(xiàng)目，如zeroclaw（Rust編寫）、nanoclaw（僅4000行代碼）等。與專注編程的Claude Code相比，OpenClaw定位為通用的“生活助手”和“個(gè)人AI操作系統(tǒng)”，兩者可通過社區(qū)Skill橋接，形成互補(bǔ)的工作流。文檔附錄提供了豐富的實(shí)用信息：常見問題解答（FAQ）澄清了開源免費(fèi)但需支付API費(fèi)用、所需技術(shù)水平、與ChatGPT的區(qū)別、安全性、成本范圍、國(guó)產(chǎn)模型效果等關(guān)鍵問題；命令速查表（Command Cheat Sheet）匯總了安裝更新、日常使用、插件管理、模型認(rèn)證、Docker操作等常用命令；資源鏈接部分則列出了官方文檔、GitHub倉(cāng)庫(kù)、ClawHub市場(chǎng)、社區(qū)精選列表、國(guó)內(nèi)插件（openclaw-china）、各模型提供商控制臺(tái)等重要網(wǎng)址，為用戶進(jìn)一步探索提供了完整的入口。

附件：OpenClaw橙皮書：從入門到精通:支持從本地到云端的多種部署,Skills系統(tǒng),支持十余家模型提供商