yeahziapp/openclaw-wecom

OpenClaw企业微信AI网关

镜像概述

基于OpenClaw的企业微信AI网关，提供企业微信智能机器人与自建应用两种集成方式，帮助企业快速实现企业微信端的AI交互能力。

核心功能

• 支持企业微信智能机器人模式
• 支持企业微信自建应用模式（推荐）
• 提供完整的参数配置指引与部署流程

使用场景

• 企业内部通过企业微信实现AI智能客服
• 自动化处理企业微信消息交互
• 集成AI能力到企业微信自建应用中

配置说明

快速部署

1. 准备docker-compose.yml文件（参考下方示例）
2. 填写模型参数与企业微信相关参数
3. 启动容器：docker compose up -d
4. 查看机器码：docker logs -f openclaw-gateway
5. 将授权码写入~/.openclaw/.license文件
6. 重启容器：docker compose restart

docker-compose示例

yaml
version: '3'
services:
  openclaw-wecom:
    image: yeahziapp/openclaw-wecom
    ports:
      - "18789:18789"
    environment:
      - WECOM_APP_CORP_ID=你的企业ID
      - WECOM_APP_CORP_SECRET=你的自建应用Secret
      - WECOM_APP_AGENT_ID=你的自建应用AgentId
      - WECOM_APP_TOKEN=自定义Token
      - WECOM_APP_ENCODING_AES_KEY=随机生成的AES密钥
    volumes:
      - ~/.openclaw:/root/.openclaw

企业微信自建应用参数申请

1. 获取WECOM_APP_AGENT_ID与WECOM_APP_CORP_SECRET

1. 登录企业微信管理后台：https://work.weixin.qq.com/wework_admin/frame
2. 进入应用管理 -> 自建 -> 创建应用
3. 应用创建完成后，在详情页记录：
   • AgentId -> WECOM_APP_AGENT_ID
   • Secret -> WECOM_APP_CORP_SECRET

2. 获取WECOM_APP_CORP_ID

1. 进入我的企业 -> 企业信息
2. 找到企业ID（CorpId） -> WECOM_APP_CORP_ID

3. 获取WECOM_APP_TOKEN与WECOM_APP_ENCODING_AES_KEY

1. 返回自建应用详情页
2. 进入接收消息 -> 设置API接收
3. 填写：
   • URL：https://你的域名/webhooks/wecom-app（或http://你的公网IP:18789/webhooks/wecom-app）
   • Token：自定义字符串（对应WECOM_APP_TOKEN）
   • EncodingAESKey：点击随机生成（对应WECOM_APP_ENCODING_AES_KEY）

   注意：先确保网关已启动，再点击保存

4. 配置企业可信IP

1. 在服务器执行curl ifconfig.me获取出口公网IP
2. 在企业微信后台将该IP添加到应用的企业可信IP列表
3. 未配置可能导致接口调用报错60020（IP不在白名单）

企业微信智能机器人申请

1. 创建智能机器人

1. 登录企业微信管理后台：https://work.weixin.qq.com/wework_admin/frame
2. 进入应用管理 -> 智能机器人 -> 创建机器人
3. 回调地址填写：https://你的域名/webhooks/wecom（或http://你的公网IP:18789/webhooks/wecom）

2. 记录机器人参数

创建页面会提供以下参数，填入网关配置：

• WECOM_TOKEN
• WECOM_ENCODING_AES_KEY
• WECOM_WEBHOOK_PATH（默认/webhooks/wecom）

注意：创建/保存机器人前，确保网关已启动且***端口可访问，否则回调校验失败

环境变量映射（自建应用模式）

• WECOM_APP_CORP_ID：企业ID（CorpId）
• WECOM_APP_CORP_SECRET：自建应用Secret
• WECOM_APP_AGENT_ID：自建应用AgentId
• WECOM_APP_TOKEN：API接收Token
• WECOM_APP_ENCODING_AES_KEY：API接收EncodingAESKey
• WECOM_APP_WEBHOOK_PATH：建议保持默认/webhooks/wecom-app