OpenClaw(原Moltbot、Clawdbot)企业微信集成

更新时间:
复制为 MD 格式

本文介绍将OpenClaw服务与企业微信集成,实现在群聊中,通过自然语言直接与OpenClaw交互。

环境准备

配置消息渠道前,需参考以下步骤或部署OpenClaw镜像文档购买并配置OpenClaw应用镜像的轻量应用服务器,若已完成可跳过此步骤。

购买并配置OpenClaw应用镜像的轻量应用服务器

步骤一、购买OpenClaw套餐

重要

如果已购买轻量应用服务器,可以跳过此步骤,以重置系统的方式部署OpenClaw(重置系统时选择应用镜像下的OpenClaw镜像),但重置系统会清除轻量应用服务器上的系统盘数据,请根据需要做好数据备份。具体操作,请参见重置系统

  1. 购买预装OpenClaw应用的轻量应用服务器

  2. 轻量应用服务器页面,预置了资源配置,如要更改配置项,请参考下面内容。

    • 实例:内存必须2GiB及以上,可以根据自己的需求切换套餐。

    • 地域:默认北京

    • 购买配置:默认12个月,可以根据自己的需求切换时长。

步骤二、配置OpenClaw

  1. 轻量应用服务器-控制台,单击服务器卡片中的实例ID,在服务器概览页面单击应用详情页签。

  2. OpenClaw使用步骤区域中,单击端口放通下的执行命令,可开放获取OpenClaw服务运行端口的防火墙。

    重要
  3. 单击配置OpenClaw下的执行命令配置百炼API key。

    目前支持配置两种类型的百炼API Key:

    • Coding Plan 套餐专属 API Key(推荐):采用固定月费模式,提供月度请求额度,超出时段限额的调用会报错且不计费用,可避免产生超出预期的费用。

      Coding Plan 目前支持 qwen3.5-pluskimi-k2.5MiniMax-M2.5glm-5等模型,详细的模型列表请参考Coding Plan概述
    • Token用量计费的百炼API Key。

    API Key配置方式包括系统推荐手动输入。系统推荐会列出百炼Coding PlanAPI Key(成本可控),及离服务器最近的百炼模型服务的API Key(时延较低)。若需使用其他地域或者其他账号的API Key可选择手动输入。

    • 系统推荐(下拉选择)

      选择完成后单击下一步

      轻量应用服务器所在地域

      系统推荐的百炼API Key对应地域

      Coding PlanAPI key对应地域

      中国内地地域

      华北2(北京)

      华北2(北京)

      美国及欧洲地域

      美国(弗吉尼亚)

      中国香港及其他亚洲地域

      新加坡

    • 手动输入

      单击按钮切换至手动输入,输入百炼API Key并选择该API Key对应地域,单击下一步image

      重要

      手动配置需确保选择的API Key对应地域正确,否则会导致模型无法正常调用。

  4. 单击访问Web UI面板下的获取地址,获取OpenClaw WebUI的地址,可以在Web页面与OpenClawAgent对话。

    可根据需求参考关闭OpenClaw WebUI的公网访问一键关闭WebUI的公网访问权限。
  5. (可选)查看Token。

    应用详情 > 基础配置 > 查看Token中单击查看,查看并保存Token。

    警告

    请勿泄露包含 Token 的完整 URL。该链接包含身份验证凭据,任何持有此链接的人都能直接绕过登录验证,获得 OpenClaw 控制台的管理员权限。

集成企业微信

OpenClaw插件集成方式仅支持镜像版本为OpenClaw 2026.2.9及以上的实例。如需在旧版本中集成该消息渠道,请参考通过AppFlow集成消息渠道。您可在轻量应用服务器概览页的基本信息 > 镜像信息中查看当前实例的镜像版本。

扫码配置方式

仅支持OpenClaw 2026.3.13及以上版本。
  1. 轻量应用服务器控制台,进入目标实例详情页,在应用详情 > 通道配置 > 企业微信中单击扫码配置

  2. 页面将展示一个二维码,使用企业微信扫描该二维码,按照提示完成授权即可完成机器人的创建和配置。

长连接方式

仅支持OpenClaw 2026.3.13版本,其他版本可使用URL回调方式接入。
  1. 访问企业微信管理后台,在左侧导航栏单击管理工具 > 智能机器人。单击创建机器人,单击手动创建

    image

  2. 通过API模式创建智能机器人。

    1. 下拉到页面底部单击API模式创建

      image

    2. 配置如下参数后单击保存

      1. 可见范围:配置机器人的可见范围。

      2. API配置:在连接方式区域选择使用长连接。在配置方法 Secret区域单击点击获取保存Bot IDSecret

      3. 可使用权限:按需配置机器人的权限。

    3. 轻量应用服务器控制台,进入目标实例详情页,在应用详情 > 通道配置 > 企业微信中填入上一步获取的Bot IDSecret,并单击应用

URL回调方式

  1. 访问企业微信管理后台,在左侧导航栏单击管理工具 > 智能机器人。单击创建机器人,单击手动创建

    image

  2. 通过API模式创建智能机器人。

    1. 下拉到页面底部单击API模式创建

      image

    2. 连接方式区域选择使用 URL 回调

    3. 分别单击TokenEncoding-AESKey后的随机获取,保存TokenEncoding-AESKey

    4. 轻量应用服务器控制台,进入目标实例详情页,在应用详情 > 通道配置 > 企业微信中填入上一步获取的TokenEncoding-AESKey,并单击应用

    5. 回到API模式创建页面,填入URLTokenEncoding-AESKey字段保持不变,单击创建

      URL的格式为http://<IP地址>:<端口号>/webhooks/wecom。IP地址和端口号需要替换为OpenClaw服务器的IP地址和端口号,端口号可以参照如何查看OpenClaw的端口号获取。
      重要

      如出现“域名主体校验未通过”的报错,请参考域名主体校验未通过的解决方法

方案验证

  1. 在群聊中点击添加群成员,搜索创建完成的机器人名称加入群聊

  2. 在已添加机器人的群中@机器人即可实现流式对话,效果如下:

    image

常见问题

如何配置OpenClaw定时执行任务并输出内容到企业微信机器人?

可以通过与OpenClaw对话创建定时任务。

  1. 获取群机器人的Webhook地址:点击群设置,打开消息推送,填写机器人名称和简介,复制Webhook地址。

    2026-03-03_15-56-26

  2. OpenClaw对话中创建相应任务,格式为定时任务内容+群机器人的Webhook地址,以查询实时天气为例创建定时任务。

  3. 验证消息发送。可在对话中让Agent立即发送消息,测试该定时任务。在机器人所在的群聊查看是否执行定时任务。

如要修改或者取消定时任务,可直接在对话中让Agent修改或取消定时任务。

如需使用AppFlow配置定时任务,请参考如何使用AppFlow配置定时任务

域名主体校验未通过怎么办?

在创建保存智能机器人的过程中,可能会遇到“域名主体校验未通过,需配置备案主体与当前企业主体相同或有关联关系的域名”的报错。该问题通常由企业微信的相关限制所引起,需要配置一个企业自有域名解决此问题。

如果域名已在阿里云备案,可以参考如下步骤创建一个二级域名作为企业自有域名。

image.png

  1. 访问AppFlow域名管理页面,单击添加域名按钮,进入添加域名页面,填入可用的二级域名,如airobot.example.com

  2. 参考CNAME 记录,将该二级域名解析到上一步的记录值

  3. 解析配置完成后,返回创建域名页面,点击提交

  4. 使用该二级域名替换配置API接收消息URL(即已经填写的WebhookUrl)中的主机名。例如:在AppFlow获取的WebhookUrl:https://123123123.appflow.aliyunnest.com/webhook/a479a8f17,企业域名:airobot.example.com,则最终需要填写的域名为http://airobot.example.com/webhook/a479a8f17