OpenClaw LaunchOpenClaw Launch
← 首页

平台接入

QQ 接入 OpenClaw 指南

了解如何将 OpenClaw AI 智能体接入 QQ 平台，包括 QQ 官方机器人、开放平台配置、群聊和私聊方案，以及替代部署推荐。

QQ 机器人现状

QQ 作为中国最大的社交平台之一，拥有庞大的用户群体。然而，QQ 机器人的开发和接入门槛相比 Telegram 和 Discord 要高得多。目前主要有以下几种途径：

QQ 官方机器人平台（q.qq.com）

腾讯官方提供了 QQ 机器人平台，但需要企业资质才能申请。个人开发者目前无法直接注册， 审核流程较为严格。官方机器人主要面向 QQ 频道（类似 Discord 的服务器），而非传统的 QQ 群聊。

QQ 开放平台

QQ 开放平台（q.qq.com）是腾讯为开发者提供的机器人管理平台。 通过该平台可以创建 QQ 频道机器人和 QQ 群机器人，但审核标准较高：

  • 需要企业营业执照或组织资质
  • 需要完成实名认证
  • 机器人功能需要经过腾讯审核
  • API 调用有频率限制

社区方案（第三方框架）

社区开发了一些第三方 QQ 机器人框架，如 go-cqhttp、NoneBot、Lagrange 等。这些框架通过逆向工程实现 QQ 协议， 可以让普通 QQ 号充当机器人。但需要注意：

  • 存在封号风险 — 腾讯会检测异常登录行为
  • 协议库需要持续维护，腾讯更新后可能失效
  • 稳定性无法保证，可能随时不可用
  • 违反 QQ 服务条款

QQ 官方机器人创建流程

如果你具备企业资质，可以通过 QQ 开放平台创建官方机器人：

1. QQ 开放平台注册

  1. 访问 q.qq.com，使用 QQ 号登录
  2. 完成开发者认证（需要企业营业执照）
  3. 填写开发者信息和联系方式
  4. 等待审核通过（通常 1-3 个工作日）

2. 创建机器人应用

  1. 在开放平台控制台选择「创建机器人」
  2. 填写机器人名称、描述和头像
  3. 选择机器人类型（频道机器人 / 群机器人）
  4. 配置机器人的功能范围

3. 获取 AppID 和 Token

创建成功后，在机器人管理页面可以获取关键凭证：

  • AppID — 机器人的唯一标识符
  • Token — 用于 API 认证的密钥
  • AppSecret — 用于签名验证

4. 配置 intents 和权限

QQ 机器人 API 使用 intents 机制来控制事件订阅：

  • PUBLIC_GUILD_MESSAGES — 接收频道公共消息
  • DIRECT_MESSAGE — 接收私信消息
  • GROUP_AT_MESSAGE_CREATE — 接收群聊 @机器人 消息
  • C2C_MESSAGE_CREATE — 接收单聊消息

OpenClaw + QQ 配置

OpenClaw 目前不原生支持 QQ，但可以通过以下方式实现对接：

配置示例

通过第三方桥接服务（如 onebot 协议适配器），可以将 QQ 消息转发到 OpenClaw。 以下是一个概念性的配置结构：

// 概念性配置 — 需要额外的桥接服务
{
  "channels": {
    "qq": {
      "enabled": true,
      "appId": "你的AppID",
      "token": "你的Token",
      "intents": ["GROUP_AT_MESSAGE_CREATE", "C2C_MESSAGE_CREATE"]
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "openrouter/anthropic/claude-sonnet-4"
      }
    }
  }
}

QQ channel 设置

QQ 机器人支持多种消息场景，需要根据使用场景选择合适的配置：

  • 频道消息 — 类似 Discord 服务器，机器人可以在频道中响应消息
  • 群聊消息 — 在 QQ 群中，通常需要 @机器人 才能触发回复
  • 私聊消息 — 用户直接与机器人一对一对话

群聊 vs 私聊

场景触发方式适用场景
群聊@机器人 + 消息群组助手、问答机器人、群管理
私聊直接发送消息个人AI助手、私密对话
频道频道内消息社区互动、公开问答

QQ vs 其他平台对比

选择合适的平台对于 AI 机器人的部署体验至关重要。以下是主流平台的对比：

特性QQ微信TelegramDiscord
用户群体中国最大社交平台之一中国最大即时通讯全球 9 亿+用户海外社区为主
Bot API官方有限无官方API完整开放完整开放
审核要求严格，需企业资质限制最多无审核无审核
个人开发者不支持不支持完全支持完全支持
OpenClaw 支持需桥接需桥接原生支持原生支持
部署难度数小时+审核数小时+不稳定10 秒5 分钟
封号风险社区方案有风险高无无

替代方案推荐

如果 QQ 官方机器人审核困难，或者你是个人开发者无法申请企业资质，我们强烈推荐以下替代方案：

方案1：Telegram（最推荐）

最简单、最快速的 AI 机器人部署方案。Telegram 是全球最流行的 AI 机器人平台， OpenClaw 原生完整支持，无需任何审核，个人开发者即可免费创建。

  • 10 秒部署，通过 OpenClaw Launch 一键完成
  • 无需企业资质，无需审核
  • 支持文本、图片、文件、语音等全部消息类型
  • 3,200+ Skills全部可用
  • 全球可用，稳定可靠

方案2：Web Chat（网页聊天）

OpenClaw 内置 Web UI，部署后直接在浏览器中使用。无需安装任何 App，手机和电脑均可访问。 可以将链接分享给任何人，无平台限制。

方案3：Discord

如果你的用户群主要在海外或游戏社区，Discord 是一个很好的选择。OpenClaw 原生支持 Discord， 创建 Bot 无需审核，适合社区和团队使用。

OpenClaw Launch 一键部署

OpenClaw Launch 支持 Telegram + Discord + Web Chat 一键部署， 无需服务器、无需代码、无需审核。选择平台、填入 Token、点击部署，10 秒内你的 AI 机器人就上线了。

常见问题（FAQ）

QQ 个人号能做机器人吗？

QQ 官方机器人平台不支持个人号注册为机器人。你需要通过 QQ 开放平台申请， 且需要企业营业执照。社区第三方框架可以让个人号充当机器人，但存在封号风险，不建议在生产环境使用。

申请 QQ 机器人需要什么资质？

需要企业营业执照或等效组织资质。个人开发者目前无法直接在 QQ 开放平台注册机器人。 如果你是个人开发者，推荐使用 Telegram，无需任何资质即可创建机器人。

QQ 机器人免费吗？

QQ 开放平台的基础 API 调用目前是免费的，但有频率限制。高级功能和更高的调用配额可能需要付费。 相比之下，Telegram Bot API 完全免费，没有调用限制。

QQ 群能用机器人吗？

QQ 群机器人需要通过 QQ 开放平台申请「群机器人」权限。审核通过后，机器人可以被添加到 QQ 群中， 用户通过 @机器人 触发交互。社区第三方框架也支持群聊场景，但同样存在稳定性和安全风险。

OpenClaw 什么时候原生支持 QQ？

OpenClaw 社区正在关注 QQ 机器人 API 的发展。由于 QQ 开放平台的限制较多且主要面向企业用户， 目前优先级较低。如果你需要在 QQ 上使用 AI 机器人，建议先通过桥接方案实现，或使用 Telegram 等原生支持的平台。

跳过审核，立即部署 AI 机器人

无需企业资质，10 秒在 Telegram 上线你的 AI 智能体。支持 Telegram + Discord + Web Chat。

开始部署