ARTICLE · 1188018
OpenClaw 接入微信实录:装个官方系插件,连踩两个坑(附完整排查方案)
最近在折腾 OpenClaw——一个开源的 AI 助手网关，可以把大模型接入各种聊天渠道，实现"在微信 / 飞书 / Telegram 里直接和自己的 AI 对话"。
我的目标很朴素：手机上随时能问它问题。于是安装了微信渠道插件 openclaw-weixin，结果一个晚上连踩两个坑。把完整过程写下来，给后来人排雷。
OpenClaw 2026.10.3，Windows 11 PC 本地网关，WebUI 对话一切正常
执行安装后，OpenClaw 直接报配置非法：
同时网关启动校验失败。
根因：插件 manifest 自带了旧版本的鉴权配置项（allowInsecureAuth、dangerouslyDisableDeviceAuth），安装流程会把 manifest 里的配置合并写入全局 openclaw.json。而 2026.10.x 内核已经不认识这两个键——全局配置被写坏，网关自然起不来。
处理：清理这两个键即可。
清理后校验通过，网关恢复正常。
重点：这个污染每次安装都会发生。我用 --force 重装验证过，同样的键又被写回去。所以动手装之前，先花 10 秒备份：
坏了就把备份复制回去，网关立刻满血复活。
配置清理干净后继续装，插件加载时抛出：
插件状态变成 UNAVAILABLE，怎么 reload 都没用。
根因：插件代码基于旧版 OpenClaw 插件 SDK 构建，引用了 infra-runtime 等模块路径，而 2026.10.x 内核已经移除 / 重构了这些子路径。这是代码层面的依赖断裂——清配置、重装、加 --force 都救不了。
而且这不是个例：GitHub 上已有公开 issue（NewFuture/openclaw-weixin #137），报告插件最新版本在 2026.10.x 内核上加载失败，涉及 infra-runtime / channel-message / command-auth 三个被移除的子路径。截至本文写作（2026-10-15），issue 仍然 open，暂无修复版本。
- 等插件适配新版内核
—— 零成本，时间不可控，可以关注那个 issue - 换官方原生渠道（飞书 / Telegram / Discord 等）
—— 成本最低的可用方案，不受此影响 - 降级 OpenClaw 内核到旧版本
—— 能跑，但其他插件和功能可能跟着坏，不推荐 - 自己改插件源码换 import 路径重新打包
—— 需要 TS 能力，且不确定只有一处不兼容
我的选择：1 + 2。先换飞书用着，微信插件等官方适配后再回来试。
- 装任何第三方插件前，先备份 openclaw.json。
一行命令保平安。 - "配置报错"和"插件加载失败"是两类完全不同的问题
：前者清理配置就能修，后者是代码依赖断裂，别在配置上死磕。 - 看到 Package subpath ... is not defined by "exports"
，基本可以断定是插件和内核的 SDK 版本鸿沟。 - 排查三件套
：openclaw config validate / openclaw plugins list / openclaw channels status --probe
- Issue #137：github.com/NewFuture/openclaw-weixin/issues/137
- OpenClaw 微信渠道文档：docs.openclaw.ai/channels/wechat
— 完 —
