OpenClaw集成QQ

更新时间:
复制为 MD 格式

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

环境准备

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

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

步骤一、购买OpenClaw套餐

重要

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

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

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

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

    • 地域:默认北京

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

步骤二、配置OpenClaw

OpenClaw 提供两种配置方式,请根据您的镜像版本切换以下页签查看对应的操作步骤。

OpenClaw 2026.5.19 及以上版本(推荐)

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

  2. 在应用详情页左下角单击初始化按钮,根据弹出的初始化向导完成步骤 1:模型配置

    • 大模型平台:从下拉框中选择模型厂商,支持阿里云百炼 Token Plan(团队版)、阿里云百炼 Coding Plan、阿里云百炼、deepseek、Kimi、GLM Coding Plan、智谱等多家厂商。

    • API Key:选择 API Key 对应的地域,并填入 API Key。

    • 模型:选择或手动输入模型名。

    配置完成后单击立即配置进入下一步。

  3. 在初始化向导步骤 2:使用 Web UI中,需要先在放通 OpenClaw 访问端口区域单击确定放通完成端口放通,然后单击登录 Web UI即可跳转到 OpenClaw WebUI,与 OpenClaw 的 Agent 对话。

    重要

    端口放通将使服务暴露于公网。初始化完成后,可在应用详情页顶部状态栏的公网访问开关一键关闭,详见如何开启/关闭OpenClaw WebUI的公网访问

  4. (可选)查看 Token。初始化完成后,在应用详情页顶部状态栏的Token字段单击复制按钮即可获取完整 Token。

    警告

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

OpenClaw 2026.5.19 之前版本

  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对应的地域一致,否则会导致模型无法正常调用。
    重要

    初始化过程中暂不支持配置百炼 Token Plan,强行输入会导致报错。如需使用 Token Plan,请先完成初始化,再参见如何在 OpenClaw 中接入百炼 Token Plan 团队版?进行配置。

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

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

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

    警告

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

集成QQ

OpenClaw 提供两种 QQ 集成方式,请根据您的镜像版本切换以下页签查看对应的操作步骤。

OpenClaw 2026.5.19 及以上版本(推荐)

推荐使用新版控制台扫码方式,免开发者注册,扫码授权后自动生效。

  1. 登录轻量应用服务器控制台,找到目标 OpenClaw 服务器,进入应用详情页签。

  2. 通道 (Channels)卡片中,单击添加通道

  3. 在通道下拉框中选择 QQ

  4. 保持默认选中的扫码接入 IM页签,单击扫码配置

  5. 使用 QQ 手机端扫描弹窗中的二维码,按提示完成授权后即自动生效,无需额外操作。

OpenClaw 2026.5.19 之前版本

需要在 QQ 开放平台手动创建机器人,并将 AppID 和 AppSecret 填入控制台。

1. 创建QQ机器人

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

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

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

    重要

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

2. OpenClaw集成到QQ

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

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

方案验证

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