前言
OpenClaw 不是一个黑盒软件,它是一套完整的 AI 执行架构。本文带你从表层 UI 一直挖到内核调度,真正理解它在干什么,从此告别玄学报错。
1 OpenClaw 是什么?
OpenClaw = AI 大脑 + 命令执行引擎 + 本地网关 + 任务调度器 + 前端控制台
它不是简单的聊天机器人,而是一个能接管你电脑、自动执行操作的自动化代理框架(AI Agent Framework)。
核心本质:把自然语言 → 解析成可执行任务 → 调度本地能力 → 执行并返回结果
2 OpenClaw 整体架构
OpenClaw 采用分层架构,每一层各司其职,任何一层出问题都会导致异常。
整体五层架构
- Web UI 层(用户界面)
- Gateway 网关层(核心入口、转发、鉴权)
- Core 核心调度层(大脑:意图识别、任务规划)
- Runtime 执行层(命令、脚本、工具调用)
- Model 模型层(大模型接口:通义、DeepSeek、Ollama 等)
3 逐层解剖
3.1 Web UI 层
- 技术栈:Vue3 / TypeScript / Vite
- 作用:只负责展示与发送请求
- 不参与逻辑计算、不执行命令
- 连不上 → 90% 是 Gateway 没启动 / 端口被占 / 跨域
**原理结论:**UI 只是前端,真正的能力全在后端 Gateway + Core。
3.2 Gateway 网关层
这是最核心、最容易报错的一层。
Gateway 干三件事:
- 启动 HTTP 服务(提供 18789 端口)
- 鉴权与安全控制
- 转发请求给 Core 调度层
它是前端 ↔ 后端的桥梁,外部访问 ↔ 本地执行的门卫,多会话管理、日志记录、进程守护。
为什么 Gateway 一挂,OpenClaw 直接废?因为所有请求必须经过它,它是唯一入口。
3.3 Core 调度层
这是 OpenClaw 真正的 AI 智能核心。
你输入一句话,它会做:
- 意图识别:你想干什么?
- 任务拆解:分成几步?
- 工具选择:调用脚本?命令?文件操作?
- 执行编排:先做什么、后做什么
- 结果整合:把执行结果返回给你
它本质是一个 ReAct 框架(Reason + Act)= 思考 → 行动 → 观察 → 再思考 → 再行动。
这就是为什么 OpenClaw 能自动操作电脑。
3.4 Runtime 执行层
这一层直接和你的操作系统交互。
支持能力:
- 执行系统命令(cmd /powershell/bash)
- 读写文件
- 调用外部程序
- 运行 Python/JS 脚本
- 模拟输入、桌面控制
风险点也在这里:Runtime 拥有你用户级别的权限,所以它能改文件、删数据、跑程序。
懂原理的人会限制权限,不懂原理的人只会无脑给管理员权限。
3.5 Model 模型层
OpenClaw 本身不带模型!它只是一个调用壳。
流程:
- Core 组装 Prompt
- 发送给你配置的模型
- 模型返回结构化指令
- Core 解析并执行
结论:
- 模型笨 → OpenClaw 就笨
- 模型断连 → OpenClaw 就卡住
- 模型不返回格式 → OpenClaw 无法执行


