OpenClaw.NET 兼容性目录指南（Compatibility Catalog）
💡
原文中文，约6500字，阅读约需16分钟。
📝
内容提要
本文介绍了 OpenClaw.NET 的 compat/public-smoke.json 文件，该文件是兼容性验证的核心清单，管理已知插件和技能的预期行为。它支持自动化烟雾测试，并提供 CLI 和 REST API 查询，以确保插件和技能的兼容性。文件结构包括版本号和条目数组，条目分为通用字段、技能专用字段和插件专用字段。文中还详细说明了如何添加新条目、贡献流程及故障排查方法。
🎯
关键要点
- compat/public-smoke.json 是 OpenClaw.NET 兼容性验证的核心清单文件，管理已知插件和技能的预期行为。
- 该文件支持自动化烟雾测试，并通过 CLI 和 REST API 提供查询功能。
- 文件结构包括版本号和条目数组，条目分为通用字段、技能专用字段和插件专用字段。
- 条目字段必须包含必要信息，如插件的 expectedStatus、spec、packageName 和 pluginId。
- OpenClaw.NET 定义了五种场景分类，覆盖从纯技能到负面用例的所有典型场景。
- CLI 和 REST API 提供多种查询方式，支持按状态、类型和分类过滤。
- 自动化测试通过环境变量控制，确保兼容性验证的有效性。
- 贡献新条目需要遵循特定流程，确保必填字段完整，并在清单末尾追加条目。
- 故障排查部分提供了常见错误及其解决方案，帮助用户快速定位问题。
❓
延伸问答
OpenClaw.NET 的 compat/public-smoke.json 文件有什么作用？
该文件是兼容性验证的核心清单，管理已知插件和技能的预期行为，并支持自动化烟雾测试。
如何在 OpenClaw.NET 中添加新的插件条目？
需要在 compat/public-smoke.json 的 entries 数组末尾追加条目，并确保必填字段完整。
OpenClaw.NET 支持哪些查询方式？
支持通过 CLI 和 REST API 查询，用户可以按状态、类型和分类过滤条目。
OpenClaw.NET 中的条目字段分为哪几类？
条目字段分为通用字段、技能专用字段和插件专用字段。
在 OpenClaw.NET 中，如何进行故障排查？
故障排查部分提供了常见错误及其解决方案，帮助用户快速定位问题。
OpenClaw.NET 的自动化测试是如何控制的？
自动化测试通过设置环境变量 OPENCLAW_PUBLIC_SMOKE=1 来控制，确保兼容性验证的有效性。
➡️
