先关注后阅读，娇姐怕失去上进的你

你有没有过这种经历——

朋友圈有人转了个 GitHub 项目，说"这个太牛了"。你点进去一看，满屏英文、一堆文件夹、README 长得能绕地球一圈。

然后你默默关掉了页面。

我之前也是这样。直到我遇到了 OpenClaw。

这个项目到底有多火？

321,000 个 Star。

什么概念？React 是 237K，Vue 是 210K。OpenClaw 比它们都多。

20,167 次 Commit，53 万行 TypeScript 代码，75 个扩展插件，53 个 AI 技能模块。

但我敢打赌，收藏它的人里，90% 没搞懂它到底是干嘛的。

所以它到底是什么？

一句话：一个跑在你自己服务器上的私人 AI 助手。

和 ChatGPT 的区别？ChatGPT 是你去它家聊天。OpenClaw 是你把 AI 请到你家，让它住下来，24 小时待命。

具体能干嘛：

• 在 WhatsApp / Telegram / Slack / 飞书里直接和 AI 对话
  ——不用开浏览器，不用切 APP
• AI 帮你操作电脑
  ——执行命令、控制浏览器、管理文件、发邮件
• 定时自动化
  ——每天早上让 AI 给你发天气、监控 GitHub Issue、自动回复消息
• 长期记忆
  ——上周聊的事它还记得，不是只记最近几条
• 想用哪个 AI 就用哪个
  ——GPT-4o、Claude、Gemini、甚至本地跑的 Ollama，一行配置切换

而且——数据完全在你自己手上。没有任何第三方存你的聊天记录。

53 万行代码，我怎么拆的？

说实话，刚打开源码的时候我也懵了。

src/├── gateway/     ← 294 个文件，9万行├── agents/      ← 916 个文件，19万行├── cli/         ← 341 个文件，5万行├── config/      ← 252 个文件，4.6万行├── plugins/     ← 196 个文件，4.2万行├── browser/     ← 183 个文件，2.6万行├── channels/    ← 173 个文件，2.5万行├── memory/      ← 92 个文件，2.1万行├── security/    ← 33 个文件，1.4万行└── ...还有更多

2860 个 TypeScript 文件。我不可能一个个看。

所以我换了个思路：不看代码，看架构。

一条消息的旅程

当你在 WhatsApp 上发一句"明天北京天气怎么样"，OpenClaw 内部会发生什么？

1. 渠道接收 — WhatsApp 扩展收到消息，转成统一格式

↓

2. 安全检查 — 验证身份，加注入防护标记

↓

3. 会话路由 — 用唯一键找到你的专属会话

↓

4. 记忆检索 — 语义搜索长期记忆

↓

5. AI 推理 — 把上下文丢给 GPT-4o 生成回复

↓

6. 工具调用 — 调用 web-search 查天气

↓

7. 回复投递 — 按字符限制分块发回

↓

8. 持久化 — 存入 Session，关键信息写入长期记忆

8 个步骤，跨越 6 个核心模块。整个过程通常在几秒内完成。

为什么我要把它做成网页？

因为上面这些文字你看完大概记住了 30%。

但如果你能自己点开一个交互式页面，滑动看架构动画，点击模块看每个文件的功能，在搜索框里输入关键词过滤代码——你会记住 80%。

所以我做了这个：

提示：下方截图仅为静态展示，点击文末「链接」可进入完整交互版。

一个单页面交互式网站，包含：

• 6 个可交互图表
  ：雷达图、树状图、旭日图、条形图……鼠标悬停看详情
• 滚动触发动画
  ：不是一次性加载，是你滑到哪里、哪里才"登场"
• 文件级代码浏览器
  ：2860 个文件，每个都有行数和中文功能说明，支持搜索
• 亮色/暗色切换
  ：看不清就切亮色模式
• 移动端适配
  ：手机上也能看

几个有意思的发现

做这个网页的过程中，我发现了一些值得分享的东西：

1. 它支持 35 个 AI 提供商

不只是 OpenAI 和 Anthropic。百度千帆、火山引擎、通义千问、小米、智谱、Kimi、Moonshot……国内的大模型几乎全覆盖了。还有 Ollama 可以跑本地开源模型，完全免费。

2. 安全设计是认真的

时序安全的密钥比较（防时序攻击）、外部内容注入防护（防 prompt injection）、指数退避的暴力破解防护、代码安全扫描器……不是玩具项目的安全级别。

3. 技能不是代码，是文档

53 个 Skill 全是 Markdown 文件，不是可执行代码。它们教 AI"什么时候该用什么工具"。就像给新员工写操作手册，而不是替他写死每一步。这个设计哲学很妙。

4. 插件系统设计得像 USB

每个渠道、每个 AI 提供商、每个工具都是一个插件。统一的接口，即插即用。新增一个渠道不需要改核心代码，实现几个 Adapter 接口就行。

怎么体验？

如果你想亲手玩一下这个交互式网页：

重点：点击https://jiaojieclaw.site/

进入完整交互版。建议用电脑浏览器打开效果最佳。手机也能看，但交互图表在大屏上更爽。

如果你是开发者，想自己部署 OpenClaw，三条命令：

npm install -g openclaw@latestopenclaw onboard --install-daemonopenclaw gateway --port 18789 --verbose

关于openclaw资料包和系列文章