AI 机器人 OpenClaw 怎么对接到 QQ？超详细教程（2026 最新版）

导读：为什么要把 OpenClaw 对接到 QQ？

QQ 作为国内最大的社交平台之一，月活用户超过 8 亿。把 OpenClaw AI 助理对接到 QQ，你可以：

• 在 QQ 群里自动回复用户问题
• 通过 QQ 消息控制 OpenClaw 发布文章
• 接收 OpenClaw 的任务完成通知
• 用手机 QQ 随时随地管理 AI 助理

这篇教程从零开始，详细到每一个点击步骤，跟着做就能完成对接。

一、环境准备（10 分钟）

1.1 硬件要求

• 电脑：Windows 10/11 或 macOS 10.15+
• 内存：至少 4GB（推荐 8GB）
• 硬盘：至少 10GB 可用空间
• 网络：稳定的互联网连接

1.2 软件要求

• Python：3.8 或更高版本
• Node.js：16.0 或更高版本
• QQ 账号：需要一个 QQ 号（建议用小号）
• OpenClaw：已安装并配置好

1.3 检查 Python 安装

打开命令提示符（Windows）或终端（macOS），输入：

python --version

如果显示 Python 3.8+，说明已安装。否则前往 python.org 下载安装。

1.4 检查 Node.js 安装

node --version

如果显示 v16+，说明已安装。否则前往 nodejs.org 下载安装。

二、安装 OpenClaw（20 分钟）

2.1 安装 OpenClaw

在命令提示符或终端中输入：

npm install -g openclaw

等待安装完成，可能需要 5-10 分钟。

2.2 验证安装

openclaw --version

如果显示版本号，说明安装成功。

2.3 初始化工作区

mkdir openclaw-workspace
cd openclaw-workspace
openclaw init

这会创建必要的配置文件和目录结构。

三、选择 QQ 对接方案

OpenClaw 对接 QQ 有两种主流方案，根据你的需求选择：

方案 A：go-cqhttp（推荐，免费）

• 优点：免费、开源、功能强大、社区活跃
• 缺点：需要一台 24 小时在线的设备
• 适合：个人用户、小团体使用

方案 B：QQ 官方机器人（收费，稳定）

• 优点：官方支持、稳定可靠、不易封号
• 缺点：需要企业资质、收费
• 适合：企业用户、商业应用

本教程使用方案 A（go-cqhttp），因为免费且适合大多数人。

四、安装 go-cqhttp（30 分钟）

4.1 下载 go-cqhttp

1. 访问 GitHub releases 页面：https://github.com/Mrs4s/go-cqhttp/releases
2. 下载对应系统的版本：
   • Windows：go-cqhttp_windows_amd64.exe
   • macOS：go-cqhttp_darwin_amd64
   • Linux：go-cqhttp_linux_amd64
3. 下载到本地，比如 C:\go-cqhttp\

4.2 首次运行

1. 打开命令提示符
2. 进入 go-cqhttp 目录：

   cd C:\go-cqhttp

3. 运行程序：

   go-cqhttp_windows_amd64.exe

4. 首次运行会提示配置，输入 1 选择正向 WebSocket

4.3 配置 QQ 登录

1. 编辑 config.yml 文件
2. 找到 account: 部分
3. 填写你的 QQ 号：

   account:
     uin: 你的 QQ 号
     password: ''  # 留空，会扫码登录

4.4 扫码登录

1. 再次运行 go-cqhttp
2. 会显示二维码
3. 用手机 QQ 扫码登录
4. 登录成功后，会显示 “登录成功”

4.5 配置 WebSocket

编辑 config.yml，找到 writers: 部分：

writers:
  - websocket
  - file

servers:
  - ws:
      address: 0.0.0.0:8080
      middlewares:
        access_token: "your_token"

五、配置 OpenClaw 接收 QQ 消息（30 分钟）

5.1 创建 QQ 监听脚本

在 OpenClaw 工作区创建 scripts/qq-listener.py：

#!/usr/bin/env python3
import websocket
import json
import requests

# go-cqhttp 的 WebSocket 地址
WS_URL = "ws://127.0.0.1:8080"
ACCESS_TOKEN = "your_token"

# OpenClaw 发布接口
PUBLISH_URL = "http://localhost:5000/publish"

def on_message(ws, message):
    data = json.loads(message)
    
    # 判断是否是群消息
    if data.get("post_type") == "message" and data.get("message_type") == "group":
        group_id = data.get("group_id")
        user_id = data.get("sender").get("user_id")
        message_text = data.get("raw_message")
        
        # 处理命令
        if message_text.startswith("发布文章："):
            title = message_text.replace("发布文章：", "").strip()
            
            # 调用 OpenClaw 发布
            result = publish_article(title)
            
            # 回复结果
            reply = f"✅ 发布成功！\n标题：{title}\n链接：{result['link']}"
            send_group_msg(group_id, reply)

def publish_article(title):
    # 调用 OpenClaw 发布接口
    response = requests.post(PUBLISH_URL, json={"title": title})
    return response.json()

def send_group_msg(group_id, message):
    data = {
        "action": "send_group_msg",
        "params": {
            "group_id": group_id,
            "message": message
        }
    }
    ws.send(json.dumps(data))

# 连接 WebSocket
ws = websocket.WebSocketApp(
    f"{WS_URL}?access_token={ACCESS_TOKEN}",
    on_message=on_message
)
ws.run_forever()

5.2 安装依赖

pip install websocket-client requests

5.3 运行监听脚本

py C:\Users\21221\.openclaw\workspace\scripts\qq-listener.py

六、测试 QQ 控制（10 分钟）

6.1 测试命令

在 QQ 群里发送：

发布文章：AI 绘图教程

6.2 预期结果

机器人应该回复：

✅ 发布成功！
标题：AI 绘图教程
链接：https://xcdaohang.cn/12345/.html

6.3 如果没反应

1. 检查 go-cqhttp 是否运行
2. 检查监听脚本是否运行
3. 检查 WebSocket 端口是否正确（默认 8080）
4. 检查 Access Token 是否一致

七、配置飞书通知（可选，20 分钟）

如果同时想接收飞书通知，参考之前的飞书对接教程。

八、常见问题解答

问题 1：go-cqhttp 登录失败？
建议：可能是账号异常，尝试用网页版 QQ 先登录一次，或者换个小号。

问题 2：WebSocket 连接失败？
建议：检查端口是否被占用，防火墙是否阻止。

问题 3：QQ 消息收不到？
建议：检查机器人是否在群里，群权限是否开启。

问题 4：发布文章失败？
建议：检查 OpenClaw 是否正常运行，WordPress 配置是否正确。

九、进阶功能

9.1 自定义命令

可以添加更多命令：

发布文章：标题     - 发布文章
查看状态          - 查看系统状态
今日统计          - 查看今日发布数据
帮助              - 查看帮助信息

9.2 定时任务

可以配置定时发送日报到 QQ 群：

每天 20:00 自动发送今日统计到 QQ 群

9.3 多群支持

一个 go-cqhttp 可以添加到多个群，每个群都能控制 OpenClaw。

十、安全建议

• 不要用主 QQ 号，建议用小号
• Access Token 妥善保管，不要泄露
• 配置群权限，只允许管理员使用命令
• 定期更新 go-cqhttp 到最新版本
• 监控异常登录，发现异常立即改密码

总结

OpenClaw 对接 QQ，可以让你在 QQ 群里就能控制 AI 助理。按照这个教程，一步步来，2-3 小时就能完成。

对接完成后，体验会提升一个档次：在 QQ 群里就能发布文章，查看统计，接收通知。

有问题欢迎评论区交流，看到都会回复！

---

分类：AI 教学 | 关键词：OpenClaw 对接 QQ | 阅读时间：约 25 分钟