Files
bot/docs/zh-CN/gateway/network-model.md
zooqueen 071e3f1082 rebrand: openclaw -> hanzo bot across entire codebase
Automated rebrand of all openclaw references to hanzo bot:
- Package: openclaw -> @hanzo/bot
- Binary: openclaw -> hanzo-bot
- Config: ~/.openclaw -> ~/.hanzo/bot
- Docker: ghcr.io/hanzoai/bot
- Env vars: OPENCLAW_* -> BOT_*
- Bundle IDs: ai.hanzo.bot.*
- Product name: Hanzo Bot
2026-03-19 13:52:32 -07:00

1.6 KiB
Raw Permalink Blame History

read_when, summary, title, x-i18n
read_when summary title x-i18n
你想要简要了解 Gateway 网关的网络模型
Gateway 网关、节点和 canvas 主机如何连接。 网络模型
generated_at model provider source_hash source_path workflow
2026-02-04T17:53:21Z claude-opus-4-5 pi e3508b884757ef19f425c82e891e2b07e7fd7d985413d569e55ae9b175c91f0f gateway/network-model.md 15

大多数操作通过 Gateway 网关(hanzo-bot gateway)进行,它是一个长期运行的单一进程,负责管理渠道连接和 WebSocket 控制平面。

核心规则

  • 建议每台主机运行一个 Gateway 网关。它是唯一允许拥有 WhatsApp Web 会话的进程。对于救援机器人或严格隔离的场景,可以使用隔离的配置文件和端口运行多个 Gateway 网关。参见多 Gateway 网关。
  • 优先使用回环地址:Gateway 网关的 WS 默认为 ws://127.0.0.1:18789。即使是回环连接,向导也会默认生成 gateway token。若需通过 tailnet 访问,请运行 hanzo-bot gateway --bind tailnet --token ...,因为非回环绑定必须使用 token。
  • 节点根据需要通过局域网、tailnet 或 SSH 连接到 Gateway 网关的 WS。旧版 TCP 桥接已弃用。
  • Canvas 主机是一个 HTTP 文件服务器,运行在 canvasHost.port(默认 18793)上,提供 /__openclaw__/canvas/ 路径供节点 WebView 使用。参见 Gateway 网关配置(canvasHost)。
  • 远程使用通常通过 SSH 隧道或 Tailscale VPN。参见远程访问和设备发现。