通过OpenClaw实现副业收入：《OpenClaw赚钱实录：从“养龙虾“到可持续变现的实践指南》
概述
- 单个长期运行的Gateway拥有所有消息界面（通过 Baileys 的 WhatsApp、通过 grammY 的 Telegram、Slack、Discord、Signal、iMessage、WebChat）。
- 控制平面客户端（macOS 应用、CLI、Web UI、自动化程序）通过WebSocket连接到 Gateway，使用配置的绑定主机（默认为
127.0.0.1:18789）。 - 节点（macOS/iOS/Android/无头设备）也通过WebSocket连接，但声明
role: node并附带明确的能力/命令。 - 每个主机只有一个 Gateway；它是唯一打开 WhatsApp 会话的地方。
- 画布主机由 Gateway HTTP 服务器提供：
/__openclaw__/canvas/（可被代理编辑的 HTML/CSS/JS）/__openclaw__/a2ui/（A2UI 主机）
它使用与 Gateway 相同的端口（默认为 18789）。
组件与数据流
Gateway（守护进程）
- 维护各提供商的连接。
- 提供带类型的 WS API（请求、响应、服务器推送事件）。
- 根据 JSON Schema 验证入站帧。
- 发出诸如
agent、chat、presence、health、heartbeat、cron等事件。
客户端（Mac 应用 / CLI / Web 管理端）
- 每个客户端一条 WS 连接。
- 发送请求（
health、status、send、agent、system-presence）。 - 订阅事件（
tick、agent、presence、shutdown）。
节点（macOS / iOS / Android / 无头设备）
- 使用
role: node连接到同一个 WS 服务器。 - 在
connect中提供设备标识；配对是基于设备的（角色为node），批准信息存储在设备配对存储中。 - 公开诸如
canvas.*、camera.*、screen.record、location.get等命令。
协议细节：Gateway 协议
WebChat
- 使用 Gateway WS API 获取聊天历史并发送消息的静态 UI。
- 在远程部署中，通过与其他客户端相同的 SSH/Tailscale 隧道进行连接。
连接生命周期（单个客户端）
渲染错误:Mermaid 渲染失败: No diagram type detected matching given configuration for text: theme={"theme":{"light":"min-light","dark":"min-dark"}} sequenceDiagram participant Client participant Gateway Client->>Gateway: req:connect Gateway-->>Client: res (ok) Note right of Gateway: 或 res error + close Note left of Client: payload=hello-ok snapshot: presence + health Gateway-->>Client: event:presence Gateway-->>Client: event:tick Client->>Gateway: req:agent Gateway-->>Client: res:agent ack {runId, status:"accepted"} Gateway-->>Client: event:agent (streaming) Gateway-->>Client: res:agent final {runId, status, summary}
线路协议（摘要）
- 传输层：WebSocket，使用带 JSON 负载的文本帧。
- 第一帧必须是
connect。 - 握手完成后：
- 请求：
{type:"req", id, method, params}→{type:"res", id, ok, payload|error} - 事件：
{type:"event", event, payload, seq?, stateVersion?}
- 请求：
- 如果设置了
OPENCLAW_GATEWAY_TOKEN（或--token），则connect.params.auth.token必须匹配，否则套接字将被关闭。 - 对于有副作用的方法（
send、agent），要求使用幂等键来安全重试；服务器会维护一个短期去重缓存。 - 节点必须在
connect中包含role: "node"以及能力/命令/权限。
配对与本地信任
- 所有 WS 客户端（操作者 + 节点）在
connect时都包含一个设备标识。 - 新设备 ID 需要配对批准；Gateway 会为后续连接颁发一个设备令牌。
- 本地连接（环回或 Gateway 主机自身的 tailnet 地址）可被自动批准，以保持同主机流畅的用户体验。
- 所有连接必须对
connect.challenge随机数进行签名。 - 签名负载
v3同时绑定platform+deviceFamily；Gateway 会在重连时固定已配对的元数据，并要求在元数据变更时修复配对。 - 非本地连接仍然需要明确批准。
- Gateway 认证（
gateway.auth.*）仍然适用于所有连接，无论本地还是远程。
细节：Gateway 协议、配对、安全。
协议类型与代码生成
- TypeBox 模式定义了协议。
- JSON Schema 从这些模式生成。
- Swift 模型从 JSON Schema 生成。
远程访问
- 推荐：Tailscale 或 VPN。
- 替代方案：SSH 隧道
theme={"theme":{"light":"min-light","dark":"min-dark"}}ssh-N-L18789:127.0.0.1:18789 user@host- 相同的握手和认证令牌在隧道中同样适用。
- 在远程部署中，可以为 WS 启用 TLS 及可选的证书固定。
运维快照
- 启动：
openclaw gateway（前台运行，日志输出到 stdout）。 - 健康检查：通过 WS 的
health（也包含在hello-ok中）。 - 监管：使用 launchd/systemd 实现自动重启。
不变式
- 每个主机恰好只有一个 Gateway 控制单个 Baileys 会话。
- 握手是强制的；任何非 JSON 或非 connect 的第一帧都会导致硬关闭。
- 事件不会重放；客户端必须在出现间隙时刷新状态。
