1. openclaw-weixin 插件装完就报 Cannot find module到底卡在哪如果你正在折腾 openclaw-weixin 插件安装装完插件、配好微信通道结果openclaw gateway restart一敲终端直接甩出一行Error: Cannot find module openclaw/plugin-sdk/channel-config-schema然后 gateway 起不来、微信通道显示未连接——别急这不是你装错了而是 OpenClaw 2026.3.22 到 2026.3.23 这两个版本里一个已知的模块解析坑。openclaw-weixin 是腾讯官方出的 OpenClaw 微信频道插件作用是让 OpenClaw 这个本地 AI Agent 框架能直接收发微信消息把微信当成一个对话入口。它适合两类人一是想让自己的 AI 助手挂在微信上、随时发消息就能调用的人二是需要多个微信号同时在线、每个号独立上下文做客服或分身的开发者。插件本身支持多账号登录每次扫码都会新建一个账号条目这点比很多同类方案都省心。但问题就出在「装完之后」。OpenClaw 从 2026.3.22 起改了插件 SDK 的导出结构微信插件 2.0.1 版本用import { buildChannelConfigSchema } from openclaw/plugin-sdk/channel-config-schema去引子路径模块而 OpenClaw 用 npm 全局安装时Node.js 从插件目录往上逐级找node_modules/openclaw根本找不到——因为 openclaw 装在全局目录里不在插件的解析路径上。jiti 这个 TS/ESM 加载器的别名机制在全局安装场景下也没兜住于是模块解析失败插件加载直接抛错连带 gateway 也起不来。这个报错只在 2026.3.22 和 2026.3.23 两个版本存在2026.3.24 已修复。官方 installer 2.1.1 版本也内置了自动建符号链接的逻辑但如果你是用手动方式装的插件或者用的是旧版 installer就得自己动手补这个链接。下面我把从插件安装、多账号登录到报错排查、再到把 endpoint 切到 TaoToken 的完整链路走一遍每一步都能直接复制。2. 装插件前先把 OpenClaw 版本和 TaoToken 接入点理清在动手装 openclaw-weixin 之前有两件事必须先确认否则后面报错会混在一起排查起来很痛苦。第一件是 OpenClaw 的版本。微信插件 2.0.x 只适配 OpenClaw 2026.3.22 及以上1.0.x 适配 2026.1.0 到 2026.3.22 之前。版本对不上插件启动时会直接拒绝加载。先跑openclaw --version如果输出是 2026.3.22 或 2026.3.23那你大概率会撞上本文要解决的 Cannot find module如果是 2026.3.24 及以上这个 bug 已经没了但下面的多账号和 TaoToken 配置照样用得上如果低于 2026.3.22就得装 legacy 版本openclaw plugins install tencent-weixin/openclaw-weixinlegacy第二件是模型接入点。OpenClaw 默认会去连官方或某个 endpoint但如果你想用 TaoToken 统一管理模型调用、拿到更稳的额度和更清晰的计费就需要把 endpoint 改到 TaoToken。TaoToken 的 API 地址是https://taotoken.net/api官网在https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。它的作用是给你一个兼容 OpenAI 风格的统一入口OpenClaw 里所有走模型的地方都能指过来。这里要强调一点TaoToken 是合规的 API 聚合接入服务不是那种灰色中转你拿到的 Key 和 Base URL 就是标准调用凭证。配置的时候三件套必须齐全——Base URL、API Key、Model ID缺一个都会在请求阶段报错而不是在插件加载阶段。很多人把插件加载错误和模型请求错误混为一谈其实前者是 Node 模块解析问题后者是网络和凭证问题排查顺序完全不同。我建议的顺序是先确认 OpenClaw 版本 → 装对应版本的微信插件 → 解决 Cannot find module → 配多账号登录 → 最后把 endpoint 切到 TaoToken 并验证。这样每一步的报错都能定位到具体环节不会互相干扰。另外提前说一句插件安装有两种方式。官方快速脚本是npx -y tencent-weixin/openclaw-weixin-clilatest install但 1.0.2 及之前的 installer 有个坑它用which命令找 openclawWindows 上没有which只有where会直接退出安装。所以更推荐手动装插件本体openclaw plugins install tencent-weixin/openclaw-weixin手动装的好处是步骤透明出问题你知道卡在哪一步。装完默认会自动启用Channel 显示 OK 但没连接的话手动启用一下openclaw config set plugins.entries.openclaw-weixin.enabled true3. 可复制的插件配置、多账号登录与 TaoToken settings 片段这一节是整篇的核心操作区我把插件启用、多账号登录、上下文隔离、TaoToken endpoint 配置四块拆开写每块都给可直接复制的片段。先看插件启用和登录。装完插件后登录微信频道openclaw channels login --channel openclaw-weixin运行后会弹二维码扫码即可。关键点来了每运行一次这个命令并扫码就会创建一个新的账号条目。也就是说你想让三个微信号同时在线就运行三次、扫三次码。插件原生支持多账号并行不需要额外开进程。多账号登录后默认情况下所有渠道的 AI 会话可能共享同一个 session 上下文也就是 A 微信号和 B 微信号的对话记忆会串。如果你做的是多客服或多分身场景这肯定不行。要隔离设置openclaw config set agents.mode per-channel-per-peer这样每个「微信账号 发消息用户」组合都有独立的 AI 记忆账号之间不串台。这个配置建议在登录多个号之前就设好避免历史上下文混进去。接下来是 TaoToken 的 settings 配置。OpenClaw 的配置文件通常在~/.openclaw/下模型接入相关的 settings 可以写成 JSON。下面是一个可复制的片段把 endpoint 指到 TaoToken{ models: { default: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: 你的模型ID } } }如果你用的是 TOML 风格的配置等价写法[models.default] provider openai-compatible baseUrl https://taotoken.net/api apiKey sk-你的TaoToken密钥 model 你的模型ID三件套对照表方便你核对配置项值说明Base URLhttps://taotoken.net/api固定不加 UTMAPI Keysk-开头在 TaoToken 控制台生成Model ID按需填与 TaoToken 支持的模型名一致API Key 的获取入口在 TaoToken 控制台的 API Keys 页面模型对话调试可以用模型对话页长期跑编码或 Agent 任务建议看 Coding Plan。这几个入口后面 CTA 会再给一次。配置写完后重启 gatewayopenclaw gateway restart到这里插件、多账号、TaoToken 三块配置就齐了。但如果你在 2026.3.22/2026.3.23 上重启后很可能直接撞 Cannot find module所以下一节专门讲这个报错的排查和修复。4. 验证请求从报错消失到微信通道真正连通配置写完不代表通了得有一条最小验证动作确认报错消失、通道加载成功。这一节给你完整的验证链路。先看报错长什么样。2026.3.22/2026.3.23 上重启 gateway 后典型日志是[plugins] openclaw-weixin failed to load from /Users/claw/.openclaw/extensions/openclaw-weixin/index.ts: Error: Cannot find module openclaw/plugin-sdk/channel-config-schema Require stack: - /Users/claw/.openclaw/extensions/openclaw-weixin/index.ts [openclaw] Failed to start CLI: PluginLoadFailureError: plugin load failed: openclaw-weixin看到这个说明插件入口index.ts里的import { buildChannelConfigSchema } from openclaw/plugin-sdk/channel-config-schema解析失败了。原因是 openclaw 全局安装Node 从插件目录往上找不到node_modules/openclaw。修复分五步。第一步先临时禁用插件避免它拖住 gatewayopenclaw plugins disable openclaw-weixin第二步在插件目录内建node_modulesmkdir -p $HOME/.openclaw/extensions/openclaw-weixin/node_modules第三步创建指向全局 openclaw 的符号链接ln -s $(npm root -g)/openclaw $HOME/.openclaw/extensions/openclaw-weixin/node_modules/openclaw第四步验证链接和模块解析。先看链接ls -la $HOME/.openclaw/extensions/openclaw-weixin/node_modules/openclaw应该显示指向类似/Users/claw/.nvm/versions/node/v24.14.0/lib/node_modules/openclaw的路径。再验证模块能不能被解析cd $HOME/.openclaw/extensions/openclaw-weixin node -e import(openclaw/plugin-sdk/channel-config-schema).then(m console.log(Object.keys(m)))如果输出包含buildChannelConfigSchema等键名说明模块解析通了。这一步是整个修复的关键验证点别跳过。第五步重新启用并重启openclaw plugins enable openclaw-weixin openclaw gateway restart重启后之前的 Cannot find module 应该不再出现微信通道正常加载。这时候再跑一次登录命令确认通道可用openclaw channels login --channel openclaw-weixin能正常弹二维码就说明插件层通了。接着验证 TaoToken 这一层发一条微信消息给已登录的号看 AI 是否有回复。如果回复正常说明 endpoint 配置生效如果报 401 或连接失败那是 Key 或 Base URL 的问题不是插件问题。回滚也简单删掉符号链接再重启rm $HOME/.openclaw/extensions/openclaw-weixin/node_modules/openclaw openclaw gateway restart如果你用的是官方 installer 2.1.1它检测到 2026.3.22/2026.3.23 会自动建这个 symlink就不用手动处理了。手动装插件的才需要走上面五步。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth报错不止 Cannot find module 一种这一节把 openclaw-weixin 从安装到接入 TaoToken 链路上最容易撞的几类错误对照着排一遍。每个都给你现象、原因、动作。Cannot find module openclaw/plugin-sdk/channel-config-schema现象就是上面那段日志插件加载失败、gateway 起不来。原因OpenClaw 2026.3.22/2026.3.23 全局安装下模块解析不到。动作按第 4 节的五步建符号链接或升级到 2026.3.24或用 installer 2.1.1。401 Unauthorized现象插件加载正常、微信通道也连上了但发消息后 AI 不回复日志里出现 401。原因TaoToken 的 API Key 错了、过期了或者 Base URL 写成了带 UTM 的地址。动作核对三件套——Base URL 必须是https://taotoken.net/api不带任何参数Key 必须是控制台生成的 sk- 开头串Model ID 必须和 TaoToken 支持的模型名一致。改完openclaw gateway restart。local proxy failed / connection refused现象请求发不出去日志提示本地代理失败或连接被拒。原因环境里残留了 HTTP_PROXY/HTTPS_PROXY 之类的变量或者本地网络策略拦了。动作检查 shell 里的代理环境变量清掉不需要的确认https://taotoken.net/api能直连。注意这里说的是清理本地环境变量不是让你去配什么特殊网络工具。reading choices / Cannot read properties of undefined (reading choices)现象请求返回了但解析响应时读choices报 undefined。原因endpoint 返回的不是标准 OpenAI 格式或者 Base URL 指错了地方比如指到了网页地址而不是 API 地址。动作确认 Base URL 是https://taotoken.net/api用 curl 直接打一次看返回结构curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d {model:你的模型ID,messages:[{role:user,content:ping}]}返回里有choices数组就说明 endpoint 正常问题在 OpenClaw 配置侧。OAuth / 登录态失效现象微信通道显示未连接或登录后很快掉线。原因扫码登录的会话过期或多账号登录时账号条目冲突。动作重新跑openclaw channels login --channel openclaw-weixin扫码多账号场景确认agents.mode设成了per-channel-per-peer避免上下文串台导致的异常。插件版本与 OpenClaw 版本不匹配现象插件启动时直接拒绝加载提示版本超出支持范围。原因2.0.x 配了 2026.3.22 以下的 OpenClaw或 1.0.x 配了 2026.3.22 以上。动作按第 2 节的对照表选版本legacy 用legacy标签。排查顺序建议固定成先看插件是否加载成功Cannot find module 类→ 再看通道是否连上OAuth 类→ 再看模型请求是否通401、proxy、choices 类。一层一层来别跳。6. 把 endpoint 固定到 TaoToken长期跑多账号微信 Agent走到这里插件装好了、多账号登录了、Cannot find module 修了、TaoToken 也接上了。最后说几个长期跑下来比较实用的点。第一符号链接是版本相关的补丁。等你把 OpenClaw 升到 2026.3.24 及以上那个 symlink 就不再需要升级后可以删掉避免残留。删之前确认新版本已经修复跑一次 gateway restart 看有没有报错。第二多账号场景下agents.mode per-channel-per-peer建议一直开着。我试过不开的时候两个微信号的对话记忆会互相污染客服场景下很容易把 A 用户的上下文答给 B 用户。开了之后每个「账号用户」独立记忆清爽很多。第三TaoToken 的三件套建议写进配置文件而不是每次命令行传。Base URL 固定https://taotoken.net/apiKey 和 Model ID 按你的套餐填。这样换模型或换 Key 只改一处不用动插件配置。第四验证动作要形成习惯。每次改完配置先openclaw gateway restart再发一条微信消息看回复最后看日志有没有新报错。三步走完再去做别的不然问题会累积。如果你还没拿 TaoToken 的 Key去控制台的 API Keys 页面生成一个接入细节和参数说明看接入文档想先试试模型对话效果可以用模型对话页如果是长期跑编码或 Agent 任务Coding Plan 会更合适。把 endpoint 固定到 TaoToken 之后OpenClaw 这边所有走模型的地方都统一了多账号微信 Agent 跑起来也稳。