惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

Microsoft Azure Blog
Microsoft Azure Blog
aimingoo的专栏
aimingoo的专栏
F
Fortinet All Blogs
Blog — PlanetScale
Blog — PlanetScale
GbyAI
GbyAI
MongoDB | Blog
MongoDB | Blog
月光博客
月光博客
The Cloudflare Blog
量子位
T
Tailwind CSS Blog
Cyber Security Advisories - MS-ISAC
Cyber Security Advisories - MS-ISAC
B
Blog
MyScale Blog
MyScale Blog
T
The Blog of Author Tim Ferriss
The GitHub Blog
The GitHub Blog
G
Google Developers Blog
D
DataBreaches.Net
V
Visual Studio Blog
奇客Solidot–传递最新科技情报
奇客Solidot–传递最新科技情报
Last Week in AI
Last Week in AI
U
Unit 42
博客园 - 聂微东
有赞技术团队
有赞技术团队
A
About on SuperTechFans

Recent Commits to openclaw:main

test: merge chat side-result checks · openclaw/openclaw@ddd2c2a test: merge cron history checks · openclaw/openclaw@f7eb746 test: merge responsive navigation shell checks · openclaw/openclaw@c2e4b47 docs(changelog): add codex oauth fixes · openclaw/openclaw@628e6cd test: merge navigation routing cases · openclaw/openclaw@5d8cecb Tests: mock channel registry bundled fallback · openclaw/openclaw@2b08233 Secrets: avoid broad web search discovery for single plugin config · openclaw/openclaw@a464f59 test: merge config view browser checks · openclaw/openclaw@20cf511 fix(status): align oauth health with runtime · openclaw/openclaw@eed7116 feat: add macOS screen snapshots for monitor preview (#67954) thanks … · openclaw/openclaw@f377db1 fix: report shared auth scopes in hello-ok (#67810) thanks @BunsDev · openclaw/openclaw@0b6c39b Auto-reply: avoid eager bundled route fallback · openclaw/openclaw@3ea1bf4 Tests: narrow session binding contract setup · openclaw/openclaw@54e4e16 fix(macOS): enable undo/redo in webchat composer text input (#34962) · openclaw/openclaw@00951dc Tests: speed up channel setup promotion · openclaw/openclaw@82b529a Docs: refresh agent instructions · openclaw/openclaw@5775fe2 fix(auth): serialize OAuth refresh across agents to fix #26322 (#67876) · openclaw/openclaw@8e79080 test: allow ollama public surface boundary test · openclaw/openclaw@7d4f1a6 Docs: add test performance guardrails · openclaw/openclaw@89706d3 Tests: restore context-engine usage proof · openclaw/openclaw@e4c4f95 Tests: slim context engine runtime coverage · openclaw/openclaw@74c198f ci: retry failed custom checkouts · openclaw/openclaw@0ee5baf test: trim duplicate provider auth onboarding cases · openclaw/openclaw@1ffc02e matrix: fix sessions_spawn --thread subagent session spawning (#67643) · openclaw/openclaw@1ce2596 test: reduce auth choice fixture churn · openclaw/openclaw@857b9cd test: mock health status config boundaries · openclaw/openclaw@9d5ab4a test: mock onboard config io boundary · openclaw/openclaw@299694d test: mock legacy state plugin boundaries · openclaw/openclaw@2713089 test: mock channel install boundaries · openclaw/openclaw@b945248 test: mock doctor preview channel boundaries · openclaw/openclaw@b1a3ad4
docs: tighten architecture, btw, agent-send hygiene · ope...
vincentkoc · 2026-05-06 · via Recent Commits to openclaw:main

@@ -7,7 +7,7 @@ title: "Gateway architecture"

7788

## Overview

9910-

- A single longlived **Gateway** owns all messaging surfaces (WhatsApp via

10+

- A single long-lived **Gateway** owns all messaging surfaces (WhatsApp via

1111

Baileys, Telegram via grammY, Slack, Discord, Signal, iMessage, WebChat).

1212

- Control-plane clients (macOS app, CLI, web UI, automations) connect to the

1313

Gateway over **WebSocket** on the configured bind host (default

@@ -25,7 +25,7 @@ title: "Gateway architecture"

2525

### Gateway (daemon)

26262727

- Maintains provider connections.

28-

- Exposes a typed WS API (requests, responses, serverpush events).

28+

- Exposes a typed WS API (requests, responses, server-push events).

2929

- Validates inbound frames against JSON Schema.

3030

- Emits events like `agent`, `chat`, `presence`, `health`, `heartbeat`, `cron`.

3131

@@ -38,7 +38,7 @@ title: "Gateway architecture"

3838

### Nodes (macOS / iOS / Android / headless)

39394040

- Connect to the **same WS server** with `role: node`.

41-

- Provide a device identity in `connect`; pairing is **devicebased** (role `node`) and

41+

- Provide a device identity in `connect`; pairing is **device-based** (role `node`) and

4242

approval lives in the device pairing store.

4343

- Expose commands like `canvas.*`, `camera.*`, `screen.record`, `location.get`.

4444

@@ -90,8 +90,8 @@ sequenceDiagram

9090

instead of `connect.params.auth.*`.

9191

- Private-ingress `gateway.auth.mode: "none"` disables shared-secret auth

9292

entirely; keep that mode off public/untrusted ingress.

93-

- Idempotency keys are required for sideeffecting methods (`send`, `agent`) to

94-

safely retry; the server keeps a shortlived dedupe cache.

93+

- Idempotency keys are required for side-effecting methods (`send`, `agent`) to

94+

safely retry; the server keeps a short-lived dedupe cache.

9595

- Nodes must include `role: "node"` plus caps/commands/permissions in `connect`.

96969797

## Pairing + local trust

@@ -109,7 +109,7 @@ sequenceDiagram

109109

- Signature payload `v3` also binds `platform` + `deviceFamily`; the gateway

110110

pins paired metadata on reconnect and requires repair pairing for metadata

111111

changes.

112-

- **Nonlocal** connects still require explicit approval.

112+

- **Non-local** connects still require explicit approval.

113113

- Gateway auth (`gateway.auth.*`) still applies to **all** connections, local or

114114

remote.

115115

@@ -138,12 +138,12 @@ Details: [Gateway protocol](/gateway/protocol), [Pairing](/channels/pairing),

138138139139

- Start: `openclaw gateway` (foreground, logs to stdout).

140140

- Health: `health` over WS (also included in `hello-ok`).

141-

- Supervision: launchd/systemd for autorestart.

141+

- Supervision: launchd/systemd for auto-restart.

142142143143

## Invariants

144144145145

- Exactly one Gateway controls a single Baileys session per host.

146-

- Handshake is mandatory; any nonJSON or nonconnect first frame is a hard close.

146+

- Handshake is mandatory; any non-JSON or non-connect first frame is a hard close.

147147

- Events are not replayed; clients must refresh on gaps.

148148149149

## Related