《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是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)、各模型提供商控制台等重要网址,为用户进一步探索提供了完整的入口。

![]() |
| 机器人底盘 Disinfection Robot 消毒机器人 讲解机器人 迎宾机器人 移动机器人底盘 商用机器人 智能垃圾站 智能服务机器人 大屏机器人 雾化消毒机器人 展厅机器人 服务机器人底盘 具身智能教育机器人 智能配送机器人 导览机器人 |