OpenClaw 对接企业微信配置教程

_xusddd
0 阅读4分钟

OpenClaw 对接企业微信配置教程

本文记录了如何将 OpenClaw AI 助手通过企业微信接入个人微信，实现随时随地与 AI 对话。

📋 前置条件

  • 一台已安装 OpenClaw 的服务器（本地或云服务器均可）
  • 企业微信账号（注册即可免费使用）
  • 个人微信账号

📱 第一步：企业微信配置

1. 登录企业微信

访问企业微信官网：work.weixin.qq.com/

使用电脑网页版扫码登录企业微信管理后台。

2. 获取企业ID (CorpId)

  1. 在管理后台点击 "我的企业"（通常在页面顶部或左侧菜单）
  2. 在页面底部找到 企业ID（CorpId）
  3. 复制记录下来，后续配置需要使用

3. 创建自建应用

  1. 点击顶部菜单 应用管理
  2. 在左侧找到 应用 → 自建
  3. 点击 创建应用
  4. 填写应用信息：
    • 应用名称：OpenClaw助手（或其他你喜欢的名字）
    • 应用介绍：AI助手（可选）
    • 上传应用图标（可选）
  5. 点击 创建应用

创建成功后，记录页面上的两个重要参数：

  • AgentId（应用ID）
  • Secret（应用密钥）

💡 提示：这两个参数后续需要在 OpenClaw 配置中使用，请妥善保管！

4. 配置接收消息

在应用详情页中：

  1. 找到 接收消息 设置项
  2. 点击 随机生成 按钮，生成以下参数：
    • Token
    • EncodingAESKey
  3. 记录这两个参数（后续需要用到）

⚠️ 注意：配置好参数后，暂时不要点击保存（此时会报错，需要等 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

回到企业微信管理后台：

  1. 进入 应用管理 → 刚创建的应用 → 接收消息
  2. 填写 URL：
    • 如果是云部署：http://你的云服务器公网IP:端口/wecom-app
    • 如果是本地部署：需要使用内网穿透工具（如 frp、ngrok）生成公网地址
  3. 点击 保存（此时应该可以保存成功了）

6. 设置 IP 白名单

在应用详情页：

  1. 找到 企业 IP 配置项
  2. 将你的服务器公网 IP 添加到白名单
  3. 保存配置

🔗 第三步：绑定个人微信

1. 获取邀请关注二维码

在企业微信管理后台：

  1. 进入 应用管理 → 你的应用
  2. 找到 微信插件 或 邀请关注 选项
  3. 获取 邀请关注的二维码

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

📚 参考资源

如果这篇教程对你有帮助，欢迎点赞、收藏、分享！ 🎉

avatar
文章
阅读
粉丝