OpenClaw QQ 机器人接入配置教程 2026 完整指南

QQ 仍是国内最活跃的社交平台之一，接入 QQ 可以让 AI 覆盖更广泛的用户群。这篇教程讲解两种接入方式和各自的优缺点。

两种接入方式对比

方式	官方 QQ 开放平台	go-cqhttp 协议
合规性	✅ 完全合规	⚠️ 存在风险
稳定性	✅ 官方维护	⚠️ 协议可能失效
功能	⚠️ 有限制	✅ 功能丰富
申请难度	⚠️ 需要资质	✅ 即开即用
风险	无	账号封禁风险

推荐： 企业用户使用官方 QQ 开放平台，个人用户慎重考虑 go-cqhttp 的风险。

---

方式一：官方 QQ 开放平台（推荐）

适用场景

• 企业官方服务号
• 需要合规稳定
• 接受功能限制

Step 1：注册 QQ 开放平台账号

1. 访问 QQ 开放平台
2. 使用 QQ 号登录
3. 完成开发者认证（需要企业资质或个人实名）

Step 2：创建机器人

1. 进入【机器人管理】

2. 点击【创建机器人】

3. 填写基本信息：

   • 机器人名称
   • 机器人简介
   • 头像

4. 提交审核（1-3 个工作日）

Step 3：获取凭证

审核通过后，获取：

凭证	说明
AppID	机器人唯一标识
AppSecret	机器人密钥
Token	消息验证令牌

Step 4：配置 OpenClaw

在 ~/.openclaw/openclaw.json 中配置：

{
  "channels": {
    "qqbot": {
      "appId": "你的AppID",
      "clientSecret": "你的AppSecret",
      "token": "你的Token"
    }
  }
}

或使用命令：

openclaw config set channels.qqbot.appId "你的AppID"
openclaw config set channels.qqbot.clientSecret "你的AppSecret"
openclaw config set channels.qqbot.token "你的Token"

Step 5：启动服务

# 启动 OpenClaw
openclaw start

# 检查通道状态
openclaw channel status qqbot

Step 6：测试机器人

在 QQ 中添加机器人好友，发送测试消息：

你好，请介绍一下你自己

---

方式二：go-cqhttp 协议（风险提示）

⚠️ 重要风险提示

go-cqhttp 使用非官方协议，存在以下风险：

• 账号封禁：腾讯可能封禁使用的 QQ 号
• 协议失效：腾讯更新协议后可能无法使用
• 合规问题：可能违反腾讯服务条款

建议：仅用于学习测试，不要用于生产环境。

适用场景

• 个人学习测试
• 私有化部署
• 接受风险的用户

Step 1：下载 go-cqhttp

# 下载最新版
# https://github.com/Mrs4s/go-cqhttp/releases

# 解压
unzip go-cqhttp-linux-amd64.zip
cd go-cqhttp

Step 2：首次运行生成配置

./go-cqhttp

# 选择通信方式：3（正向 Websocket）

Step 3：编辑配置文件

config.yml：

account:
  uin: 你的QQ号
  password: '你的密码'

servers:
  - ws:
      host: 127.0.0.1
      port: 6700

Step 4：登录 QQ

./go-cqhttp

# 扫码登录或密码登录

Step 5：配置 OpenClaw

{
  "channels": {
    "qq": {
      "type": "go-cqhttp",
      "wsUrl": "ws://127.0.0.1:6700",
      "accessToken": "你的access-token"
    }
  }
}

Step 6：启动服务

# 先启动 go-cqhttp
./go-cqhttp &

# 再启动 OpenClaw
openclaw start

---

QQ 机器人功能对比

官方 QQ 开放平台

功能	支持
私聊消息	✅
群聊消息	✅
图片消息	✅
文件传输	⚠️ 限制
群管理	⚠️ 限制

go-cqhttp

功能	支持
私聊消息	✅
群聊消息	✅
图片消息	✅
文件传输	✅
群管理	✅
群成员管理	✅

---

常见问题

问题一：机器人回复 "gone to Mars"

原因： 凭证未配置或 Gateway 未启动

解决：

# 检查配置
openclaw config get channels.qqbot

# 检查服务状态
openclaw status

问题二：没有入站消息

原因： AppID 或 Secret 配置错误

解决：

1. 检查 QQ 开放平台的凭证是否正确
2. 确认机器人已启用
3. 查看 OpenClaw 日志：

openclaw logs -f | grep qq

问题三：go-cqhttp 登录失败

原因： 腾讯风控或协议更新

解决：

1. 使用新注册的 QQ 号
2. 降低消息频率
3. 更新 go-cqhttp 版本

问题四：账号被封

原因： 使用非官方协议

解决：

申诉解封，但成功率低。建议使用官方 QQ 开放平台。

---

最佳实践

实践一：优先使用官方方式

官方 QQ 开放平台虽然功能有限，但合规稳定，适合长期使用。

实践二：准备备用方案

QQ 接入可能不稳定，准备微信、钉钉等备用通道。

实践三：控制消息频率

避免频繁发送消息，防止触发风控。

实践四：敏感内容过滤

在 Agent 配置中添加敏感词过滤：

{
  "agents": {
    "qq-agent": {
      "contentFilter": {
        "enabled": true,
        "blocklist": ["敏感词1", "敏感词2"]
      }
    }
  }
}

---

合规建议

使用官方 QQ 开放平台

1. 申请企业认证
2. 遵守 QQ 开发者协议
3. 不发送营销内容
4. 提供明确的服务说明

避免使用非官方协议

• go-cqhttp 等第三方协议违反腾讯服务条款
• 账号被封无法申诉
• 不适合商业用途

---

总结

方式	推荐指数	说明
官方 QQ 开放平台	⭐⭐⭐⭐⭐	合规稳定，功能受限
go-cqhttp	⭐⭐	风险高，仅限测试

快速选择：

• 企业用户 → 官方 QQ 开放平台
• 个人用户 → 考虑其他平台（微信、钉钉、Telegram）
• 学习测试 → go-cqhttp（注意风险）

QQ 接入的核心是合规。官方方式虽然功能有限，但长期稳定。第三方协议风险高，不建议用于生产环境。如果 QQ 不是刚需，可以考虑微信、钉钉、Telegram 等平台，这些平台的接入更加成熟稳定。