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 支持需桥接需桥接原生支持原生支持
部署难度数小时+审核数小时+不稳定30 秒5 分钟
封号风险社区方案有风险高无无

替代方案推荐

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

方案1：Telegram（最推荐）

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

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

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

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

方案3：Discord

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

OpenClaw Launch 一键部署

OpenClaw Launch 支持 Telegram + Discord + Web Chat 一键部署，无需服务器、无需代码、无需审核。选择平台、填入 Token、点击部署，30 秒内你的 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 机器人

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

开始部署