想象一下:你正在出差,突然需要通过手机调用家里电脑上的 Claude Code 处理工作。当你兴冲冲打开手机 App,却发现——连不上。
这不是网络问题,而是「网络可达性」的锅。要么得在同一 Wi-Fi 下,要么得自己搭建 Tailscale。对于大多数用户来说,这两个选项都太折腾了。
现在,OpenCLAW 给出了一个更简单的答案:Cloud Relay(云中继)。
它解决了什么问题?
在 Cloud Relay 之前,移动设备想连接 Gateway,只有两条路:
- •同一局域网
— 手机和电脑必须在同一个 Wi-Fi 下
- •Tailscale
— 需要在两台设备上分别安装、配置、连接
问题在于,不是每个用户都懂网络配置。Tailscale 虽然好用,但它对普通用户来说门槛太高了。更更何况,当你不在同一个网络下时,以上两条路都会失效。
Cloud Relay 的出现,直接打破了这一困境。它让移动设备可以通过云端中继远程连接 Gateway,无需 Tailscale,无需同一网络,真正做到「随时随地」连接。
Cloud Relay 三大核心功能
1. openclaw login — 扫码登录
一行命令搞定 OAuth 认证:
$ openclaw login
→ 浏览器弹出 OAuth 登录页面
→ 登录成功后显示 "Logged in as user@example.com"
→ 令牌自动存储到本地 (~/.openclaw/cloud-auth.json)
支持任意 OAuth2 提供商(通过
cloud.auth.provider、cloud.auth.domain、cloud.auth.clientId配置),令牌会自动刷新,无需手动管理。
2. Gateway 注册 + 心跳保活
Gateway 启动后(如果已认证),会自动:
- •向云端注册:
POST /api/v1/gateways/register
- •定时心跳:每 30 秒发送一次
POST /api/v1/gateways/heartbeat
手机 App 可以随时查看所有已登录 Gateway 的在线状态——超过 60 秒没收到心跳就算离线。
3. WebSocket 透传
这是最关键的部分。Gateway 会建立一个 WebSocket 连接到云端中继服务器。手机客户端同样连接到中继服务器,服务器负责在两端之间转发消息。Gateway 无需改动任何协议,中继完全是透明传输。
配置示例
# gateway.yaml
cloud:
enabled: true# 默认关闭,按需启用
apiUrl: "https://your-relay-backend.example.com"
relayUrl: "wss://your-relay-backend.example.com"
auth:
provider: "kinde"# OAuth 提供商
domain: ""
clientId: ""
heartbeat:
interval: 30000 # 心跳间隔(毫秒)
relay:
enabled: true
reconnectDelay: 5000 # 重连延迟
它改变了什么?
以前,你需要:
- •安装配置 Tailscale
- •处在同一网络环境
- •手动输入 IP 地址和端口
现在,你只需要:
- •在 Gateway 上启用 Cloud Relay
- •用
openclaw login登录账号
- •手机打开 App,就能看到所有在线的 Gateway
这就是所谓的「即插即用」体验。


加猪大叔微信(356216540),可免费领取价值千元的【AI 内部学习资料】。想快速上手学习 AI,这份资料绝对有用!(领资料备注:资料)
如果喜欢猪大叔的内容,记得点个「赞」和「在看」或者「转发」给需要的朋友哦~ 
夜雨聆风