前置条件
- 一台已安装 OpenClaw 的服务器（本地或云服务器均可）
- 企业微信账号（注册即可免费使用）
- 个人微信账号
第一步：企业微信配置
1. 登录企业微信
- 访问企业微信官网
- 使用电脑网页版扫码登录企业微信管理后台
2. 获取企业ID (CorpId)
- 在管理后台点击 “我的企业”（通常在页面顶部或左侧菜单）
- 在页面底部找到 企业ID（CorpId）
- 复制记录下来，后续配置需要使用
3. 创建自建应用
- 点击顶部菜单 应用管理
- 在左侧找到 应用 → 自建
- 点击 创建应用
- 填写应用信息：
- 应用名称：OpenClaw助手（或其他你喜欢的名字）
- 应用介绍：AI助手（可选）
- 上传应用图标（可选）
- 点击 创建应用
创建成功后，记录页面上的两个重要参数：
- AgentId（应用ID）
- Secret（应用密钥）
提示：这两个参数后续需要在 OpenClaw 配置中使用，请妥善保管！
4. 配置接收消息
在应用详情页中：
- 找到 接收消息 设置项
- 点击 随机生成 按钮，生成以下参数：
- Token
- EncodingAESKey
- 记录这两个参数（后续需要用到）
注意：配置好参数后，暂时不要点击保存（此时会报错，需要等 OpenClaw 配置完成并重启网关后才能保存成功）
需要记录的参数清单
| 参数名称 | 获取位置 | 用途 |
|---|---|---|
| CorpId | 我的企业 | OpenClaw 配置 |
| AgentId | 应用管理 → 自建应用 | OpenClaw 配置 |
| Secret | 应用管理 → 自建应用 | OpenClaw 配置 |
| Token | 接收消息 → 随机生成 | 接收消息验证 |
| EncodingAESKey | 接收消息 → 随机生成 | 消息加密 |
注意：以上 5 个参数请全部记录，后续配置步骤都需要用到！
第二步：OpenClaw 配置
1. 安装企业微信插件
在安装 OpenClaw 的服务器上执行以下命令：
openclaw plugins install @openclaw-china/wecom-app
安装完成后，执行配置向导：
openclaw china setup
配置向导会引导你填写刚才记录的企业微信相关参数。
2. 修改网关绑定模式（重要！）
如果你的 OpenClaw 网关 gateway.bind 参数设置为 loopback，需要修改为 lan：
openclaw config set gateway.bind lan
说明：
loopback：仅本机访问（127.0.0.1）lan：局域网访问，企业微信才能通过公网访问你的 OpenClaw
3. 配置企业微信参数
编辑 OpenClaw 配置文件（~/.openclaw/openclaw.json），在 channels 部分添加：
"wecom-app": {
"enabled": true,
"webhookPath": "/wecom-app",
"corpId": "你的企业ID",
"agentId": "你的应用ID",
"secret": "你的应用密钥",
"token": "你的Token",
"encodingAESKey": "你的EncodingAESKey"
}
4. 重启网关
openclaw gateway restart
重启后，OpenClaw 会启动企业微信消息接收服务。
5. 配置企业微信接收消息 URL
回到企业微信管理后台：
- 进入 应用管理 → 刚创建的应用 → 接收消息
- 填写 URL：
- 如果是云部署：
http://你的云服务器公网IP:端口/wecom-app - 如果是本地部署：需要使用内网穿透工具（如 frp、ngrok）生成公网地址
- 点击 保存（此时应该可以保存成功了）
6. 设置 IP 白名单
在应用详情页：
- 找到 企业 IP 配置项
- 将你的服务器公网 IP 添加到白名单
- 保存配置
第三步：绑定个人微信
1. 获取邀请关注二维码
在企业微信管理后台：
- 进入 应用管理 → 你的应用
- 找到 微信插件 或 邀请关注 选项
- 获取 邀请关注的二维码
2. 扫码关注
使用你的个人微信扫描刚才的二维码，按提示完成关注流程。
完成配置
恭喜！现在你可以用个人微信直接和 OpenClaw 对话了！
在个人微信中，向绑定的企业号发送消息，OpenClaw 就会实时回复你。
常见问题
Q1：保存接收消息配置时提示"URL校验失败"？
A：检查以下几点：
- OpenClaw 网关是否已重启
gateway.bind是否设置为lan- 服务器防火墙是否开放了对应端口
- 如果使用云服务器，安全组是否放行端口
Q2：个人微信发送消息后没有响应？
A：检查以下几点：
- 企业微信后台的 IP 白名单是否已配置
- 个人微信是否已成功关注企业应用
- OpenClaw 日志是否有错误信息（查看
~/.openclaw/logs/目录）
Q3：本地部署如何实现公网访问？
A：本地部署需要使用内网穿透工具，常见方案：
- frp：自建内网穿透，需要一台公网服务器
- ngrok：第三方内网穿透服务，有免费额度
- Tailscale Funnel：OpenClaw 内置支持，可创建安全隧道
使用 Tailscale Funnel 的配置方法：
openclaw config set gateway.bind loopback
openclaw config set gateway.tailscale.mode funnel
openclaw gateway restart