StoryClaw Docs

QQ 機器人

在 QQ 開放平台註冊機器人,取得 BotAppID 和 Token 並填入 StoryClaw 主控台,讓 AI 成員進入 QQ 群。

概述

QQ 機器人接入需要在 QQ 開放平台註冊機器人帳號,取得 BotAppID 和 Token,填入 StoryClaw 主控台完成綁定。
QQ 機器人目前僅支援 QQ 群使用,暫不支援 QQ 私聊場景。

前提條件

  • 已在 QQ 開放平台 完成開發者認證
  • 已在 StoryClaw 主控台建立並啟用了至少一個 AI 成員

接入步驟

1. 在 QQ 開放平台建立機器人

登入 q.qq.com,進入「機器人」管理頁面,點擊「建立機器人」,填寫機器人名稱和介紹,選擇「群機器人」類型,提交申請。

QQ 開放平台 — 建立機器人

2. 取得 BotAppID 和 Token

機器人建立成功後,在機器人詳情頁面找到「開發設定」,複製 BotAppID,並產生或複製 Token(Bot Token)。

QQ 機器人憑據 — BotAppID 和 Token

3. 在主控台填入憑據

進入 StoryClaw 主控台 → ClawBot 裝置 → 外掛 → QQ Bot,將 BotAppID 和 Token 貼到對應輸入框,選擇要綁定的 AI 成員,點擊「儲存」。

4. 將機器人加入 QQ 群

在 QQ 開放平台完成機器人審核並上線後,可透過機器人的 QQ 號將其邀請進群。群內 @ 機器人即可觸發 AI 成員回應。

常見問題

Q:機器人不回應群訊息

A:確認已在主控台完成 Token 設定,且 ClawBot 裝置在線;群內需要 @ 機器人觸發。

Q:Token 驗證失敗

A:在 QQ 開放平台重新產生 Token 並更新主控台中的設定。

On this page