OpenClaw（小龙虾）技术架构与工作原理（极简拆解）

一、整体架构（四层，从上到下）

│ 接入层（Channels + CLI + Web）

入口：飞书/命令行/面板

│ 控制平面（Gateway）

中枢：路由、会话、状态、安全

│ 执行平面（Agent Runtime）

大脑：意图、规划、工具调度

│ 能力层（Plugins + Skills + MCP）

手脚：执行操作、对接外部系统

二、每层核心职责（大白话版）

1. 接入层（Channels + CLI + Web）

作用：所有消息/指令的入口

- Channels：飞书/钉钉/微信等聊天渠道（你现在用的 channels.feishu ）

- CLI： openclaw 命令行（你的遥控器）

- Web Dashboard：浏览器控制面板（ openclaw dashboard ）

关键：把不同入口的消息统一成 OpenClaw 内部格式。

2. 控制平面（Gateway）

作用：系统中枢、交通枢纽、安全中心

- 管理会话（Session）、鉴权、路由

- 常驻后台（WebSocket 服务）

- 安全审计、权限控制、命令拦截

你看到的： openclaw gateway start 启动的就是它。

3. 执行平面（Agent Runtime）

作用：AI 大脑，ReAct 循环（思考+行动）

- 意图解析：理解“帮我读飞书文档”

- 任务拆解：拆成“读文档→提取要点→生成总结”

- 工具调度：选 feishu_doc 技能

- 上下文管理：记住对话历史

- 流式输出：边思考边回复

核心循环：

输入 → 上下文 → 模型推理 → 工具调用 → 结果 → 循环/结束

4. 能力层（Plugins + Skills + MCP）

作用：真正“动手”的能力

- Plugins：驱动/适配器（飞书插件）→ 连外部系统 API

- Skills：功能模块（ feishu_doc / feishu_chat ）→ 具体做事

- MCP：通用工具协议 → 对接 Claude 等外部模型/工具

比如飞书插件 + 飞书技能

三、完整工作流程（以飞书场景为例）

1. 消息流入

你在飞书发：“帮我读这个飞书文档”

→ Channels.feishu 收到消息 → 传给 Gateway

2. 网关处理

Gateway 做：

- 鉴权（你已配对）

- 路由到对应 Agent

- 生成会话（Session）

- 转发给 Agent Runtime

3. Agent 思考（核心）

Agent 执行 ReAct 循环：

1. 理解意图：读飞书文档

2. 查上下文：你之前的对话

3. 调用大模型：规划步骤

4. 选工具：调用 feishu_doc 技能

5. 发指令：让能力层执行

4. 能力层执行

- Skills（feishu_doc） 接收指令

- 调用 Plugin（飞书插件）

- 飞书插件调用飞书 API → 读取文档内容

- 返回结果给 Agent

5. 结果返回

- Agent 整理结果 → 生成回答

- 流式输出 → 传给 Gateway

- Gateway 转发给 Channels.feishu

- 飞书机器人把回答发回给你

四、核心技术点（一句话懂）

- Gateway：WebSocket 长连接、会话管理、安全控制

- Agent：ReAct 推理循环、任务编排、工具调用

- Plugins：适配器模式、API 封装、热加载

- Skills：函数式工具、参数校验、沙箱执行

- MCP：统一工具协议、跨模型兼容

- CLI：命令行控制、配置管理、日志查看

五、总结

- 大模型：Agent 的大脑

- Agent：执行平面的核心，总指挥

- OpenClaw：整套框架（身体）

- Channels：接入层（飞书入口）

- Plugins：能力层（驱动）

- Skills：能力层（功能）

- MCP：能力层（通用接口）

- CLI：接入层（遥控器）