Files
openclaw-skill/openclaw-knowhow-skill/docs/infrastructure/gateway/bridge-protocol.md
Selig 4c966a3ad2 Initial commit: OpenClaw Skill Collection
6 custom skills (assign-task, dispatch-webhook, daily-briefing,
task-capture, qmd-brain, tts-voice) with technical documentation.
Compatible with Claude Code, OpenClaw, Codex CLI, and OpenCode.
2026-03-13 10:58:30 +08:00

1.3 KiB

Bridge Protocol (Legacy)

Overview

The Bridge Protocol represents a legacy node transport mechanism utilizing TCP JSONL communication. New node clients should use the unified Gateway WebSocket protocol instead.

Key Characteristics

Transport Details

  • TCP-based with one JSON object per line (JSONL format)
  • Optional TLS encryption when enabled
  • Legacy default port: 18790
  • Certificate pinning available via discovery TXT records

Security Features

The protocol maintains distinct advantages including a small allowlist instead of the full gateway API surface and node admission controlled through per-node tokens tied to gateway management.

Technical Components

Handshake Sequence

The pairing process involves the client sending metadata with an optional token, followed by gateway validation, pair-request submission, and approval confirmation returning server identity information.

Frame Types

  • Client-to-gateway: RPC requests, node signals, event emissions
  • Gateway-to-client: node commands, session updates, keepalive signals

Exec Lifecycle

Nodes can emit completion or denial events with optional metadata including session identifiers, command details, and exit information.

Current Status

Current OpenClaw builds no longer ship the TCP bridge listener; this document is kept for historical reference.