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

部署方案

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

Skills系統(tǒng)

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

模型配置

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

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

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

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