原创

Gateway、CLI、Bridge、Workspace 全部讲透

paste-image-1779456080622.png

上一篇文章我们讲了:

OpenClaw 为什么不是一个普通 AI Agent。

很多人看完以后会继续问:

OpenClaw 里面的 Gateway、CLI、Bridge、Workspace 到底是什么?

第一次接触 OpenClaw 的时候,这几个词确实容易把人绕晕。

有人把 Gateway 当成一个端口。

有人把 CLI 当成 OpenClaw 本体。

有人觉得 Bridge 就是网络连接。

还有人认为 Workspace 只是一个文件夹。

实际上,这四个组件构成了 OpenClaw 最核心的运行体系。

如果说大模型是“大脑”,那么:

Gateway 是调度中心,CLI 是管理后台,Bridge 是连接层,Workspace 是工作区。

理解这四个组件,你基本就理解了 OpenClaw 为什么能从“聊天机器人”变成“持续执行任务的 AI Worker”。


一、Gateway:OpenClaw 的中央调度中心

Gateway 可以理解成:

所有任务进入 OpenClaw 的入口。

无论消息来自哪里:

  • Dashboard

  • Telegram

  • 企业微信

  • Slack

  • Discord

  • WhatsApp

  • API 调用

最终都会进入 Gateway。

它负责做什么?

第一步:

接收消息。

第二步:

识别来源渠道。

第三步:

决定交给哪个 Agent。

第四步:

加载权限和配置。

第五步:

把任务发送给运行系统。

最后:

返回执行结果。

整体流程类似:

用户
 ↓
Telegram / Dashboard / 企业微信
 ↓
Gateway
 ↓
Agent Runtime
 ↓
Browser / Shell / Tool
 ↓
模型
 ↓
结果返回

很多人部署 OpenClaw 时会看到:

18789

这个端口通常就是 Gateway 对外工作的入口。

如果 Gateway 没起来:

Dashboard 打不开。

消息进不来。

插件无法调用。

Agent 不会执行。

整个系统几乎等于停机。

所以以后遇到问题,先别急着怀疑模型。

第一件事:

先检查 Gateway。


二、CLI:OpenClaw 的管理员控制台

CLI 就是:

Command Line Interface(命令行工具)

OpenClaw 大部分管理动作,其实都通过 CLI 完成。

例如:

openclaw onboard
openclaw configure
openclaw dashboard
openclaw agents add
openclaw agents list
openclaw gateway

很多新手第一次安装完,只打开 Dashboard。

然后觉得:

“好像没什么功能。”

实际上 Dashboard 更像操作界面。

真正的系统管理在 CLI。

例如:

初始化:

openclaw onboard

配置模型:

openclaw configure

查看 Agent:

openclaw agents list

启动服务:

openclaw gateway

CLI 可以完成:

  • 初始化系统

  • 添加 Agent

  • 修改模型

  • 查看日志

  • 启动服务

  • 管理配置

  • 调试问题

可以把它理解成:

Dashboard = 前台

CLI = 后台控制台

如果 Gateway 是公司前台。

CLI 就像管理员办公室。

真正会玩 OpenClaw 的人,大部分时间其实都待在 CLI。


三、Bridge:把所有系统连接起来

Bridge 是很多人最容易忽略的部分。

因为它平时“不显眼”。

但实际上:

没有 Bridge,OpenClaw 什么都连不上。

想象一下:

用户在 Telegram 发送:

帮我检查这个网站 SEO

这时候会发生什么?

Telegram 不会分析网页。

模型不会打开浏览器。

浏览器不会回消息。

这些系统彼此并不认识。

于是 Bridge 出场。

流程变成:

Telegram
 ↓
Bridge
 ↓
Gateway
 ↓
Agent Runtime
 ↓
Browser
 ↓
模型
 ↓
结果
 ↓
Telegram

Bridge 做的事情包括:

连接聊天平台:

  • Telegram

  • Slack

  • 企业微信

  • Discord

连接模型:

  • Claude

  • OpenAI

  • Gemini

  • MiniMax

  • Qwen

连接工具:

  • Browser

  • Shell

  • Canvas

  • Filesystem

连接插件:

  • MCP

  • Skills

  • 企业系统

Bridge 最大价值就是:

把完全不同的系统变成一个统一工作流。

以前:

聊天归聊天。

浏览器归浏览器。

命令归命令。

模型归模型。

现在:

全部连接。

统一执行。

这才有了 Agent 自动化。


四、Workspace:Agent 的办公桌

如果说 Gateway 是入口。

CLI 是控制台。

Bridge 是连接器。

那么 Workspace 就是:

Agent 的办公桌。

普通 AI 最大的问题是什么?

任务做完就失忆。

例如:

你让 ChatGPT 写文章。

输出完:

结束。

你让它写代码。

输出完:

结束。

下一次继续。

上下文没了。

文件没了。

过程没了。

OpenClaw 不一样。

它会保留工作空间。

例如:

workspace/
├── project-a
│   ├── docs
│   ├── code
│   ├── screenshots
│   └── logs
│
├── project-b
│   ├── reports
│   └── outputs

这里可以保存:

文章:

docs/

代码:

code/

截图:

screenshots/

日志:

logs/

分析结果:

reports/

缓存:

cache/

假设你让 Agent 做 SEO 检查。

普通 AI:

标题太短
缺少描述
图片没有 alt

结束。

OpenClaw:

打开网站
抓取页面
生成截图
分析内容
输出报告
保存结果
等待下一轮优化

任务结束后。

所有过程还在。

下次继续。

这就是 Workspace 最大价值。

它让 Agent 拥有了:

持续工作能力。


五、四个组件是如何协同工作的?

现在把它们放一起。

整个 OpenClaw 流程其实很清晰:

第一步:

CLI 初始化。

配置模型
配置 Gateway
配置 Channels
配置 Workspace

第二步:

Gateway 启动。

开始接收任务。

第三步:

Bridge 接管连接。

把平台、工具、模型打通。

第四步:

Agent 执行。

调用:

Browser
Shell
Filesystem
Plugins

第五步:

Workspace 保存过程。

包括:

  • 文件

  • 日志

  • 截图

  • 报告

  • 缓存

最后:

Gateway 返回结果。

完整流程:

CLI 初始化
     ↓
Gateway 启动
     ↓
Bridge 打通系统
     ↓
用户发送任务
     ↓
Agent 执行
     ↓
Workspace 保存结果
     ↓
Gateway 返回

你会发现。

OpenClaw 关注的已经不是:

怎么回答问题?

而是:

怎么接任务?

怎么调度?

怎么调用工具?

怎么保存过程?

怎么长期运行?

怎么恢复任务?

怎么返回结果?

这就是它和普通聊天机器人最大的区别。


六、新手最容易搞错的地方

很多人刚部署 OpenClaw 时都会混。

错误理解:

CLI = OpenClaw

实际上:

CLI 只是管理入口。

错误理解:

Gateway = 端口

实际上:

Gateway 是调度中心。

错误理解:

Bridge = 网络连接

实际上:

Bridge 是适配层。

错误理解:

Workspace = 文件夹

实际上:

Workspace 是长期上下文系统。

以后排查问题时,可以直接定位:

Dashboard 打不开:

查 Gateway。

命令没效果:

查 CLI。

消息没回来:

查 Bridge。

文件没保存:

查 Workspace。

模型失败:

再查 Provider。

这样排错效率会高很多。


七、总结

OpenClaw 真正厉害的地方,不是模型。

也不是聊天能力。

而是这套执行架构。

Gateway
负责接收与调度任务

CLI
负责管理与配置系统

Bridge
负责连接平台、模型和工具

Workspace
负责保存上下文和执行结果

四者协同之后。

OpenClaw 才从:

问答机器人

进化成:

持续执行任务的 AI Worker

如果上一篇讲的是:

OpenClaw 为什么不是普通 AI Agent。

那么这一篇讲的就是:

OpenClaw 到底是怎么运转起来的。

下一篇我们继续:
OpenClaw 部署实战:Docker、端口、配置文件、Dashboard 全流程。
正文到此结束
Loading...