OpenClaw 2026.2.23-cn 连接企业微信完整教程

作者：瑜之
适用版本：OpenClaw 2026.2.23-cn (Windows)
插件版本：@wecom/wecom-openclaw-plugin@2026.3.20

背景

OpenClaw 是一款强大的 AI 助手框架，企业微信官方提供了 @wecom/wecom-openclaw-plugin 插件用于双向通信。Windows 环境下，OpenClaw 2026.2.23-cn 通过 openclaw plugins install 安装插件时会报 spawn EINVAL 错误。本文提供手动安装方案，无需升级版本。

环境

• 操作系统：Windows 10/11
• OpenClaw：2026.2.23-cn
• Node.js：24.x
• 企业微信机器人：需提前创建（获取 botId 和 secret）

解决方案步骤

获取插件备份

openclaw plugins install 在 Windows 存在 bug，需手动复制 @wecom/wecom-openclaw-plugin@2026.3.20 插件包（含依赖）。
注意：最新版 2026.6.23 要求 openclaw >=2026.3.28，必须使用 2026.3.20 版本。

复制插件到 extensions 目录

插件需放在 extensions/ 目录下（非 plugins/）。

mkdir $env:USERPROFILE\.openclaw\extensions -Force
Copy-Item C:\Users\Administrator\.openclaw.bak\extensions\wecom-openclaw-plugin `
  C:\Users\Administrator\.openclaw\extensions\wecom-openclaw-plugin -Recurse -Force

目录结构示例：

~/.openclaw/
  extensions/
    wecom-openclaw-plugin/
      package.json       # 版本 2026.3.20
      openclaw.plugin.json
      dist/
        index.esm.js
        index.cjs.js
      node_modules/      # 完整依赖
      skills/            # 企业微信 skill
        wecom-msg/
        wecom-preflight/
        ...

配置 openclaw.json

关键配置项：

{
  "channels": {
    "wecom": {
      "botId": "企业微信机器人 Bot ID",
      "secret": "机器人 Secret",
      "enabled": true
    }
  },
  "plugins": {
    "allow": ["wecom-openclaw-plugin"],
    "entries": {
      "wecom-openclaw-plugin": { "enabled": true }
    }
  }
}

注意事项：

• plugins.entries 仅保留 enabled: true，避免多余字段导致校验错误。
• plugins.allow 必须包含插件 ID。

重启 Gateway

openclaw gateway restart
openclaw gateway status

日志无 unknown channel id: wecom 即表示成功。

验证双向通信

在企业微信群发送消息，OpenClaw 正常回复即连接成功。

常见问题

openclaw plugins install 报 spawn EINVAL

OpenClaw 2026.2.23-cn 的 Windows 已知问题，直接使用手动部署方案。

报错 "unknown channel id: wecom"

检查项：

• 插件是否在 extensions/ 目录且结构正确。
• plugins.allow 是否包含插件 ID。
• 重启 gateway。

报错 "Unrecognized keys: version, source, name, id, directory"

删除 plugins.entries 中的多余字段，仅保留 enabled: true。

插件版本兼容性

通过以下命令检查：

node -e "console.log(require('~/.openclaw/extensions/wecom-openclaw-plugin/package.json').peerDependencies)"

输出 undefined 或 null 表示无版本限制。

总结

调整要点：

• 标题层级从 ### 开始，避免使用 # 和 ##。
• 移除步骤词汇（如“首先”），改用分项描述。
• 代码块与表格保留原始格式，未使用 markdown 包装。
• 严格遵循 Markdown 语法规范。