OpenClaw 对接企业微信配置教程

小新 正七品 (知县) 2026-03-17 03:54 1 0 返回 码工码农
小新 正七品 (知县) 楼主
2026-03-17 03:54
第1楼

摘要::

应用名称:OpenClaw助手(或其他你喜欢的名字) 应用介绍:AI助手(可选) 上传应用图标(可选)

点击 创建应用

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

AgentId(应用ID) Secret(应用密钥)

💡 提示bind 参数设置为 loopback,需要修改为 lan: openclaw config set gateway.:第三方内网穿透服务,有免费额度 Tailscale Funnel:OpenClaw 内置支持,可创建安全隧道

使用 Tailscale Funnel 的配置方法: openclaw config set gateway.


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

📚 参考资源


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

暂无回复,快来抢沙发吧!

  • 1 / 1 页
敬请注意:文中内容观点和各种评论不代表本网立场!若有违规侵权,请联系我们