Gateway:路由枢纽
Gateway 是什么
Gateway 是 OpenClaw 架构中的中央路由枢纽。所有进出 Agent 的流量都经过 Gateway,它负责将来自不同 Channel 的请求统一接收、解析并分发到对应的处理模块。
你可以把 Gateway 理解为 Agent 世界的”前台”——无论请求来自 Telegram、Slack 还是 HTTP API,Gateway 都会统一处理,让后端的 Brain 和 Skills 无需关心消息的来源。
核心职责
请求路由
Gateway 根据配置规则将请求分发到正确的处理链路。一条来自 Telegram 的消息和一条来自 REST API 的调用,在经过 Gateway 之后会被标准化为统一的内部格式,再交给 Brain 处理。
LLM 调用代理
Gateway 内置了对主流 LLM 提供商的代理能力。你可以在配置中指定模型端点,Gateway 会负责请求的转发、重试和错误处理。这意味着切换模型提供商时,只需要修改 Gateway 配置,不用改动任何业务逻辑。
协议适配
不同的 Channel 使用不同的通信协议——Telegram 用 Webhook,Slack 用 Events API,Discord 有自己的 Gateway 协议。OpenClaw Gateway 将这些差异封装起来,对内部模块暴露统一的接口。
配置方式
Gateway 的配置通过 openclaw.json 完成,核心配置项包括:
- 监听地址与端口:默认绑定
127.0.0.1:18789 - 模型端点:指定 LLM 提供商的 API 地址
- Channel 注册:声明启用哪些通信通道
- 安全策略:API Key 验证、速率限制等
基本配置示例
{
"gateway": {
"host": "127.0.0.1",
"port": 18789,
"model": "anthropic/claude-sonnet-4-6"
}
}
运行模式
Gateway 推荐以守护进程方式常驻运行。在 macOS 上可以通过 launchd 管理,在 Linux 上使用 systemd。这样即使机器重启,Gateway 也会自动恢复服务。
详细的守护进程配置请参考守护进程设置。
监控与调试
Gateway 提供了基础的健康检查端点和请求日志。在开发阶段,可以通过提高日志级别来追踪请求的完整生命周期,排查路由或模型调用的问题。