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

部署方案

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

Skills系統

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

模型配置

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

生態與社區及附錄

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

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