前言
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 无法执行
