OpenClaw集成QQ

更新时间:
复制为 MD 格式

本文介绍将 OpenClaw服务与QQ集成,实现在QQ机器人单聊中,通过自然语言直接与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 控制台的管理员权限。

集成QQ

1. 创建QQ机器人

  1. 前往腾讯QQ开放平台官网。在下方的龙虾专用入口单击去使用。

  2. 在手机登录区域,扫描二维码登录QQ账号。

  3. 单击创建机器人,生成新的QQ机器人。保存机器人的AppIDAppSecret

    重要

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

2. OpenClaw集成到QQ

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

在控制台配置channel,在应用详情 > 通道配置 > QQ中填入创建机器人时获取的App IDApp Secret单击应用

方案验证

前往QQ与创建好的机器人对话。

image