当前位置：首页 > news >正文

OpenClaw 与微信（企业微信）集成完整步骤

news 2026/3/27 9:24:34

OpenClaw 与微信（企业微信）集成完整步骤（官方标准）

OpenClaw 官方仅支持企业微信（WeCom）接入，再通过企业微信关联个人微信实现互通；个人微信直接接入为第三方方案，存在封号风险，以下为官方合规流程。

🔧 前提条件

已完成 OpenClaw 本地/云端部署（含大模型配置）
可正常执行openclaw命令
拥有企业微信账号（免费注册，无需认证）
服务器/本地机器具备公网IP（企业微信需回调）

一、企业微信后台创建应用（核心）

1. 注册/登录企业微信

访问：https://work.weixin.qq.com/
个人微信扫码注册，填写企业信息（个人使用可填虚拟信息）

2. 创建自建应用

进入应用管理 → 自建应用 → 创建应用
填写：
- 应用名称：OpenClaw AI
- 应用描述：OpenClaw 智能助手
- 上传图标
- 可见范围：仅自己（个人使用）
点击创建应用

3. 获取核心凭证（务必保存）

应用详情页复制：
- AgentId（应用ID）
- Secret（应用密钥，点击查看，仅显示一次）
进入我的企业 → 企业信息，复制：
- 企业ID（CorpId）

4. 配置消息接收（API 回调）

应用详情页 →接收消息 → 设置API接收
生成并保存：
- Token（随机生成）
- EncodingAESKey（随机生成，43位）
填写URL（先占位，OpenClaw 配置完成后再填）：
```
http://你的公网IP:18789/wecom-app
```
消息加密方式：兼容模式
暂不保存，待 OpenClaw 配置完成后再验证

5. 配置可信IP（安全）

应用详情页 →开发者接口 → 企业可信IP
添加你的服务器/本地公网IP，保存

6. 发布应用

进入版本管理与发布 → 创建新版本
填写版本号（如 1.0.0），选择可见范围，点击发布
企业自建应用无需审核，立即生效

二、OpenClaw 安装并配置企业微信插件

1. 安装官方插件

# 安装企业微信插件 openclaw plugins install @openclaw-china/wecom-app # 验证插件安装 openclaw plugins list # 出现 wecom-app 即成功

2. 编辑配置文件

打开~/.openclaw/openclaw.json，在channels下添加：

"wecom-app": { "enabled": true, "webhookPath": "/wecom-app", "token": "你的Token", "encodingAESKey": "你的EncodingAESKey", "corpId": "你的CorpId", "corpSecret": "你的Secret", "agentId": 你的AgentId }

示例：

"wecom-app": { "enabled": true, "webhookPath": "/wecom-app", "token": "abc123xyz", "encodingAESKey": "43位随机字符串", "corpId": "ww1234567890abcdef", "corpSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "agentId": 1000001 }

3. 重启 OpenClaw 网关

# 重启网关使配置生效 openclaw gateway restart # 查看网关状态 openclaw gateway status # 实时日志（排查问题） openclaw logs --follow

4. 完成企业微信 URL 验证

回到企业微信后台 → 接收消息设置
点击保存，提示URL 验证成功即打通

三、关联个人微信（实现微信互通）

打开企业微信 App →工作台 → 找到 OpenClaw AI 应用
点击应用 → 右上角… → 关联微信
用个人微信扫码，关注该应用
个人微信 →通讯录 → 企业号，找到 OpenClaw AI
发送消息（如你好），OpenClaw 自动回复即成功

四、验证与调试

测试指令：/status（查看状态）、/model（切换模型）
群聊：在企业微信群中@应用名称触发
问题排查：
- 检查公网IP、端口18789是否开放
- 核对配置文件参数（CorpId、Secret、AgentId、Token、EncodingAESKey）
- 查看openclaw logs --follow定位错误
- 确认企业微信应用已发布、可信IP已添加