按理说，

OpenClaw 源码详细说明：这只龙虾到底是怎么造出来的？🦞

前言的观点是。GitHub 里的龙虾王国

如果你以为 OpenClaw 就是几行代码凑合的玩具项目，那你完全错了。这只龙虾的代码库规模大得让人怀疑人生——src/ 目录有 + 子目录extensions/ 支持 + 个网站连 CHANGELOG 都有 693KB。

今天我要带你潜入 GitHub 源码海洋，看看这只龙虾到底是怎么从一堆 TypeScript 文件变成统治 AI 世界的庞然大物的。

警告这篇文章包含大量技术细节和 ASCII 艺术，建议边看代码边吃龙虾。

从第一章来看。根目录的战争 🌲

打开 OpenClaw 的 GitHub 仓库，你会看到一个…嗯，非常“丰富”的根目录：

openclaw/
├── src/ # 主要代码
├── extensions/ #
插件
├── packages/ # 子包
├── skills/ # 技能插件
├── apps/ # 原生应用
├── docs/ # 文档
├── assets/ # 静态资源
├── test/ # 测试
...
└── .pre-commit-config.yaml # 预提交钩子

配图 ：根目录的混乱美学

┌─────────────────────────────────────────────────────────────────┐
│ OpenClaw 根目录 │
├───────────────────────────────────────────────────────────────┤
│ 📂 src/ 🦞 主要代码。+ 子目录 │
│ 📂 extensions/ 🦞 + 网站
触手伸向四面八方 │
│ 📂 packages/ 🦞 子包，独立的逻辑单元 │
│ 📂 skills/ 🦞 技能插件，可插拔的超能力 │
│ 📂 apps/ 🦞 macOS/iOS/Android 原生应用 │
│ 📄 CHANGELOG.md 🦞 693KB 的回忆录 │
│ 🐳 Dockerfile 🦞 龙虾的潜水艇，一潜就是几天 │
│ ⚙️ package.json 🦞 .8KB 的配置 │
└───────────────────────────────────────────────────────────────┘
"我只是一只简单的龙虾" — 龙虾本人

根目录的哲学

使用者痛点：刚进项目就被庞大的文件结构淹没，不知道该从哪儿开始。说起来，OpenClaw 用「一站式」结构把主要、 、文档全部归类。让你可以一步步聚焦，

• Gateway 控制平面: 管理会话、消息、工具、事件。
• 多网站接入: 支持 + 个消息网站。
• 原生应用环境: macOS 菜单栏、iOS、Android 客户端。
• 插件程序: 可 的 Skills 与 Extensions。说起来，
• 完整工程化: 测试、CI/CD、文档、多语言。

至于第二章，src/ —— 龙虾的身体构造 🦠

src/ 是 OpenClaw 的主要代码库。这里有 + 个子目录,每个都负责一块功能。让我解剖一下这只龙虾：

主要模块概览

src/
├── gateway/ # 🧠 Gateway 主要
├── channels/ # 📱 所有渠道通用接口
├── agents/ # 🤖 Agent Runtime
├── sessions/ # 💬 会话管理
├── context-engine/ # 🧠 上下文引擎
...
└── shared/ # 🤝 共享工具

Gateway 主要架构

src/gateway/ 是整个项目的心脏，负责：

• WebSocket 服务器
• 会话管理
• 消息路由
• 工具调用
• 事件分发

使用者痛点：K8s 或 Docker 环境中如何保持长连接？ Gateway 使用统一 WebSocket 协议。让所有客户端都走同一条「神经」线，断线自动重连。

Channels：+ 只手臂

src/channels/) 定义通用接口。每个网站都有独立实现：

渠道	D​irectory​
D​iscord​	`src/discord/`
T​elegram​	`src/telegram/`
S​lack​	`src/slack/`
S​ignal​	`src/signal/`
L​ine​	`src/line/`

The diversity of channel implementations is intentional: you can add a new platform by dropping a folder that implements standard interface.

interface ChannelExtension {
再看name，string;其实，version: string;connect: Promise;disconnect: Promise;sendMessage: Promise;onMessage=>void): void;}

Agent Runtime：大脑思考方式 🚀

The agent runtime handles LLM calls。tool execution,context compression and streaming responses.

• L​LM 调用 – OpenAI / Anthropic / 本地模型等。
• T​ool 执行 – 文件读写、Shell 命令、浏览器自动化等。
• C​ontext 管理 – 动态压缩历史对话，防止 token 爆炸。
• S​treaming – 边生成边返回，实现流式 UI 效果。

If you ever felt “AI 返回太慢” or “上下文丢失”。这里提供了完整方法：先压缩再生成，再把结果流式推送回客户端。

使用者消息进入 → 收集上下文 → 建立 Prompt → 调用 LLM →
处理工具调用 → 输出响应 → 推送到客户端 → 保存到 Session

说到第三章，extensions/ —— 龙虾的触手延伸 🐙

The /extensions") folder houses all platform‑specific adapters. Each extension is a self‑contained npm package that implements same ChannelExtension interface.

支持的网站 :

extensions/
├── acpx/
├── bluebubbles/
├── discord/
├── feishu/
├── googlechat/
...
└── twitch/
# 总计 + 个网站支持

The modular design solves a common pain point: **“Adding a new chat service always breaks existing code.”** With extensions you just drop a new folder。run `pnpm install`,and Gateway auto‑discovers it.

从插件架构要点来看，

• No cross‑contamination – each platform runs in its own process if needed.
• Easily testable – unit tests live under /test/extensions/*_test.ts.
• User can disable any extension via config file .
...

再看第四章，packages/ —— 龙虾的孵化场 🥚

packages/
├── clawdbot/
└── moltbot/
# Both are publishable npm packages.

为什么要拆成子包？🎯

• #独立发布 => 更快迭代；
• #降低耦合 => 主仓库升级不影响已发布包；
• #社区贡献 => 使用者可以直接 `npm i @openclaw/clawdbot` 使用。...

...

---