你提到的应该是 OpenClaw(常被误写为 OpenClawe,社区俗称“小龙虾”),它是当前 GitHub 上增长最快的开源 AI Agent 项目之一,采用「微内核 + 插件化 + 多通道接入」的分布式架构,主体基于 TypeScript 生态构建,同时搭配原生多端客户端。以下是完整的技术栈拆解:
一、核心底座与主技术栈
1. 运行时与开发语言
- 核心运行时:Node.js ≥ 22,依托 Node.js 强大的异步 I/O 能力与完整的 npm 生态,非常适配多通道长连接、消息路由、Agent 异步调度的场景。
- 开发语言:全栈 TypeScript,占代码主体,通过静态类型检查保障复杂 Agent 系统的可维护性与健壮性,是大型开源 Agent 项目的主流选型。
- 包管理与构建:pnpm 做依赖管理,Turbo 做 Monorepo 多包构建调度,支持模块级缓存与并行构建。
2. 核心架构模式
OpenClaw 采用经典的「网关控制平面 + 多插件扩展」微内核架构:
- 统一网关 Gateway:基于 WebSocket RPC 协议(v3 版本)搭建,是整个系统的唯一控制中枢,负责消息路由、会话管理、权限范围控制、多 Agent 调度,所有客户端与渠道都通过网关接入。
- Web 框架:Express 承载网关核心 HTTP API,Hono 处理轻量路由与边缘场景,兼顾成熟度与轻量性能。
- 依赖注入与副作用管理:Effect TS 框架,采用 Layer/Context/Service 分层模式,替代传统面向对象方案,保障复杂 Agent 流程的类型安全与可测试性。
- 参数校验:Zod 做全链路运行时 Schema 校验,覆盖工具参数、模型返回、用户配置,减少边界异常。
二、Agent 核心能力层技术栈
1. Agent 执行引擎
- 自研 Agent 运行时,支持多轮思考循环、工具调用、子 Agent 拆分、权限策略隔离;
- 内置工具目录与权限策略系统,可精细控制 Agent 的文件、命令、网络权限边界;
- 支持 Cron 定时任务,可隔离执行周期型自动化任务。
2. 记忆与存储
- 本地优先设计:核心配置、人格设定、技能全部以 Markdown 纯文本存储(SOUL.md、SKILL.md),用户完全掌控本地数据;
- 结构化存储:嵌入式 SQLite 存储会话记录、元数据;
- 向量记忆:默认集成 LanceDB 向量数据库,实现长时记忆检索,支持本地私有化部署;
- 可观测性:集成 OpenTelemetry,支持全链路诊断与性能追踪。
3. 技能与工具生态
- Skills 技能系统:纯文本驱动(SKILL.md),Agent 可自动读取并使用技能,官方 ClawHub 社区已有上万款社区技能;
- 内置工具:原生支持文件读写编辑、Shell 命令执行、网页抓取、浏览器控制、图片/PDF 解析、消息转发等基础能力;
- 扩展协议:支持自定义工具注册,可通过插件扩展第三方服务与 MCP 协议工具。
4. 大模型适配
- 模型无关设计,通过统一适配层支持 22+ 主流 LLM 提供商,包括 Anthropic Claude、OpenAI GPT、DeepSeek、本地 Ollama 等,不绑定单一厂商。
三、多端接入与客户端技术栈
OpenClaw 的核心设计理念是「消息平台即 UI」,支持极丰富的接入渠道,同时提供官方原生客户端:
- 聊天渠道插件:通过扩展层支持 50+ 消息平台,比如 Telegram(基于 grammy)、Discord(基于 discord.js)、WhatsApp、Slack、iMessage 等,全部以插件形式按需加载。
- 官方原生客户端:
- iOS / macOS 客户端:Swift 原生开发,深度适配苹果生态;
- Android 客户端:Kotlin 原生开发;
- Web 控制面板:React 开发,提供可视化会话管理与配置界面;
- CLI 命令行:Node.js 实现,支持终端直接交互与守护进程部署。
四、部署与运维
- 支持本地直接运行、Docker 容器化部署、系统守护进程常驻多种模式;
- 支持 Windows(WSL2)、macOS、Linux 全平台运行,适配个人桌面与服务器自托管场景。
五、技术选型的核心逻辑
OpenClaw 选择以 TypeScript + Node.js 为核心,主要有三个原因:
- 生态适配:AI Agent、消息渠道 SDK、工具库的 JS/TS 生态最完善,社区贡献门槛低,迭代速度远快于其他语言;
- 场景匹配:Node.js 的异步非阻塞模型,天然适配多 WebSocket 长连接、多消息渠道并发、Agent 异步调度的 IO 密集型场景;
- 本地友好:单 Node.js 运行时即可跨全桌面平台运行,配合 Docker 可快速实现私有化部署,契合「本地优先、用户掌控数据」的产品定位。