plugin-inspector
OpenClaw插件离线兼容性检查工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：plugin-inspector。 它的用途是：OpenClaw插件离线兼容性检查工具 完整的 Skill 内容见：https://321skill.com/skills/plugin-inspector/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我正在开发一个OpenClaw插件，想在提交代码前快速检查一下有没有潜在的兼容性问题。” 它会引导你使用 `npx @openclaw/plugin-inspector inspect` 命令进行快速扫描，并解读生成的报告，指出哪些是必须修复的硬性错误，哪些是优化建议。或者，你可以说：“帮我把这个检查工具集成到我的GitHub Actions工作流里。” 它会提供配置示例，并解释如何根据检查结果自动通过或失败构建。
介绍
OpenClaw Plugin Inspector 是一款专为 OpenClaw 插件开发者设计的离线兼容性检查工具。它解决了插件在发布前，开发者无法快速、安全地验证其与 OpenClaw 平台兼容性的核心痛点，确保插件在到达用户手中前就符合平台规范。
使用方式非常简便，开发者只需在插件项目根目录下执行一条命令（如 npx @openclaw/plugin-inspector inspect --no-openclaw），工具便会静态分析插件的包结构、清单文件（openclaw.plugin.json）、钩子、注册调用等，并生成详细的 JSON、Markdown 等格式的报告，指出硬性兼容问题、警告和建议。它无需本地 OpenClaw 代码库、网络服务或凭据即可完成核心检查。
该工具主要适合为 OpenClaw 平台开发插件的各类开发者，特别是那些需要在持续集成（CI）流程中自动化进行兼容性验证的团队。无论是开发新插件还是维护旧插件，它都能帮助确保代码质量与平台兼容性。
建议在插件项目的早期开发阶段就引入此工具，并将其集成到 CI/CD 流程中。对于需要更深入运行时行为分析的场景，可以谨慎启用 --runtime 等选项，但需注意这会导入插件代码执行。
核心特点
与通用代码质量工具不同，它深度集成 OpenClaw 插件生态，能精准识别平台特定的钩子、注册模式、清单合约和 SDK 导入问题。其离线、无凭证的默认检查模式，在保障安全的同时，提供了开箱即用的兼容性验证能力。
注意事项
主要针对 OpenClaw 插件生态，不适用于其他平台或通用项目的代码质量检查。
常见问题
检查插件兼容性是否需要安装完整的 OpenClaw？
不需要。默认的离线检查模式（使用 --no-openclaw）无需本地 OpenClaw 代码库或任何运行时环境，即可完成核心兼容性分析。
这个工具能在 CI 流水线中使用吗？
完全可以。它专为 CI 设计，能生成多种格式（JSON、JUnit、SARIF等）的报告，并可根据发现的“硬性”兼容问题设置非零退出码，方便流水线决策。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/plugin-inspector/raw/index.md 读取 plugin-inspector 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/plugin-inspector/raw/index.md（查看排版版本）