gateway

运行 WebSocket 网关。

用法

openclaw gateway [选项]

选项

网络选项

• --port <port>: 端口（默认 18789）
• --bind <loopback|tailnet|lan|auto|custom>: 绑定模式

认证选项

• --token <token>: 网关 token
• --auth <token|password>: 认证方式
• --password <password>: 网关密码

Tailscale 选项

• --tailscale <off|serve|funnel>: Tailscale 模式
• --tailscale-reset-on-exit: 退出时重置

运行选项

• --allow-unconfigured: 允许未配置运行
• --dev: 开发模式
• --reset: 重置开发配置 + 凭据 + 会话 + 工作区
• --force: 强制启动（杀死端口上的现有监听器）
• --verbose: 详细输出

日志选项

• --claude-cli-logs: Claude CLI 日志
• --ws-log <auto|full|compact>: WebSocket 日志模式
• --compact: --ws-log compact 的别名
• --raw-stream: 原始流输出
• --raw-stream-path <path>: 原始流路径

子命令

gateway status

探测网关 RPC。

openclaw gateway status [选项]

选项：

• --no-probe: 不探测
• --deep: 深度探测
• --json: JSON 输出

gateway service

管理网关服务（launchd/systemd/schtasks）。

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

gateway probe

探测网关 RPC 可达性。

openclaw gateway probe

gateway health

获取网关健康状态。

openclaw gateway health [--json]

gateway call

调用网关 RPC 方法。

openclaw gateway call <method> [--params <json>]

常用 RPC：

• config.apply - 验证 + 写入配置 + 重启 + 唤醒
• config.patch - 合并部分更新 + 重启 + 唤醒
• update.run - 运行更新 + 重启 + 唤醒

示例

# 前台运行网关
openclaw gateway

# 指定端口
openclaw gateway --port 19000

# 使用 token 认证
openclaw gateway --token mytoken

# 强制启动（杀死现有进程）
openclaw gateway --force

# 安装为服务
openclaw gateway install

# 重启服务
openclaw gateway restart

服务管理

网关通常作为后台服务运行：

• macOS: LaunchAgent
• Linux: systemd user unit
• Windows: schtasks

安装服务：

openclaw gateway install

服务会在系统启动时自动运行。

相关命令

• logs - 查看日志
• status - 状态查看
• health - 健康检查