OpenClaw 接入 QQ 机器人完整教程：注册、配置 AppID/Secret 到开始对话

OpenClaw 支持通过 QQ 开放平台接入 QQ 机器人，让你的 AI Agent 直接在 QQ 中与用户对话。本文覆盖从注册到上线的完整流程。

快速注册入口#

官方快速注册页面：https://q.qq.com/qqbot/openclaw/login.html

四步上线流程#

第一步：QQ 账号登录#

访问注册页面，使用 QQ 账号登录或扫描二维码，注册并登录你的 QQ 机器人开发者账号。

• 手机打开 QQ → 扫一扫页面上的二维码
• 或直接用 QQ 账号密码登录

第二步：创建 QQ 机器人#

登录后创建你的 QQ 机器人账号：

1. 点击「创建机器人」
2. 自定义机器人头像和名称
3. 填写机器人用途描述
4. 提交审核（通常较快）

创建完成后，你会获得两个关键凭证：

• AppID（机器人 ID）
• AppSecret（密钥）

第三步：配置到 OpenClaw#

将 AppID 和 AppSecret 填入 OpenClaw 配置文件 ~/.openclaw/openclaw.json：

{
  "channels": {
    "qq": {
      "enabled": true,
      "appId": "你的AppID",
      "appSecret": "你的AppSecret"
    }
  }
}

或通过环境变量配置（更安全）：

# 在 ~/.openclaw/.env 中添加
QQ_APP_ID=你的AppID
QQ_APP_SECRET=你的AppSecret

配置完成后重启 Gateway：

openclaw gateway restart

验证连接状态：

openclaw gateway status
openclaw logs --follow

第四步：打开 QQ 开始对话#

1. 在 QQ 中搜索你的机器人名称
2. 添加机器人为好友（或加入配置的群组）
3. 发送消息，AI Agent 即刻响应 🎉

权限与消息类型#

QQ 机器人平台支持以下消息场景：

常见问题#

问：审核需要多久？ 通常几分钟到几小时，个人开发者账号一般较快。

问：机器人在群里需要 @ 才能响应吗？ 默认需要 @ 机器人，可在 OpenClaw 配置中调整 requireMention 选项。

问：AppSecret 泄露怎么办？ 立即到 QQ 开放平台重置 AppSecret，并更新 OpenClaw 配置。

问：支持发送图片/文件吗？ 取决于 QQ 机器人平台的权限开放程度，基础文字消息始终支持。

与其他频道对比#

快速注册链接#

👉 立即注册 QQ 机器人开发者账号

来源：QQ 开放平台 OpenClaw 快速注册页 | https://q.qq.com/qqbot/openclaw/login.html