OpenClaw.NET 兼容性目录指南（Compatibility Catalog）
内容提要
本文介绍了 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 中，贡献新条目需要遵循特定的流程，确保所有必填字段完整。开发者需注意，缺少关键字段如 expectedStatus 将导致条目被拒绝。因此，了解清单的结构和要求对于顺利贡献至关重要。
故障排查的实用建议
文章中提供了常见故障及其解决方案，帮助用户快速定位问题。例如，若遇到插件加载失败，需检查 configJson 格式是否正确。通过这些故障排查建议，用户可以更高效地解决问题，减少开发中的时间损失。
延伸问答
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 来控制，确保兼容性验证的有效性。
