騰訊雲 OpenClaw 接入 QQ 機器人完整指南:從 0 到可聊天

約1分鐘
江蘇
2026-04-13
2026-05-01
5,355
I earn commissions when you shop through the links below, at no additional cost to you.

如果你已經把 OpenClaw 部署在雲伺服器上,那麼接入 QQ 的整體流程其實並不複雜:先去 QQ 開放平臺建立一個 QQ 機器人,拿到 AppIDAppSecret,再回到雲上 OpenClaw 的管理面板完成模型配置與通道配置,最後在 QQ 裡驗證機器人是否可以正常回復。騰訊雲這套接入方式走的是視覺化面板,不需要你再額外跑原生命令。

1. 開始前先準備好這幾樣東西

正式操作前,先確認你已經具備下面幾個條件:

  1. 有一個完成實名認證的 QQ 賬號。
  2. 已經在 Lighthouse 輕量應用伺服器裡部署好 OpenClaw。
  3. 如果你的 OpenClaw 例項是較早版本建立的,最好先更新到較新的應用版本再繼續配置。
  4. 如果你打算長期使用 QQ 通道,優先選擇國內伺服器和可穩定呼叫的模型服務。

2. 註冊並登入 QQ 開放平臺

先進入 QQ 開放平臺,使用手機 QQ 掃碼登入。如果你之前沒有註冊過,掃碼並授權後,平臺會自動幫你完成註冊並把當前 QQ 賬號繫結到開放平臺。完成後,你會進入 QQ 機器人的管理頁面。

3. 建立你的 QQ 機器人

進入 QQ 機器人頁面後,點選“建立機器人”,按頁面提示新建一個機器人。建立完成後,系統會生成兩個非常關鍵的引數:

  • AppID
  • AppSecret

把這兩個值立刻複製並儲存好,後面配置 OpenClaw 時必須用到。這裡尤其要注意,AppSecret 出於安全原因通常不會長期明文展示,之後再檢視時可能需要重置,所以第一次出現時一定要妥善儲存。

建立完成後,你在 QQ 客戶端裡一般已經能看到這個機器人出現在訊息列表中。不過此時它通常還不能正常工作,因為它只是“建好了”,還沒有真正和你的 OpenClaw 例項連通。原文裡提到,如果還沒完成雲端配置,和機器人對話時可能會看到“該機器人去火星了,稍後再試吧”這類提示。

4. 進入 OpenClaw 管理頁面

接下來回到騰訊雲控制檯,找到你部署 OpenClaw 的 Lighthouse 例項,進入例項詳情,再進入“應用管理”頁面。後面的模型設定和 QQ 通道設定,都在這裡完成。

5. 先把模型配置好

QQ 只是訊息進出的入口,真正負責理解和回覆內容的,還是你給 OpenClaw 配置的模型。所以在接通 QQ 之前,先確認模型 API Key 已經正確填寫,模型本身也能正常呼叫。

這一點非常重要,因為很多人以為“QQ 不回覆”是通道沒配好,實際上更常見的原因之一是模型沒配通、Key 填錯,或者模型服務本身不可用。原文也特別提醒過,模型配置是必需步驟,檢視模型熱門模型註冊地址

6. 配置 QQ 通道

模型確認沒問題後,再去做通道配置。

在“應用管理”頁面裡找到 Channel 配置區域,新增一個 QQ 通道,然後把你剛才儲存的 AppIDAppSecret 填進去,儲存並應用配置。系統處理完成後,頁面出現儲存成功,就說明 QQ 通道已經正式接入到 OpenClaw。

這一步如果引數填錯,最典型的現象就是你回到 QQ 後,機器人依舊無法正常回答,或者繼續提示異常狀態。所以一旦失敗,第一時間檢查的就是這兩個值有沒有複製錯誤、有沒有漏填、有沒有把舊的 Secret 填進去。

7. 回到 QQ 測試是否接入成功

完成模型配置和 QQ 通道配置以後,就可以回到手機 QQ 或電腦版 QQ,直接給機器人傳送訊息進行測試。只要它能像 AI 助手一樣正常理解並回復,就說明整條鏈路已經打通了。

這裡有個細節需要注意:不建議把這個 QQ 機器人直接拉進群裡做互動,至少在當前場景下,優先以單聊方式測試和使用會更穩妥。

8. 接入成功後能做什麼

在接通 QQ 之後,機器人不只是能收發普通文字。原文給出的能力範圍還包括:

  • 接收文字
  • 接收圖片
  • 接收檔案
  • 回覆文字
  • 回覆圖片
  • Markdown 格式回覆
  • 主動傳送訊息
  • 語音訊息
  • 回覆檔案

不過“歷史訊息引用”當前是不支援的。

另一個很關鍵的提醒是:QQ 只是通道,真正能不能識別圖片、生成圖片、處理檔案,仍然取決於你背後的模型能力。

比如你想讓機器人看圖,就要給 OpenClaw 配置支援視覺理解的模型;你想讓它出圖,就要接支援影象生成的模型。

9. 兩類最常見的問題

9.1. 機器人提示異常,無法對話

如果機器人回覆類似“去火星了,稍後再試吧”,優先檢查下面兩項:

  • 是否根本沒有在 OpenClaw 裡填寫 QQ 機器人的 AppIDAppSecret
  • 是否填入了錯誤的 AppIDAppSecret

9.2. 看起來接通了,但機器人就是不回訊息

這種情況通常不是 QQ 通道本身的問題,而是模型配置異常。比如 API Key 沒配好、模型不可用、模型呼叫失敗,都可能導致機器人收得到訊息卻回不出來。解決思路就是回到 OpenClaw 的模型配置頁,重新檢查模型接入狀態。

10. 總結

把 OpenClaw 接到 QQ 上,核心就四步:

  1. 部署好 OpenClaw
  2. 在 QQ 開放平臺建立機器人
  3. 儲存好 AppIDAppSecret
  4. 在雲端面板裡完成模型配置和 QQ 通道配置

只要這四步都做對,基本就能順利把 QQ 機器人變成你的 OpenClaw 對話入口。後面無論是做個人助理、檔案處理、圖文問答,還是定時提醒,都是在這個基礎上繼續擴充套件。

標籤: