2025 年 11 月 24 日上午 11:16，Peter Steinberger 推送了一个只有 LICENSE 文件的 commit1。三个月后，这个项目有 21.8 万颗 Star、847 位贡献者，每两分钟收到一个 Pull Request——然后不得不按下暂停键。

我翻了 15,579 个 commit、11,058 个 Issue 和 11,991 个 PR。下面是我找到的故事。

先说名字。Clawd = Claude + Claw，一个谐音梗，把 AI 的名字和龙虾的钳子焊在了一起。项目吉祥物是一只太空龙虾，叫 Molty，官方口号是 “EXFOLIATE!”——对标 Dalek 的 “EXTERMINATE!”，只不过把”消灭”换成了”去角质”。

龙虾靠蜕壳才能长大。旧壳太紧了，撑不下新长出来的肉，只能脱掉重来。这个项目在九十天里蜕了四次壳——Warelay、Clawdbot、Moltbot、OpenClaw——每次改名都是一次蜕壳，每次蜕壳都意味着旧的架构撑不住了。docs/start/lore.md 里有一句话：“The claw is the law 🦞“。读完这篇你就知道为什么。

511 行

七分钟后，第二个 commit 到了2。511 行 TypeScript，一个 src/index.ts。

Peter Steinberger 不是新手。他创建过 PSPDFKit——一家被广泛使用的 PDF SDK 公司——后来退出、退休。GitHub 签名写的是 “Came back from retirement to mess with AI.” 退休的人回来折腾 AI 了。

那 511 行代码做的事情简单到可以用一句话说清楚：收到 WhatsApp 消息，启动一个 Claude CLI 子进程，把消息当参数传进去，解析输出的 JSON，把回复发回 WhatsApp。消息通道用的是 Twilio——一种无状态的 Webhook 模型，消息进来触发一次 HTTP 请求，处理完就断开。

没有 API 调用，没有 SDK，没有抽象层。就是 child_process.spawn('claude')——启动一个子进程，消息进去，JSON 出来。项目叫 Warelay，WhatsApp Relay 的意思。名字说明了一切：它只是一个中转站。

这样的设计有一个致命的优点：十分钟内就能跑起来。Claude CLI 已经装在他的 Mac 上了，不需要申请 API key，不需要搞 SDK 集成，直接拿来用。代价是每条消息都要冷启动一个新进程，没有会话保持，没有工具调用，没有流式输出——用户发一条消息，等 30 秒，收到一整段回复。

但 steipete 显然不在乎这些。接下来的 18 个小时里他提交了 139 个 commit，版本号从 0.1 随手跳到 1.1。心跳系统、语音转录、媒体压缩、群聊支持，想到什么加什么。凌晨三点还在改代码，那种创客特有的、不计后果的兴奋。

第二天，一行代码悄悄定义了这个项目的性格。commit 0adc0ed3，steipete 写了一段系统提示词：“You are Clawd (Claude) running on the user’s Mac via warelay.” 子进程不再只是一个中转站——它有了名字、有了人格、有了身份。龙虾的第一层壳，就是在这一天长出来的。

同一天还发生了一个更深层的架构转折。steipete 引入了 Baileys，一个直接实现 WhatsApp Web 协议的库。Twilio 是外卖电话，响一次挂一次；Baileys 是住家厨师，一直在线等着。Twilio 用 Webhook，无状态的；Baileys 用 WebSocket，有状态的。

这个切换意味着项目不再是一个可以随用随弃的脚本，而是一个需要持续运行的守护进程。项目在诞生后的第二天就完成了第一次蜕皮。12 月 5 日，Twilio 被彻底移除，commit 信息写着 “drop twilio and go web-only”4。

第一个外部贡献者在 PR #15 出现——@mneves75 修复了 WhatsApp Linked ID 的格式问题。紧接着是第一道裂缝：PR #106，一个叫 @joaohlisboa 的开发者发现暴露在公网的媒体端口存在路径遍历漏洞，可以读取服务器上的任意文件。

从”我的工具”到”别人也在用”，中间只隔了四天。从”别人也在用”到”别人发现了安全漏洞”，又是四天。一个创客的周末项目，开始不得不认真对待了。

选择 Pi 的那一天

12 月 2 日，steipete 做了第一次抽象尝试——把 Claude CLI 从硬编码变成可配置，除了 Claude 还能调用 Pi CLI、Codex CLI、Opencode CLI。本质没变，还是子进程管道。就像一家只做外卖的餐厅，从只接美团扩展到了同时接饿了么和大众点评，厨房还是那个厨房。

但在同一时期，一个叫 Tau RPC 的中间层悄悄出现了。与其每条消息都冷启动一个新子进程，Tau 让 Pi 作为一个持久的后台进程运行，通过 RPC 管道通信——不再是每条消息新建一个进程，而是一个常驻进程接收所有请求。从”每次叫外卖”变成了”请了一个驻场厨师”，虽然厨师还是外面请来的，但至少不用每顿饭重新招聘。

真正的转折发生在 12 月 19 日。

那天有两件事同时发生。项目从 Warelay 改名 Clawdis，发布了 2.0.0-beta1。更重要的是，一个叫 pi-mono 的外部项目第一次被嵌入到代码库里——commit fb3fae437，文件 src/agents/skills.ts，只有 15 行代码。

pi-mono 是 Mario Zechner 的项目，不是一个简单的 API 封装，而是一整套 LLM Agent 运行时——工具调用、上下文管理、会话历史、多模型支持，全部打包在一起。三步走完了：spawn('claude') 冷启动，到 Tau RPC 持久进程，再到 Pi 嵌入式运行时。每一步都把 LLM 拉得离宿主更近一点，直到它变成了宿主身体的一部分。

三天后的 Issue #468，一个用户问能不能支持自定义模型。steipete 回了一句话：

“Absolutely, one of the reasons I went with pi are local models. Fixing that rn, will land in main in a few minutes.”

两个关键信息。第一，选 Pi 是因为它支持本地模型——不用被锁死在 Claude 一个供应商上面。第二，“fixing that rn, will land in main in a few minutes”——现在改，几分钟后上线。这就是 steipete 的节奏。不讨论，不排期，不开会。

引入 Pi 之后，Agent 架构变成了双轨制。旧路径还在，仍然可以启动外部 CLI 作为子进程，留给那些只有命令行工具的 Agent 用。新路径是 Pi 运行时直接嵌入在进程里——工具调用、上下文管理、流式输出，全在进程内完成。新架构是默认，旧架构降级为后备。

这 15 行代码还带来了一个当时看不出来的东西：Skills 系统的雏形。那个 skills.ts 文件从 Pi 导入了一个函数，作用是从本地目录加载 SKILL.md 文件，注入到 Agent 的系统提示里。从第一天起，Skills 就不是核心代码的一部分——它们是外部的、可插拔的、用户自己可以添加的模块。

两个月后，当成千上万的贡献者想往核心加功能时，这个泄压阀会变得至关重要。但那是后话了。

沙箱是坏的

用别人的运行时，意味着命运部分掌握在别人手里。这件事的代价比预想来得快。

2026 年 1 月 2 日，steipete 提了 Issue #819，全文十二个英文单词：

“Sessions that are semi-public (e.g. Discord guilds) should run in a Docker container. Security.”

没有讨论。两天后关闭，标记完成。

但三天之后的 Issue #24310 暴露了一个致命的设计缺陷：OpenClaw 精心构建的 Docker 沙箱工具被传给了 Pi Agent 运行时，但 Pi SDK 完全忽略了这些工具，用自己内置的版本替换掉了。OpenClaw 说”用我的沙箱化 bash”，Pi 说”不，我用我自己的”。

沙箱从第一天起就是摆设。你以为你在开车，但方向盘连的是另一套转向系统。

同一时期，上游依赖接连爆破。Issue #11811，Pi 的一个 commit 破坏了 OpenClaw 的 pnpm patch 文件，导致 29 个 TypeScript 编译错误。Issue #92212，Gemini 3 的一个 bug 需要在 Pi 的代码库里改。你自己项目的 bug，要排队等别人来修。速度换控制，这个 trade-off 从来都不免费。

不过，沙箱事件也催生了更成熟的安全思维。Issue #51313 的讨论里有一句话：

“This is a policy boundary, not a security sandbox.”

然后它列举了自己无法防御的攻击：编码路径绕过、解释器绕过、多步攻击。大多数项目会告诉你他们的安全模型”足够了”，OpenClaw 直接告诉你——不够。这种对自身局限的坦诚在开源项目中非常少见。

调度中心

12 月 8 日，一个 WebSocket 守护进程上线了，监听端口 18789。它有一个朴素的名字：Gateway。

Gateway 的角色不难理解——它是所有消息的十字路口。WhatsApp、Telegram、Discord、Signal、Slack、iMessage，所有消息平台的消息先汇入 Gateway，由 Gateway 分发给 Agent 处理，再把回复发回对应的平台。但它的意义远不止消息中转。

当 Gateway 成为系统的中枢之后，所有东西都可以接进来了。接下来一周发生的事情近乎荒诞：12 月 8 日 macOS 菜单栏应用出现，12 月 10 日 iOS 伴侣应用开始开发，12 月 14 日 Android 客户端上线。一个星期，三个原生平台。iOS 的 README 至今写着 “Super Alpha”——但它能拍照、能录屏、能读日历、能发通知，因为它不需要自己实现 AI 的部分，它只是 Gateway 的一个终端节点。

这就是 Gateway 架构最精妙的地方。每一个客户端——无论是 macOS 菜单栏、iPhone、Android 手机、CLI、还是 Web UI——都只是一个连到端口 18789 的节点。它们共享同一个会话密钥 main，你在手机上说的话，Mac 上能接着聊。Gateway 甚至支持 Bonjour 自动发现——同一局域网里的设备不需要手动配置，它们会自己找到彼此。

一个月后，消息平台的膨胀催生了一个 232 个文件的 PR。所有消息平台从散落的代码被重构成了插件架构，每个平台变成一个自包含的模块，实现统一的接口。两天后 “Provider” 被重命名为 “Channel”——因为 Provider 同时也是”AI 模型提供商”的意思，两个概念撞车了。名字很小，但命名即思考。

从 CLI 脚本到分布式系统，从一个消息平台到十三个，从命令行到三个原生客户端——Gateway 是这一切的枢纽。没有它，OpenClaw 还是一个聊天机器人。有了它，OpenClaw 变成了一个操作系统的雏形。

记忆

一个能聊天的 AI 助手和一个真正有用的 AI 助手之间，隔着一层记忆。

1 月 12 日前后，OpenClaw 的记忆系统开始成形。设计哲学用一句话就能概括：Markdown 是真相之源，其他一切都是可重建的衍生品。

记忆的存储形式是 ~/.openclaw/workspace/memory/ 目录下的纯 Markdown 文件。每天一个 YYYY-MM-DD.md，追加写入，不做修改。还有一个可选的 MEMORY.md 用于长期记忆。没有专有格式，没有二进制数据库，用任何文本编辑器都能打开。如果你想知道 AI 助手”记得”什么，打开文件夹看就行了。

但纯文本搜不动。你不能指望 grep “Mac Studio” 能找到”运行 Gateway 的那台机器”。所以 OpenClaw 在 Markdown 之上建了一层索引——每个 Agent 一个 SQLite 数据库，存在 ~/.openclaw/memory/ 下面。文本被切成大约 400 token 的碎片，每个碎片生成一个向量嵌入，存进 SQLite。搜索的时候，向量相似度占七成权重，BM25 关键词匹配占三成，两条路径交叉验证。

嵌入模型的选择暴露了这个项目一贯的自托管执念。默认选项不是 OpenAI 的 API，而是一个 3 亿参数的本地 GGUF 模型——embeddinggemma-300m，大约 0.6 GB，用 node-llama-cpp 在你自己的机器上运行。你的记忆向量不需要离开你的电脑。如果你有 OpenAI 或 Gemini 的 API key，也可以用远程嵌入——但那是退路，不是默认。

记忆还有时间衰减。30 天半衰期——今天的记忆权重 100%，一周前 84%，一个月前 50%，三个月前只剩 12.5%。但有些文件永远不衰减：MEMORY.md 和非日期命名的文件被标记为 “evergreen”，像长期记忆一样常驻。短期记忆会褪色，核心记忆不会。

最重要的设计决策藏在一个看不见的地方：所有的索引都是可以重建的。删掉 SQLite 文件，重新跑一遍 openclaw memory index，一切恢复如初。真相永远在 Markdown 里。你可以换嵌入模型、换搜索算法、甚至换整个检索后端，只要那些 .md 文件还在，记忆就还在。数据和视图分离——这是最古老也最可靠的架构原则之一。

洪水

1 月 5 日，项目改名 Clawdbot。然后一切加速了。

一周内，Issue 编号从 #75 跳到 #485。知名开发者 @swyxio 跑来报了一个 Discord Gateway Error 4014。消息平台像潮水涌入——Telegram 和 Discord 之后，Signal、iMessage、Slack、MS Teams、Matrix、LINE、Nostr、Zalo 排着队来。

发布节奏变成了每周两到三个版本。steipete 一个人贡献了超过一万个 commit，占总数的三分之二。

也有些东西被拒绝了。PR #5514，一个贡献者提交了完整的交互式安装向导，steipete 否了——“pnpm is not something we should enforce. That’s a user choice.” PR #8615，Gemini 集成被拒——“I don’t think Gemini is a good option for this agent, so don’t wanna offer it in the onboarding flow.” 技术上 Pi 运行时是支持 Gemini 的，他拒绝的不是技术能力，而是默认体验的品质门控。

这些拒绝背后藏着一种哲学。Issue #616，项目诞生的第四天，steipete 说过一句话：

“This is a dangerous feature, so you decide. I don’t set defaults here.”

不替用户做决定。不设默认值。你想让 AI 在半夜自动检查电池电量，行。你想让它有 root 权限，行，但后果自负。这套哲学在用户从 1 涨到 100 的时候完美运作。但当 21.8 万人涌入时，它就绷不住了。

学会说”不”

1 月 29 日，项目第四次改名，定名 OpenClaw。之前是 Warelay、Clawdis、Clawdbot，中间还有一个只存在了三天的 Moltbot——德语 “molt”，蜕壳的意思。名字终于稳定了。但比名字更需要稳定的，是项目本身。

Issue #2215117，一个用户的 Claude Max 5 小时套餐在 20 分钟内被烧光了。292 次 API 调用，1010 万 token 写入缓存，只有 440 万被读取，估计消耗超过 100 美元。用户没有做错任何事，是系统的缓存行为导致了资源浪费。在”你决定”的哲学下，没有保护性默认值，没有消费上限，没有”你确定要继续？“的提示。

2 月 1 日，核心维护者 sebslight——不是 steipete 本人——发布了 Issue #579918，标题是 “OpenClaw: Stabilisation Mode”：

“We love the energy, but no human team can review at that pace and maintain quality. So we’re locking down the core to make it rock solid.”

“The project is receiving approximately one pull request every two minutes.”

每两分钟一个 PR。每小时三十个新 Issue。政策变化是剧烈的：新功能请求直接关闭，贡献者被引导去做 Skills。Discord 上有一个频道叫 #pr-thunderdome-dangerzone。

i18n 是压力最集中的战场。Issue #346019，64 条评论，社区渴望中文、日文、韩文支持。维护者的回应很诚实：

“We don’t currently have the bandwidth to properly support multiple languages.”

但后面还跟了一句更深层的理由——“We cannot verify them and this project carries too much of a security risk.” 一个能控制你电脑执行命令的 AI 助手，无法验证社区提交的翻译是否安全。万一有人在翻译里注入了恶意提示呢？

这时候，12 月 19 日种下的那颗种子终于发挥了作用。还记得那 15 行 skills.ts 吗？Skills 系统成了项目的减压阀。维护者反复说同一句话：

“Most ‘features’ are really just skills. Write one, drop it in, done.”

不需要改核心代码，不需要等 PR review，自己写一个 Skill 放进去就能用。当功能压力无法通过 review 流程消化时，这个架构层面的泄压阀就显得异常精妙——它把”拒绝贡献”变成了”换一种方式贡献”。

尾声

steipete 的哲学从 “you decide, I don’t set defaults here” 变成了 “we’re locking down the core to make it rock solid”。中间隔了九十天。

从一个人到八百多个贡献者。从 spawn('claude') 到 Tau RPC 到嵌入式多模型运行时。从 Twilio Webhook 到 Baileys 守护进程到 Gateway 调度中心。从没有记忆到 Markdown 日志到向量搜索。从一个消息平台到十三个，从命令行到三个原生客户端。四个名字，五十多个 Skills。

这不是背叛。这是长大。好比一个人开了一家路边摊，菜单上写着”你想吃什么我就做什么”。三个月后店门口排队排到了街尾，他不得不把菜单换成了固定的六道菜。不是他不想做了，是客人太多了。

但 cli-runner.ts 还在代码库里。那个原始的子进程调用——spawn('claude', args)——还在作为 fallback 路径存在着。

15,579 个 commit 的繁华之下，那 511 行代码的幽灵仍在呼吸。

数据来源：OpenClaw Git 仓库（15,579 commits, 847 contributors）、GitHub Issues（11,058）、GitHub PRs（11,991）、CHANGELOG.md、源码。所有引用均来自公开的 GitHub 讨论和 commit 记录。

Footnotes

  1. Initial commit with LICENSE · openclaw/openclaw@f6dd362d https://github.com/openclaw/openclaw/commit/f6dd362d ↩

  2. First working prototype (511 lines) · openclaw/openclaw@16dfc1a5 https://github.com/openclaw/openclaw/commit/16dfc1a5 ↩

  3. Add Clawd system prompt · openclaw/openclaw@0adc0ed https://github.com/openclaw/openclaw/commit/0adc0ed ↩

  4. Drop Twilio and go web-only · openclaw/openclaw@7c7314f6 https://github.com/openclaw/openclaw/commit/7c7314f6 ↩

  5. Fix WhatsApp Linked ID format · PR #1 https://github.com/openclaw/openclaw/pull/1 ↩

  6. Path traversal vulnerability in media endpoint · PR #10 https://github.com/openclaw/openclaw/pull/10 ↩

  7. Embed pi-mono runtime · openclaw/openclaw@fb3fae43 https://github.com/openclaw/openclaw/commit/fb3fae43 ↩

  8. Support custom models · Issue #46 https://github.com/openclaw/openclaw/issues/46 ↩

  9. Run sessions in Docker containers · Issue #81 https://github.com/openclaw/openclaw/issues/81 ↩

  10. Pi SDK ignores sandbox tools · Issue #243 https://github.com/openclaw/openclaw/issues/243 ↩

  11. Pi commit breaks pnpm patches · Issue #118 https://github.com/openclaw/openclaw/issues/118 ↩

  12. Gemini 3 bug requires Pi-side fix · Issue #922 https://github.com/openclaw/openclaw/issues/922 ↩

  13. Sandbox security model limitations · Issue #513 https://github.com/openclaw/openclaw/issues/513 ↩

  14. Interactive setup wizard rejected · PR #55 https://github.com/openclaw/openclaw/pull/55 ↩

  15. Gemini onboarding integration rejected · PR #86 https://github.com/openclaw/openclaw/pull/86 ↩

  16. Dangerous features: user decides · Issue #6 https://github.com/openclaw/openclaw/issues/6 ↩

  17. Claude Max burned in 20 minutes · Issue #22151 https://github.com/openclaw/openclaw/issues/22151 ↩

  18. Stabilisation Mode · Issue #5799 https://github.com/openclaw/openclaw/issues/5799 ↩

  19. i18n support discussion · Issue #3460 https://github.com/openclaw/openclaw/issues/3460 ↩