OpenClaw QQ 機器人頻道
透過社群插件將 OpenClaw 連接到 QQ（非 OpenClaw 官方內建頻道）。QQ 插件由社群開發和維護，與 OpenClaw 核心分離安裝，功能和相容性由插件作者負責。此整合支援私聊、群聊（@觸發）、頻道訊息、頻道私信、富媒體訊息（圖片、音訊、影片、檔案）、語音轉文字、定時訊息、Markdown 格式及引用訊息上下文。安裝外掛、在 QQ 開放平台建立機器人、設定憑證即可啟動。
QQ 支援功能
文字訊息
支援
媒體與檔案
支援
表情回應
不支援
討論串
不支援
語音訊息
支援
群組聊天
支援
QQ 前置條件
- 擁有 QQ 開放平台的開發者帳號
- 已安裝 QQ 外掛：openclaw plugins install @openclaw-china/qqbot
- OpenClaw Gateway 已執行並設定
- 伺服器已安裝 Node.js 18+
QQ 快速設定
安裝 QQ 外掛
在終端機中執行 'openclaw plugins install @openclaw-china/qqbot' 安裝騰訊官方維護的 QQ 機器人外掛。該外掛在 GitHub 上已獲得 186 顆星。
在 QQ 開放平台建立機器人
登入 QQ 開放平台（q.qq.com），建立新的機器人應用。在應用設定頁面取得 AppID 和 ClientSecret 憑證。這些是連接 OpenClaw 與 QQ 的必要資訊。
設定權限
在 QQ 開放平台的權限管理頁面，為機器人設定所需權限。啟用私聊訊息、群聊訊息、頻道訊息等相關權限，以及媒體訊息傳送權限。完成後提交審核。
設定 OpenClaw 並測試
建議：執行 'openclaw china setup' 啟動互動式設定精靈。或手動在 ~/.openclaw/openclaw.json 中新增 QQ 頻道設定，填入 appId 和 clientSecret。執行 'openclaw gateway restart' 重新啟動 Gateway，在 QQ 中向機器人傳送訊息測試是否正常運作。
QQ 設定範例
{
"channels": {
"qqbot": {
"enabled": true,
"appId": "your-app-id",
"clientSecret": "your-app-secret",
"sandbox": false,
"dmEnabled": true,
"groupEnabled": true,
"channelEnabled": true
}
}
}QQ 整合詳解
OpenClaw QQ 架構概述
OpenClaw QQ 外掛安裝
# 安裝 QQ 外掛
openclaw plugins install @openclaw-china/qqbot
# 確認安裝
openclaw plugins list
# 更新外掛
openclaw plugins update @openclaw-china/qqbot
# 啟動互動式設定精靈
openclaw china setupOpenClaw QQ 機器人建立
# 透過環境變數
export QQ_APP_ID="your-app-id"
export QQ_CLIENT_SECRET="your-app-secret"
# 或透過 CLI
openclaw channels addOpenClaw QQ 訊息類型與媒體支援
OpenClaw QQ 群聊與頻道設定
{
"channels": {
"qqbot": {
"dmEnabled": true,
"groupEnabled": true,
"channelEnabled": true
}
}
}OpenClaw QQ 常用指令
QQ 設定參考
| Key | Type | Default | Description |
|---|---|---|---|
| enabled | boolean | true | 啟用或停用 QQ 頻道 |
| appId | string | "" | QQ 機器人的 AppID，從 QQ 開放平台取得 |
| clientSecret | string | "" | QQ 機器人的 ClientSecret，從 QQ 開放平台取得 |
| sandbox | boolean | false | 啟用沙箱模式，用於開發和測試環境 |
| dmEnabled | boolean | true | 啟用私聊訊息回覆 |
| groupEnabled | boolean | true | 啟用群聊訊息回覆（需 @觸發） |
| channelEnabled | boolean | true | 啟用 QQ 頻道訊息回覆 |
| messageFormat | string | "markdown" | 回覆訊息格式。選項：text（純文字）、markdown |
| debug | boolean | false | 開啟偵錯模式，輸出詳細的連線和訊息日誌 |
啟用或停用 QQ 頻道
QQ 機器人的 AppID，從 QQ 開放平台取得
QQ 機器人的 ClientSecret，從 QQ 開放平台取得
啟用沙箱模式，用於開發和測試環境
啟用私聊訊息回覆
啟用群聊訊息回覆（需 @觸發）
啟用 QQ 頻道訊息回覆
回覆訊息格式。選項：text（純文字）、markdown
開啟偵錯模式，輸出詳細的連線和訊息日誌
QQ 常見問題
QQ 故障排除
AppID 或 ClientSecret 錯誤、外掛未正確安裝、或機器人未通過平台審核。
QQ 伺服器對主動訊息有過濾機制，非回覆類型的訊息可能被攔截。
缺少媒體訊息相關權限，或檔案大小超過 QQ 平台限制。
channelEnabled 未啟用，或機器人未被新增到 QQ 頻道中。
語音辨識服務異常或權限不足。