0 前言：为什么你必须懂 OpenClaw 原理？
网上 99% 的 OpenClaw 教程都在教你：复制粘贴命令 → 启动 → 聊天。但一旦遇到：
- 突然卡死
- 命令执行失败
- 模型不返回
- 内存暴涨
- 权限异常
- 网关无法访问
你只会一头雾水，只能重装、重启、反复试错。
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 网关层：OpenClaw 的 '心脏'
这是最核心、最容易报错、但绝大多数人完全不懂的一层。
Gateway 干三件事：
- 启动 HTTP 服务（提供 18789 端口）
- 鉴权与安全控制
- 转发请求给 Core 调度层
它是：
- 前端 ↔ 后端 的桥梁
- 外部访问 ↔ 本地执行 的门卫
- 多会话管理、日志记录、进程守护
为什么 Gateway 一挂，OpenClaw 直接废？因为所有请求必须经过它，它是唯一入口。
3.3 Core 调度层：OpenClaw 的 '大脑'
这是 OpenClaw 真正的AI 智能核心。
你输入一句话，它会做：
