OpenClaw Gateway
用一个比喻来理解
把 Gateway 想象成一个 超级秘书/前台：
┌─────────────────────────────────────────────────────────┐
│ │
│ 📱 WhatsApp 💬 Telegram 📧 Slack 🎮 Discord │
│ │ │ │ │
│ └───────────────┬─────┴───────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────┐ │
│ │ 🧑•💼 Gateway │ │
│ │ (超级秘书) │ │
│ └────────┬────────┘ │
│ │ │
│ ┌─────────────┼─────────────┐ │
│ ▼ ▼ ▼ │
│ 👨•💻 你 📱 手机 App 🤖 自动程序 │
│ (老板) (助手) (员工) │
└─────────────────────────────────────────────────────────┘
核心概念
1️⃣ Gateway 网关 = 超级秘书
它是干嘛的？
- 帮你同时管理所有聊天软件（微信、Telegram、Slack 等）
- 所有消息都经过它，它帮你转发、记录、处理
- 一台电脑只能有一个这样的秘书（不然会乱）
类比：就像公司前台，所有电话都打到前台，前台再转接给相应的人。
2️⃣ 客户端 = 老板/管理者
是什么？
- 你的 Mac 应用、命令行工具、网页界面
- 用来发号施令的
能做什么？
send "现在什么状态？" → status
"让 AI 帮我回复" → agent
"你还活着吗？" → health
3️⃣ 节点 = 能干活的设备
是什么？
- 你的手机、平板、智能设备
- 有特殊能力的设备
能提供什么？
camera.capture → 📸 拍照
location.get → 📍 位置
screen.record → 🖥️ 录屏
canvas.render → 🎨 显示界面
区别：
| 客户端 | 节点 | |
|---|---|---|
| 角色 | 发命令的人 | 干活的设备 |
| 比喻 | 老板 | 员工/工具 |
| 连接时 | 不用特别声明 | 要说 role: "node" |
通信方式（打电话比喻）
WebSocket 是什么？
普通网页请求 = 寄信 📮
- 你寄一封，等回信，再寄一封...
- 慢，断断续续
WebSocket = 打电话 📞
- 接通后一直保持连线
- 双方随时可以说话
- 又快又实时
对话流程
你（客户端） 秘书（Gateway） │ │ │── "喂，我是张总" ─────────────▶│ ← 第一句话必须自报家门！ │ │ │◀── "您好张总，这是今天的情况" │ ← 返回当前状态 │ │ │◀── "李经理刚上线了" ──────────│ ← 主动通知你 │◀── "滴...滴..." ─────────────│ ← 定时心跳，表示还在线 │ │ │── "帮我给王总发条消息" ──────▶│ ← 你下命令 │◀── "好的，已发送" ───────────│ ← 返回结果 │ │
安全机制（门禁比喻）
两道关卡
1️⃣ 密码验证（Token）
你：敲门 保安：密码？ 你：openclaw123 保安：✅ 进来吧 / ❌ 滚
- 如果设置了
OPENCLAW_GATEWAY_TOKEN，连接时必须提供正确的密码
2️⃣ 设备配对（首次访问）
新手机第一次连接： 网关：你是谁？ 手机：我是张三的 iPhone 网关：等一下，我问问张三... 张三确认了吗？ 张三：确认，是我的手机 网关：好，给你一张通行证，以后直接进
本地 vs 远程
| 场景 | 验证严格度 |
|---|---|
| 同一台电脑 | 宽松，自动放行 |
| 远程访问 | 严格，要签名确认 |
远程访问（不在家怎么办）
方法一：VPN / Tailscale（推荐）
就像给家里拉了一条专线， 在外面也像在家一样直接访问
方法二：SSH 隧道
ssh -N -L 18789:127.0.0.1:18789 user@你家电脑
# 意思是：
# 把远程电脑的 18789 端口"搬"到本地
# 然后本地访问 127.0.0.1:18789 就等于访问远程
必须记住的规矩
🚨 四条铁律
| 规矩 | 大白话 |
|---|---|
| 一台机器一个 Gateway | 不能同时开两个，会打架 |
| 第一句话必须自报家门 | 连接后第一条消息必须是 connect，否则直接挂电话 |
| 错过的消息不会重发 | 断线重连后，中间漏掉的消息没了，要自己刷新 |
| 重要操作要带"单号" | 发消息时带个唯一 ID，防止网络抖动导致重复发送 |
总结一句话
Gateway 就是一个 24 小时在线的智能秘书，帮你统一管理所有聊天软件，你通过 WebSocket（电话）随时给它下命令。