OpenClaw架构解析:你的AI助手是如何跑起来的
OpenClaw架构解析:你的AI助手是如何”跑起来”的
你是否好奇过:当你在飞书上发一条消息,几秒后AI就能帮你查天气、整理文件、甚至控制家里的摄像头——这背后发生了什么?今天我们来拆解一下OpenClaw这只”龙虾”的内部构造。
一、OpenClaw是什么?
简单来说,OpenClaw是一个可以自己部署的个人AI助手。
和ChatGPT不同,它不只是”聊天”,而是真正能”干活”:操作你的电脑文件、控制智能家居、跨平台收发消息(微信、Telegram、飞书、Discord等20+平台)。
核心特点:
- 本地优先:运行在你自己的设备上,数据不离开你的控制
- 多平台接入:一个助手同时服务微信、Telegram、飞书等多个平台
- 能动手:通过工具系统执行实际操作(读写文件、控制设备、浏览器自动化)
- 可扩展:技能系统让AI在特定领域更专业
二、整体架构
OpenClaw采用“Gateway中心化”架构。用一张图说明:
▲ OpenClaw架构图:Gateway作为中心枢纽
所有组件都通过一个统一的中枢——Gateway(网关)进行协作。
为什么这样设计?
用一个简单的类比:Gateway就像是”总机”,所有消息平台(微信、Telegram等)是”外线电话”,你的手机、电脑是”内线分机”。所有人想找AI,都得通过总机转接。这样做的目的是:
-
统一管理:所有会话状态集中在Gateway,不会出现”消息丢了”的情况 -
安全可控:陌生人发消息会被要求配对,只有你批准的人才能和AI对话 -
方便扩展:新增一个平台,只需要接入Gateway,不用改动其他组件
三、核心组件详解
3.1 Gateway:总指挥部
Gateway是OpenClaw的核心,它是一个长期运行的服务程序,默认监听ws://127.0.0.1:18789。
主要职责:
|
|
|
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
3.2 Channels:消息通道
OpenClaw支持20+消息平台,每个平台是一个”Channel插件”:
|
|
|
|
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
设计巧妙之处: 每个Channel遵循统一接口。这意味着新增一个平台,只需要实现这个接口,Gateway完全不需要改动。
3.3 Nodes:延伸到设备
这是OpenClaw最有特色的设计。Gateway通常运行在服务器上,但很多操作需要在设备本地执行——比如用手机拍照、读取电脑文件。
Node的工作方式:
-
手机/电脑上的Node客户端连接到Gateway -
声明自己能提供什么能力(相机、位置、通知等) -
等待Gateway下发指令执行完毕后返回结果
支持的设备能力:
|
|
|
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
3.4 Agent:AI的大脑
Agent是真正”思考”的部分。它接收用户消息,理解意图,决定使用哪些工具,编排执行流程。
工作流程:
-
接收消息,结合历史上下文 -
调用大语言模型(支持OpenAI、Claude等多种模型) -
模型决定是直接回复还是调用工具 -
如果需要工具,执行后将结果反馈给模型 -
生成最终回复
3.5 Skills:技能系统
Skills是工具的”组合包”,让AI在特定领域更专业。比如:
- weather技能:查询天气
- github技能:操作GitHub仓库
- browser技能:浏览器自动化
- feishu技能:飞书文档操作
四、一条消息的完整旅程
让我们跟踪一条消息从发送到回复的全过程:
|
|
|
|
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
整个流程在0.5秒内完成,用户几乎感觉不到延迟。
五、安全设计:你的AI你做主
OpenClaw非常重视安全。默认情况下,陌生人的消息不会被处理,而是返回一个配对码:
陌生人: 帮我查天气AI: 你好!我是主人的AI助手。请让主人运行以下命令来配对: openclaw pairing approve telegram ABC123只有你批准后,对方才能正常使用。
安全特性:
- 配对机制:每个新用户/设备都需要手动批准
- 白名单:只允许指定的人使用你的AI
- 会话隔离:不同用户的对话历史完全独立
六、如何部署?
最简单的部署方式:
# 安装npm install -g openclaw@latest# 启动配置向导openclaw onboard --install-daemon# 启动网关openclaw gateway配置向导会引导你完成:
-
设置模型(支持OpenAI、Claude等) -
连接消息平台(Telegram、Discord等) -
配置配对和安全策略
七、适合什么人使用?
|
|
|
|
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
总结
OpenClaw的核心设计可以概括为:
一个中心:Gateway作为唯一中枢,统一管理所有流量
三层能力:
-
Channels层:对接外部消息平台
-
Agent层:AI思考和决策
-
Nodes层:延伸到物理设备
两大保障:
-
安全机制:配对+白名单,你的AI你做主
-
扩展机制:Skills系统按需增强能力
这就是OpenClaw——一个真正”能干活”的个人AI助手。
本文基于OpenClaw 2026.3版本
开源地址: https://github.com/openclaw/openclaw
文档: https://docs.openclaw.ai
夜雨聆风