OpenClaw 橙皮书总结
Part 1: 认识 OpenClaw
OpenClaw 是什么
OpenClaw 是一个开源、自托管的 AI Agent 系统，旨在将 AI 从「聊天工具」转变为「能自主执行任务的数字员工」。它能够连接 20+ 消息渠道（如 WhatsApp、Telegram、飞书、钉钉等），主动执行任务、管理日程、处理邮件、操作浏览器、调用各种工具。与 ChatGPT 等问答系统不同，OpenClaw 更像是「员工」，能够自主完成任务。
发展简史
OpenClaw 的发展历程充满戏剧性。从 2025 年 11 月由奥地利开发者 Peter Steinberger 作为周末项目发布，到 2026 年 3 月成为 GitHub 全球第一软件项目，OpenClaw 仅用不到 4 个月就实现了爆发式增长。期间经历了 Anthropic 商标警告、安全危机、谷歌封号风波等重大事件，但最终项目成功移交给开源基金会运营，并由 OpenAI 赞助。
创始人故事
Peter Steinberger 是 OpenClaw 的核心开发者，从个人项目到全球顶级开源项目，再到加入 OpenAI，他的经历展现了 OpenClaw 的快速发展和社区支持的重要性。他强调自己是个「建造者」，希望改变世界而非建立大公司。
为什么这么火
OpenClaw 的爆火得益于其独特的技术优势、快速增长的用户社区以及有趣的文化现象。其「养虾」文化降低了使用门槛，使其成为 AI 圈的社交货币。Moltbook 作为 AI Agent 的社交网络，进一步推动了 OpenClaw 的发展。
Part 2: 技术架构
整体架构
OpenClaw 采用 Gateway-Node-Channel 三层架构，以 WebSocket 为通信总线，将控制平面、设备执行与消息渠道解耦。这种架构实现了安全性、可扩展性和灵活性。
记忆系统
OpenClaw 的记忆系统是其核心能力之一，包含 SOUL、TOOLS、USER 和 Session 四层记忆，构建了完整的上下文连续性。记忆系统通过文件系统实现持久化存储，保证了对话的连续性和长期记忆。
Agent 工作区
每个 Agent 在文件系统中拥有独立的工作区目录，所有配置、记忆、技能都以纯文本文件的形式存在。这种设计体现了 OpenClaw 的 Unix 哲学，即小工具、可组合、文本流。
Session 与用户识别
OpenClaw 通过 DM 配对、白名单和群组规则三层机制识别用户身份，并在 Session 层面隔离不同来源的上下文，保证了用户隐私和安全。
设计哲学
OpenClaw 的技术选择背后有一套清晰的设计哲学，包括 Unix 哲学、极简设计、自我扩展能力和 Session 树形结构等。这些理念体现了 OpenClaw 的简洁、灵活和可扩展性。
Part 3: 部署方案
部署方式总览
OpenClaw 支持从本地到云端的多种部署方式，包括本地安装、Docker 部署和国内云厂商一键部署等。选择哪种方式取决于用户的技术水平、预算和使用场景。
本地安装
本地安装适合开发者和想完全掌控数据的用户。OpenClaw 是 TypeScript 项目，运行在 Node.js 上，支持 npm 全局安装和一键脚本安装。
Docker 部署
Docker 部署适合需要环境隔离、方便迁移、或在服务器上长期运行的场景。OpenClaw 仓库内置了 docker-compose.yml，一条命令即可启动。
国内云厂商一键部署
国内云厂商一键部署是大多数国内用户的首选方案。所有主流云厂商都已支持 OpenClaw 一键部署，差异主要在价格策略和 IM 生态集成上。
首次配置
无论哪种部署方式，安装完成后都需要进行首次配置，包括 Gateway 认证设置、模型选择与 API Key 配置、版本更新和诊断检查等。
Part 4: 渠道接入
渠道概览
OpenClaw 通过 Gateway 架构统一连接 20+ 聊天平台，所有渠道共享同一套三步接入模式：创建凭证→ 写入配置 → 启动 Gateway。
国际平台接入
OpenClaw 支持 Telegram、Discord、WhatsApp、Slack、Signal、iMessage 等国际平台的接入，每个平台从创建凭证到完成对话的全流程都有详细说明。
国内平台接入
国内 IM 生态的 OpenClaw 支持正在快速发展。QQ 和飞书已有官方级支持，钉钉和企业微信社区插件成熟，微信个人号仍是技术挑战。
远程访问
OpenClaw Gateway 默认监听本地 ws://127.0.0.1:18789。当你需要从外部网络访问时，可以通过 Tailscale Serve/Funnel、SSH 端口转发或 Dashboard Web UI 等方式进行远程访问。
Part 5: Skills 系统
Skills 工作原理
Skills 是 OpenClaw 的能力扩展单元，通过 SKILL.md 文件定义。OpenClaw 的 Skill 有三个来源，按优先级从高到低排列：项目级 Skills、用户级 Skills 和内置 Skills。
ClawHub 技能市场
ClawHub 是 OpenClaw 的官方 Skill 注册表，提供公共 Skills 的发布和版本管理、基于向量搜索的 Skill 发现、下载量统计和社区评分等功能。
热门 Skills 推荐
OpenClaw 提供 55 个内置 Skills，加上社区精选的 Top 10 必装 Skills，涵盖了通讯与社交、笔记与知识管理、开发工具、媒体处理、AI 与模型、搜索与浏览、系统工具和生态工具等分类。
自建 Skill 指南
OpenClaw 允许用户自建 Skill，只需创建一个目录和一个 SKILL.md 文件。社区还提供了 ClawHub 发布指南，方便用户分享自己的 Skill。
Skills 安全
ClawHub 的质量问题非常严重，社区推出了开源安全工具 SecureClaw，可以扫描已安装的 Skills 检查恶意内容。用户需要安装前审查源码，并优先使用精选列表。
Part 6: 模型配置
模型提供商总览
OpenClaw 支持十余家模型提供商，从国际顶尖到国产平价再到完全免费的本地模型，覆盖所有预算和场景。用户可以通过 ~/.openclaw/openclaw.json 配置文件，灵活切换主力模型、设置 Fallback 备选链、甚至让不同任务走不同模型。
国际模型配置
OpenClaw 支持 Anthropic Claude、OpenAI GPT、Google Gemini 等国际模型的配置，每个模型都有详细的配置指南和成本分析。
国产模型配置
国产模型是 OpenClaw 用户省钱的核心武器。DeepSeek-V3.2 和 GLM-5 是最受国内用户欢迎的选择。OpenClaw 还支持通过插件接入通义千问、豆包、Kimi 等国产模型。
本地模型与推荐方案
OpenClaw 支持通过 Ollama 或 LM Studio 运行本地模型，实现零 API 成本。推荐本地模型方案包括 Ollama、LM Studio 等，适合隐私敏感场景和实验用途。
Part 7: 安全与成本
安全模型
OpenClaw 的安全模型建立在「默认不信任」的基础上，但创始人自己坦言：「prompt injection 没解决，有绝对风险。」OpenClaw 提供了 DM 配对保护、群组沙箱模式、工具访问控制等安全机制，但用户需要自行维护安全。
已知安全事件
在不到 4 个月的历史中，OpenClaw 已经经历了至少 5 起重大安全事件，包括 CVE-2026-25253 远程代码执行漏洞、ClawHavoc 供应链攻击、Anthropic 封杀 OAuth、谷歌封号事件和 30,000+ 台未认证暴露实例等。
成本控制
API 费用是 OpenClaw 运营的最大成本。OpenClaw 的 Token 消耗远超普通聊天场景，用户需要采取 Fallback 链、预算限制等策略控制成本。推荐混合模型策略，兼顾效果和成本。
Part 8: 生态与社区
养虾文化
OpenClaw 催生了 2026 年 AI 圈最独特的亚文化：「养虾」。数万个 AI Agent 在社交网络上发帖、赌博、赚钱。Moltbook 作为 AI Agent 的社交网络，进一步推动了 OpenClaw 的发展。
平替产品
OpenClaw 的火爆催生了大量轻量替代品，如 zeroclaw、nanoclaw、EasyClaw 等。这些替代品更轻量，适合学习 Agent 系统的架构原理。
vs Claude Code
OpenClaw 和 Claude Code 是互补关系，不是替代关系。OpenClaw 负责消息平台接入和生活自动化，Claude Code 负责编程任务。两者组合是 2026 年最完整的 AI 工作流。
国内生态
「云养虾」社区规模庞大，政府出台支持政策，OpenClaw 在中国的落地速度超出所有人预期。国内用户最推荐的方案是阿里云一键部署 + openclaw-china 插件接入钉钉/QQ + DeepSeek 或 GLM-5 作为主力模型。
附录
常见问题 FAQ
本部分列出了 OpenClaw 的常见问题，包括软件是否免费、技术水平要求、与 ChatGPT 的区别、安全性、成本、国产模型、Anthropic 封杀 OAuth、项目未来、ClawHub 安全、微信接入、与 Claude Code 的组合、本地模型效果等。
命令速查表
本部分提供了 OpenClaw 的常用命令速查表，包括安装与更新命令、日常使用命令、插件管理命令、模型认证命令、聊天命令和 Docker 部署命令等。
资源链接
本部分列出了 OpenClaw 的官方资源、社区资源和国内资源，方便用户获取更多信息。
