OpenClaw 源码解读（1）：项目概览与快速上手

OpenClaw 自从年前火爆之后，各大软件开发公司内部开始广泛使用，独立开发者也通过它来实现自动化工作，大大提升效率。但老金觉得，任何工具想使用得好，还是要深入地剖析它的技术原理，最直接的方式，就是源码解读，后面老金通过一系列文章来分享对 OpenClaw 源码的解读。

从本地中枢到万物互联

OpenClaw 的设计理念可以概括为："网关只是控制平面，助手本身才是真正的产品"。它不仅是一个聊天机器人，更是一个高度自动化的生活与工作管家。它的核心特性包括：

本地优先的网关（Local-first Gateway）：OpenClaw 提供了一个基于单一 WebSocket 网络的控制平面中枢，集中负责会话、频道接入、工具调用以及系统事件的统一调度。
多渠道收件箱（Multi-channel inbox）：它打通了我们在日常生活中使用的几乎所有通讯工具，支持直接在 WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage 等多达 20 余种消息渠道中与你的助手对话。
多智能体路由（Multi-agent routing）：系统能够将不同渠道、不同账户或对等节点的入站请求，精准路由到彼此隔离的专属 Agent 工作区中，实现多会话的独立管控。
跨端节点机制（Nodes）：不仅仅是文本对话，OpenClaw 允许将 macOS、iOS 或 Android 设备作为网络中的"节点（Node）"进行配对，从而能够直接调用设备的摄像头（拍照/录像）、屏幕录制、获取地理位置，甚至执行诸如 system.run 的系统底层命令。

为了满足跨平台互通与设备底层的强控制力，OpenClaw 在技术选型上十分务实：

运行环境：它的网关守护进程依赖于现代化的运行时环境，官方推荐使用 Node.js ≥ 22 来保证最佳性能。
前端与网关主逻辑：仓库语言统计显示，核心代码中有高达 86.5% 的 TypeScript，这些代码构成了项目的基石，涵盖了后端路由、WebSocket 通信以及 Agent 运行时的相关逻辑。
多端原生能力：为了让助手能够真正在移动端和桌面端执行设备级操作（例如实现持续语音拾音、调用原生的系统 TTS 等），项目还辅以 8.9% 的 Swift 用于构建 macOS 和 iOS 节点，以及 2.1% 的 Kotlin 用于打造 Android 节点应用。

克隆 OpenClaw 的源码后，你会发现其工程结构具有极高的模块化水准。以下是核心代码目录的功能划分概览：

src/：包含 Gateway（网关）的主干逻辑与核心网络路由，是整个后端的"控制大脑"。
packages/：各类通用的基础代码包，用于沉淀与抽象核心模块，供各个子项目调用。
apps/：伴随应用（Companion apps）的温床，包含了不同操作系统的原生节点应用源码，比如 macOS 状态栏控制程序、iOS 和 Android 端的节点应用。
ui/：存放由 Gateway 直接提供服务的 Web 界面资源，例如 Control UI 仪表盘与内嵌的 WebChat 前端代码。
skills/：技能扩展（ClawHub）的脚本与注册表存放处，包含了用于强化 Agent 能力的打包技能（Bundled skills）与脚本框架。

从工程的架构和设计思想可看出，OpenClaw 的作者开发功力不同一般。

项目发起人 Peter Steinberger 及开源社区不仅赋予了它有趣的产品灵魂，更在底层构建了一个极具扩展性和安全性的工程奇迹。

在下一篇文章中，我们将正式深入源码，探究这个万物互联的强悍中枢——OpenClaw Gateway 控制平面究竟是如何运作的。