OpenClaw 和企业微信插件接入
我来为你整理 Windows 本地部署 OpenClaw 并通过长连接方式接入企业微信的完整步骤：
前置条件
已安装企业微信最新版客户端
已安装 OpenClaw（Node.js 版本需 ≥ 22.0）
管理员权限的企业微信账号（否则看不到 API 模式选项）
第一步：在企业微信创建长连接机器人
打开企业微信客户端 → 工作台 → 智能机器人 → 创建机器人
点击底部小字 "如需使用自有系统获取成员与机器人的聊天并输出回复，可切换至 API 模式创建"
选择 「长连接」 方式（不要选 Webhook 回调模式）
复制保存生成的 Bot ID 和 Secret（后续需要用到）
先不要点击保存，保持页面打开，等完成 OpenClaw 配对后再保存
第二步：Windows 本地安装企微插件
打开 PowerShell 或 命令提示符，依次执行以下命令：
1. 安装企业微信插件
openclaw plugins install @wecom/wecom-openclaw-plugin如果安装失败，可尝试备用命令： openclaw plugins install @tencent/openclaw-wecom
2. 重启 OpenClaw 网关
openclaw gateway start重要：这个窗口不能关闭，关闭后机器人会掉线。需要再新开一个终端窗口执行后续命令。
3. 添加企业微信渠道
在新开的终端窗口执行：
openclaw channels add按提示操作：
用方向键选择 企业微信(WeCom) → 回车
粘贴输入 Bot ID → 回车
粘贴输入 Secret → 回车
选择 Finished/Done 完成基础配置
配对方式选择 Pairing
第三步：完成配对授权
1. 回到企业微信，找到刚创建的机器人，发送任意消息（如"你好"）
2. 机器人会自动回复一条配对码消息（包含授权命令）
3. 复制消息最后一行的配对码
4. 在终端中执行配对命令：
openclaw pairing approve openclaw-wecom 你的配对码5. 提示"授权成功"即完成配对
第四步：保存并启用机器人
1. 回到企业微信机器人配置页面，点击 保存并创建
2. 现在可以在企业微信中与机器人正常对话了
长连接 vs 回调模式的优势
| 特性 | 长连接模式 | 传统回调模式 |
|---|---|---|
| 公网IP/域名 | ❌不需要 | ✅必须需要 |
| 内网穿透 | ❌不需要 | ✅必须配置 |
| 消息加解密 | ❌无需处理 | ✅需要处理 |
| 稳定性 | 高（无回调失败问题） | 低（经常回调失败） |
| 主动推送 | ✅支持 | ✅支持 |
常见问题
| 问题 | 解决方案 |
|---|---|
| 没有 API 模式选项 | 确认你是企业微信管理员，普通成员看不到该选项 |
| 插件安装失败 | 检查网络连接，或尝试切换 npm 镜像源： npm config set registry https://registry.npmmirror.com/ |
| 配对码无法获取 | 确认选择了 API 模式和长连接，重启 OpenClaw 后重试 |
| 机器人不回复 | 检查网关窗口是否保持运行，重新执行配对命令 |
| 需要 7×24 小时在线 | 建议部署到云服务器，本地关机后机器人会离线 |
命令速查表
# 安装插件
openclaw plugins install @wecom/wecom-openclaw-plugin
# 启动网关（窗口不能关）
openclaw gateway start
# 添加渠道
openclaw channels add
# 配对授权
openclaw pairing approve openclaw-wecom 【配对码】
# 重启服务
openclaw gateway restart
# 查看状态
openclaw channels status配置完成后，你就可以在企业微信中与 OpenClaw 对话了。如果需要让个人微信也能使用，可以在企业微信后台 "我的企业" → "微信插件" 中生成二维码，用个人微信扫码关注企业即可。
