openclawapp 中文文档 下载 App

网关与节点如何分工:一套自托管架构的工作原理

OpenClaw 的一切都围绕一个概念:Gateway 网关是常驻的控制平面,助手本身才是产品。理解这一点,很多使用问题会迎刃而解。

三个角色

角色跑在哪职责
Gateway 网关电脑:macOS、Linux,或 Windows(原生 Hub 或 WSL2)调用模型、执行工具、管理会话与记忆、连接各聊天渠道,默认监听 18789 端口
节点应用手机、手表等设备聊天入口与设备能力提供方:语音、相机、定位、屏幕、通知,按授权开放
Control UI浏览器网页仪表板:看状态、管会话、批审批、改设置

安卓应用不托管网关——它是纯粹的配套节点。没有一台跑着网关的电脑,手机就没有东西可连,这一点是新手最常见的误区。

一条消息的完整旅程

  1. 你在 Telegram(或手机 App)里发一句「帮我把这周的照片整理进相册」。
  2. 渠道插件把消息送进网关,网关按会话路由找到对应智能体。
  3. 智能体带着长期记忆和技能说明调用模型,模型决定要用哪些工具。
  4. 网关执行工具:读文件、跑命令、控浏览器,必要时向你的手机推送审批请求。
  5. 结果写回会话,并投递到你发消息的那个聊天窗口。

为什么这样设计

手机端的连接方式

安卓节点通过 mDNS/NSD 设备发现或手动指定地址,直连网关的 WebSocket(role: node 配对)。局域网内可用明文 ws://,跨网访问(Tailscale、公网)则要求 wss:// 加密端点;用明文连接时会自动降级为受限操作员权限。首次配对要在网关侧批准,之后 App 开机自动重连。细节见手机配对。

下一步:看看手机端与电脑端各有哪些版本形态。