OpenClaw集成QQ

更新时间:
复制为 MD 格式

本文介绍将 OpenClaw服务与QQ集成,实现在QQ机器人单聊中,通过自然语言直接与OpenClaw交互。

计费说明

在轻量应用服务器上部署并使用OpenClaw服务将产生以下费用:

  • 轻量应用服务器费用:参见轻量应用服务器计费概述

  • 模型调用费用:OpenClaw执行过程中默认调用百炼模型。模型调用的主要计费方式有两种:

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

      Coding Plan支持抵扣qwen3.5-plusqwen3-max-2026-01-23qwen3-coder-plus模型调用费用,不支持其他模型(如qwen3-vl-plus
    • Token用量计费:

步骤一、购买OpenClaw套餐

重要

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

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

    该应用镜像基于Alibaba Cloud Linux 3.2104 LTS 64位操作系统,来源于阿里云计算巢。
  2. 轻量应用服务器页面,预置了资源配置,如要更改配置项,请参考下面内容。

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

    • 地域:默认美国(弗吉尼亚)

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

步骤二、配置OpenClaw

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

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

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

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

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

      Coding Plan支持抵扣qwen3.5-plusqwen3-max-2026-01-23qwen3-coder-plus模型调用费用,不支持其他模型(如qwen3-vl-plus
    • 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. 单击访问控制页面下的执行命令,获取OpenClaw WebUI的地址,可以在Web页面与OpenClawAgent对话。

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

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

    image

    警告

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

步骤三、集成QQ

3.1 注册并登录QQ开放平台

  1. 前往腾讯QQ开放平台官网,注册QQ开放平台账号。首次注册之后,可以按照QQ开放平台的指引设置超级管理员。

    QQ开放平台账号与QQ账号独立,若您之前未注将QQ号绑定至已有的QQ开放平台账号则无法用QQ号直接登录,需先完成QQ开放平台账号注册绑定流程。
  2. 填写主体相关信息。按照指引依次输入姓名、身份证号、手机号、验证码,点击继续进入下一步人脸认证。

  3. 使用手机QQ扫码进行人脸认证。人脸识别审核通过后,即可登录进入QQ开放平台。

3.2 创建并配置QQ机器人

创建机器人

  1. QQ开放平台单击机器人页签,单击创建机器人,并根据页面提示创建机器人。

  2. QQ机器人创建完成之后,在机器人列表中可单击机器人进入管理页面。

  3. 在左侧导航栏单击管理 > 开发管理,在开发管理页面单击生成按钮,验证管理员身份后获取当前机器人的AppID(机器人ID)和AppSecret(机器人密钥),复制并保存。

    重要

    请妥善保管复制的密钥信息,QQ机器人的AppSecret(机器人密钥)不支持明文保存,首次查看或忘记AppSecret(机器人密钥)需要重新生成。

    image

添加机器人使用成员

  1. 在左侧导航栏单击管理 > 成员管理,单击添加成员,将需要使用机器人的QQ添加至成员,成员拥有登录权限即可与机器人私聊对话。image

  2. 在左侧导航栏单击开发 > 沙箱配置,在消息列表配置中添加QQ成员。image

  3. 添加后,该成员需使用QQ扫描配置页面提供的二维码来添加机器。

    重要

    QQ开放平台中,QQ机器人的QQ群配置操作由于系统维护中暂不支持,仅支持单独和QQ机器人聊天。

    image

3.3 OpenClaw集成到QQ

使用OpenClaw插件集成(推荐)

重要

该功能仅支持镜像版本为2026.2.9及以上的实例。如需在旧版本中集成钉钉,请参考AppFlow集成方案。可在轻量应用服务器概览页的基本信息 > 镜像信息中查看当前实例的镜像版本。

在控制台配置channel,在应用详情 > 通道配置 > QQ中填入步骤3.2获取的App IDApp Secret单击应用

image

使用AppFlow集成

AppFlow连接流配置

  1. 使用通过QQ机器人使用MoltBot(Clawd)——多模态模板创建连接流,单击立即使用进入创建流程。

  2. 在连接流的账户授权配置向导页,点击添加新凭证。在创建凭证对话框中,填入创建的机器人的AppID(机器人ID)和AppSecret(机器人密钥),并设置一个自定义凭证名称。

    image

  3. 在连接流的账户授权配置向导页,点击添加新凭证。输入在步骤二中配置Moltbot时获取的Tokenimage

  4. 执行动作配置向导页按照页面提示配置完成后点击下一步公网地址:端口格式为您的轻量应用服务器公网IP:服务端口,若公网IP47.0.XX.XX,服务端口为18789(服务端口默认为18789),则应填写47.0.XX.XX:18789

  5. 基本信息配置向导页,填写连接流名称连接流描述(建议保持默认),完成后点击下一步

  6. 配置完成后点击发布,复制并保存您的WebhookUrl

配置回调

  1. 在开发管理页面的IP白名单模块单击编辑,按照如下IP逐个添加IP白名单,配置完成后单击保存

    121.40.82.220
    47.97.73.42
    47.98.226.113
    47.96.151.112
    118.178.89.160
    120.27.202.100

    image

  2. 将步骤五获取的WebhookUrl填入到请求地址,并勾选单聊事件中的C2C消息事件,单击确定配置。

    image

方案验证

前往腾讯QQ开放平台官网,在左侧导航栏单击开发 > 沙箱配置,已在消息列表配置中的QQ成员。可使用手机QQ扫描配置页面提供的二维码来与机器人对话。

image