实践openclaw-concepts
TypeBox · OpenClaw — TypeBox 如何成为 OpenClaw 网关协议的唯一事实源,驱动校验、代码
TypeBox 如何成为 OpenClaw 网关协议的唯一事实源,驱动校验、代码生成与多端一致。
2026-08-31原文
本文为要点摘要,完整细节以原文为准。
- 单一事实源:用 TypeBox 定义网关 WS 协议,运行时校验(AJV)、JSON Schema 导出、Swift/Kotlin 代码生成全部由此驱动,避免多份手写定义漂移。
- 生成物检查:
protocol:gen不比对 gitignored 的 JSON Schema,而是断言发布契约(帧定义、顺序、判别映射),防止生成结果悄悄偏离。 - 端到端示例:新增
system.echo方法时,先加 schema,再注册到 fragment,最后导出 validator;强调保持注册顺序,因为原生代码生成依赖插入顺序。