OpenClaw插件开发本地调试指南：启用插件、看日志和复现问题

OpenClaw插件开发本地调试指南的搜索意图很明确：读者想知道问题从哪一步开始查，哪些证据能证明自己没有走偏。本地调试要把启用、加载、注册、调用拆开验证。这里不把资料堆成清单，而是按开发者会遇到的判断点展开，围绕 OpenClaw 本地插件调试 给出能直接复核的做法。

启用状态先对齐配置

这一段的核心对象是 plugins list、inspect --runtime、Gateway 日志、最小复现命令。它重要，是因为 OpenClaw 的插件链路会把声明、配置、运行时和调用结果拆在不同位置；只看其中一处，很容易把框架问题当成业务问题。复核时要留下命令、时间、路径和关键输出，后面改版本或换机器才有对照。

可执行的判定口径是：看 插件来源路径、enabled 状态、启动时间线、错误栈上下文、调用 payload。如果这些证据相互吻合，说明当前层级基本可信；如果出现 只重启 Gateway、只搜索 error、把密钥连同日志一起分享，就先停在这一层修正，不要继续叠加新能力。复现里每次只改一个条件，改三处才成功就不能判断修复点。我的经验是，加载失败最高优先级，工具参数错误排在运行时可见后面，这样排查面会小很多。

日志按启动时间线读

这一段的核心对象是 插件来源路径、enabled 状态、启动时间线、错误栈上下文、调用 payload。只看其中一处，很容易把框架问题当成业务问题。

复现命令要短而完整

这一段的核心对象是 只重启 Gateway、只搜索 error、把密钥连同日志一起分享。只看其中一处，很容易把框架问题当成业务问题。

依赖问题看错误变化

这一段的核心对象是 加载失败最高优先级，工具参数错误排在运行时可见后面。只看其中一处，很容易把框架问题当成业务问题。