实践openclaw-concepts
TypeBox · OpenClaw — TypeBox 如何成为 OpenClaw 网关协议的唯一事实源，驱动校验、代码
TypeBox 如何成为 OpenClaw 网关协议的唯一事实源，驱动校验、代码生成与多端一致。
2026-08-31原文
本文为要点摘要，完整细节以原文为准。
🧭 一图看懂
由原文自动提炼 · 以原文为准点击任一分支，查看这一点的一句话解读
TypeBox 驱动 OpenClaw 网关协议
TypeBox schema 定义网关 WS 协议，其余产物全部生成
- 驱动运行时校验、JSON Schema 导出、Swift 代…
- schema 变更需同步提交生成模型
⚙️ 流程拆解
STEP 1定义 TypeBox schema
STEP 2注册进生成器
STEP 3运行 pnpm protocol:gen
STEP 4生成 Swift/Kotlin 模型
STEP 5protocol:check 校验
STEP 6提交 schema 与模型
🔗 涉及的概念与玩家
- TypeBox产品
- OpenClaw产品
- Gateway WebSocket概念
- TypeBox Compile方法
- JSON Schema概念
- GatewayModels.swift产品
- ConnectParams概念
- TypeBox—定义协议→OpenClaw
- TypeBox—驱动校验→Gateway WebSocket
- TypeBox Compile—运行时校验→Gateway WebSocket
- TypeBox—导出→JSON Schema
- TypeBox—生成→GatewayModels.swift
- ConnectParams—约束握手→Gateway WebSocket
- 单一事实源：用 TypeBox 定义网关 WS 协议，运行时校验（AJV）、JSON Schema 导出、Swift/Kotlin 代码生成全部由此驱动，避免多份手写定义漂移。
- 生成物检查：
protocol:gen不比对 gitignored 的 JSON Schema，而是断言发布契约（帧定义、顺序、判别映射），防止生成结果悄悄偏离。 - 端到端示例：新增
system.echo方法时，先加 schema，再注册到 fragment，最后导出 validator；强调保持注册顺序，因为原生代码生成依赖插入顺序。
🕸 顺着图谱继续读
- Gateway architecture · OpenClaw — 一个网关管理所有消息面，客户端与节点分离，协议严格类型化。2026-06-29 · 共同涉及 OpenClaw、TypeBox
- claude-code v2.1.260 — diff 面板、缓存诊断、权限修复，agent 开发必读2026-09-03 · 共同涉及 JSON Schema
- claude-code v2.1.187 — 沙箱凭据隔离、结构化输出修复、远程会话加速2026-06-23 · 共同涉及 JSON Schema
- OpenClaw Completes Security Audit Through OpenAI’s — OpenClaw 借 OpenAI 计划完成 Trail of Bits 安全审2026-09-21 · 共同涉及 OpenClaw