10. Gateway：常驻控制平面怎么工作

这篇解决什么问题

OpenClaw 的 Gateway 是常驻控制平面。

它不是模型，也不是某个平台 bot。它负责把外部消息、CLI 请求、本地节点和 Agent Runtime 串起来。

Gateway 解决什么

可以先理解成：

接收消息
识别 channel/account/sender
处理 pairing 和 allowlist
找到目标 agent/session
调用 Agent Runtime
把结果投递回原渠道或目标渠道
维护状态和日志

所以 Gateway 是“入口和路由层”。

相关目录

src/gateway/
src/cli/gateway-cli/
src/commands/gateway-status/
src/daemon/
src/channels/
src/pairing/

CLI 里 openclaw gateway status 这类命令，会走 gateway 相关命令和状态检查。

daemon 模式和前台模式

推荐安装方式：

openclaw onboard --install-daemon

这会把 Gateway 作为常驻服务安装。

调试时可以前台跑：

openclaw gateway stop
openclaw gateway --port 18789 --verbose

前台模式适合看日志、定位 channel 和 provider 问题。

Gateway 不应该承担什么

Gateway 不应该实现具体 Agent 推理逻辑。

如果你看到模型、tool、session 细节，通常已经进入 src/agents/。

如果你看到 Telegram、Feishu、Slack 这些平台细节，通常进入 src/channels/ 或 extensions/。

Gateway 的核心是调度和路由。

常见问题定位

Gateway 没运行

openclaw gateway status

消息进不来

看 channel 凭证、webhook、allowlist、pairing。

消息进来了但 Agent 不回

看 runtime、provider、auth profile、tool policy。

Agent 有结果但没投递

看 delivery、channel 发送权限、平台限制。

下一篇看什么

下一篇看 Channels。