4.26 gateway命令

openclaw gateway 命令用于管理 OpenClaw 的 WebSocket 网关服务器，负责处理频道、节点、会话和钩子。

核心功能

Gateway 是 OpenClaw 的 WebSocket 服务器，管理频道、节点、会话和钩子。所有命令都在 openclaw gateway ... 命名空间下运行。

运行网关

基本命令：

openclaw gateway

主要要求包括在配置中设置 gateway.mode=local，除非使用 --allow-unconfigured 进行开发。作为安全措施，系统会阻止未经身份验证的非回环绑定。

主要选项

选项	说明
--port	指定 WebSocket 端口（默认 18789）
--bind	选择监听模式（loopback、lan、tailnet、auto、custom）
--auth	覆盖身份验证方法
--tailscale	通过 Tailscale 暴露服务（off/serve/funnel）
--dev	自动创建开发配置
--verbose	启用详细日志
--ws-log	配置 WebSocket 日志样式

查询命令

健康检查

openclaw gateway health --url ws://127.0.0.1:18789

状态监控

openclaw gateway status [--json] [--deep]

综合诊断

openclaw gateway probe [--ssh user@host]

底层 RPC 调用

openclaw gateway call <method>

服务管理

# 安装服务
openclaw gateway install

# 启动/停止/重启/卸载服务
openclaw gateway start
openclaw gateway stop
openclaw gateway restart
openclaw gateway uninstall

发现功能

gateway discover 命令使用组播 DNS-SD 扫描 Gateway 信标，返回 WebSocket URL 和服务元数据，包括端口、TLS 状态和 SSH 可用性。

openclaw gateway discover