📌 前言

如果你已经按照我之前的教程，在 Windows 11 上本地部署好了 Hermes（或者配置好了小龙虾 OpenClaw 自动化环境），今天这篇教程就带你走官方合规通道，把大模型直接接入 QQ 机器人，不走第三方模拟协议，安全稳定不风控！

🛠️ 第一步：前往 QQ 开放平台创建官方机器人

腾讯这次给个人开发者准备了非常便捷的“绿色通道”，不需要复杂的企业资质。

1. 登录专用入口：打开浏览器，访问 QQ 开放平台的龙虾/智能体专用专区：q.qq.com 。

2. 创建机器人：使用你的 QQ 账号登录，点击 「创建机器人」。

3. 完善基本信息：填写你的机器人名称（例如：Hermes助理）、上传头像。

   💡 注：单个 QQ 号码目前最多可一键创建 5 个 独立的官方机器人。

4. 获取核心凭证：创建成功后，页面会直接展示 AppID，点击查看并复制 AppSecret（密钥）。

   ⚠️ 安全提示：AppSecret 只会完整显示一次，请务必妥善保存到记事本中！

⚙️ 第二步：配置本地环境（两套主流方案任选）

既然你本地已经部署好了 Hermes，根据你的具体运行环境，选择以下方案 A 或方案 B 进行绑定：

方案 A：直接合入开源 Hermes Agent（官方原生支持）

如果你使用的是 Nous Research 开源的 Hermes Agent（具备跨会话记忆与自我进化能力的 Agent 框架）：

1. 打开你本地的 Hermes Agent 配置文件（通常为 config.yaml 或 .env）。

2. 找到 Messaging Platforms（通讯平台）部分，将通道选择为 QQ Bot。

3. 填入你刚才在官方平台申请的凭证：

PLATFORM: "qq_bot"

QQ_APP_ID: "你的AppID"

QQ_APP_SECRET: "你的AppSecret"

HERMES_MODEL_ENDPOINT: "http://localhost:11434/v1" # 本地Ollama/LMStudio接口

4. 保存并重启 Hermes Agent，它就会自动通过官方长连接（WebSocket）挂载到你的 QQ 机器人上。

### 方案 B：联动“小龙虾（OpenClaw）”执行自动化任务
如果你的本地 Hermes 是作为大脑，配合**小龙虾（OpenClaw）**来实现浏览器自动化、多步骤任务编排等“数字员工”操作：

1. 启动本地的 OpenClaw（小龙虾）客户端。
2. 点击左下角的 **「设置」** -> 进入 **「远控通道」**。
3. 在通道列表中选择 **「QQ 机器人」**，点击 **「配置」**。
4. 将刚才复制的 `AppID` 和 `AppSecret` 粘贴进去，点击 **「连接」**。
5. 连接成功后，你的 QQ 机器人瞬间就拥有了执行本地电脑操作的能力！

---

## 💻 方案 C：自定义 Python 代码接入（更自由的魔改）

如果你想用纯代码完全掌控 Hermes 的回复逻辑，也可以利用官方接口写一个轻量中间件。

### 1. 安装官方依赖
```bash
pip install openai requests

2. 编写对接脚本 qq_hermes_official.py

Python

import time
import requests
from openai import OpenAI

# ================= 配置区域 =================
APP_ID = "你的官方AppID"
APP_SECRET = "你的官方AppSecret"
LOCAL_HERMES_URL = "http://localhost:11434/v1"  # 本地 Ollama 默认端口

client = OpenAI(base_url=LOCAL_HERMES_URL, api_key="ollama")
# ============================================

def get_access_token():
    """获取官方开放平台鉴权 Token"""
    url = f"https://api.bot.q.qq.com/oauth2/token"
    headers = {"Content-Type": "application/json"}
    payload = {
        "appId": APP_ID,
        "clientSecret": APP_SECRET
    }
    try:
        res = requests.post(url, json=payload, headers=headers).json()
        return res.get("access_token")
    except Exception as e:
        print(f"获取Token失败: {e}")
        return None

def ask_hermes(prompt):
    """调用本地 Win11 部署的 Hermes 大模型"""
    try:
        response = client.chat.completions.create(
            model="hermes3",
            messages=[
                {"role": "system", "content": "你是通过QQ官方接口接入的AI助理Hermes。"},
                {"role": "user", "content": prompt}
            ],
            max_tokens=400
        )
        return response.choices[0].message.content.strip()
    except Exception as e:
        return f"本地Hermes响应异常: {e}"

# 提示：实际开发中官方推荐使用 WebSocket 监听事件，此处为逻辑演示
if __name__ == "__main__":
    token = get_access_token()
    if token:
        print("✅ 成功连接QQ开放平台！官方机器人鉴权成功。")
        print("🤖 本地 Hermes 大脑就绪，开始在 Windows 11 环境提供支持。")
        # 接下来将 token 配置到长连接监听中即可，收发消息完全合规！
    else:
        print("❌ 鉴权失败，请检查 AppID 和 AppSecret。")

🎯 体验与测试

1. 打开手机或者桌面端 QQ，搜索你创建的机器人名字（或者在开放平台扫描你机器人的测试二维码）。

2. 测试私聊 / 群聊：直接向它发送指令。

   • 如果绑定了 Hermes Agent：你可以跟它聊天，让它帮你写代码、做翻译，它的回答还支持 Markdown 格式。

   • 如果绑定了 小龙虾（OpenClaw）：你甚至可以发一句 帮我下载今天最新的行业报告PDF，本地的 Win11 电脑就会自动打开浏览器帮你操作，完成后通过 QQ 把文件发还给你！

💡 官方通道有什么优势？（对比第三方协议）

📝 总结

腾讯这次开放“小龙虾”和“Hermes”的官方直连，极大地降低了我们折腾私有 AI 助理的门槛。如果你手里正好有一台已经部署了 Hermes 的 Win11 主机，闭着眼睛选这个官方方案就对了！

如果在绑定过程中遇到了 OAuth 鉴权失败 或者是 模型未响应 的问题，欢迎在评论区贴出你的报错日志，我们一起排查！

看都看到这里了，不点个 👍赞、⭐收藏 鼓励一下博主吗？我们下期见！

版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处。