根本原因是旧版残留、版本错配、端口冲突三者叠加导致插件无法初始化；需先停止旧网关进程，再彻底清理缓存与临时文件，最后用@latest标签重装宿主及微信插件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
安装AionClaw时遇到插件加载失败、模块报错、网关启动卡住或提示“openclaw-weixin failed to load”，根本原因不是网络慢或点错了按钮，而是旧版残留、版本错配、端口冲突三者叠加导致插件根本没机会初始化。
停止残留网关进程
以管理员身份打开 Windows PowerShell 或 macOS 终端，执行：
openclaw gateway stop
若返回 Stopped Scheduled Task: OpenClaw Gateway，说明已成功终止；若提示“command not found”，说明网关未运行，可跳过此步。这一步必须做，否则新插件尝试绑定18789端口时会直接被旧进程拦截。
彻底清理旧环境
旧版 OpenClaw 和微信插件共用同一套缓存目录，不清空会导致新版读取到损坏的 channel-config-schema 文件，进而触发 【Cannot find module 'channel-config-schema'】 报错。
依次执行以下命令：
npm uninstall -g openclaw
npm uninstall -g @tencent-weixin/openclaw-weixin-cli
Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw（Windows）
rm -rf $HOME/.openclaw（macOS）
删除临时安装痕迹：
Remove-Item -Recurse -Force $env:LOCALAPPDATA\Temp\openclaw-*（Windows）
rm -rf $TMPDIR/openclaw-*（macOS）
重装最新稳定版
清理完成后，必须使用 @latest 标签安装，不能指定旧版本号，否则仍会复现兼容问题。
第一步：安装最新版宿主
npm install -g openclaw@latest
第二步：用 npx 直接调用最新微信插件 CLI 安装器
npx -y @tencent-weixin/openclaw-weixin-cli@latest install
这一步会自动匹配宿主版本并生成正确 schema 结构，不再需要手动创建 config.yaml 或补全缺失字段。安装过程无任何交互提示即表示成功。
验证插件是否真正就绪
方法一：检查插件列表
openclaw plugin list → 输出中应包含 openclaw-weixin 且状态为 enabled
方法二：查看网关日志实时输出
openclaw gateway start --log-level debug → 滚动日志中出现 Loaded plugin: openclaw-weixin 即为生效
注意：若日志中仍有 Unsupported channel: openclaw-weixin，说明前序清理不彻底，需重新执行 rm -rf $HOME/.openclaw 步骤。
