网关
网关是 OpenClaw 的 WebSocket 服务器,拥有通道连接和控制平面。
概述
大多数操作都通过 网关 (openclaw gateway) 流动,这是一个单一的长运行进程:
- 拥有 WhatsApp Web、Telegram Bot、Discord Bot 和 iMessage 会话
- 为智能体、CLI 和 UI 暴露 WebSocket 控制平面
- 管理会话、配置和节点连接
快速开始
运行网关:
bash
openclaw gateway网关默认使用 ws://127.0.0.1:18789(仅本地回环,安全考虑)。
服务管理
安装为系统服务(launchd/systemd):
bash
openclaw gateway install
openclaw gateway start
openclaw gateway stop
openclaw gateway restart
openclaw gateway status选项
| 选项 | 描述 |
|---|---|
--port <port> | WebSocket 端口(默认:18789) |
--bind <mode> | 绑定模式:loopback、lan、tailnet、auto、custom |
--auth <mode> | 认证模式:token、password |
--token <token> | 网关令牌覆盖 |
--password <password> | 网关密码覆盖 |
--tailscale <mode> | Tailscale:off、serve、funnel |
--allow-unconfigured | 允许在无 gateway.mode=local 的情况下启动 |
--dev | 如果缺少则创建开发配置和工作区 |
--verbose | 详细日志 |
--ws-log <style> | WebSocket 日志样式:auto、full、compact |
远程访问
要远程访问,请使用:
网关协议
请参阅 网关协议 了解 WebSocket RPC 文档。