通過 QQ 與 Hermes Agent 對話。
配置通道 - QQ
QQ 通道需在 QQ 開放平台創建機器人，再將獲得的 AppID 與 AppSecret 填入 LightVela。整個過程約 5–10 分鐘。
本頁覆蓋
-
在 QQ 開放平台註冊並創建機器人
-
獲取 AppID 與 AppSecret
-
在 LightVela 填入參數完成接入
-
在 QQ 中與 Hermes Agent 進行對話
操作步驟
1. 進入管理台
登錄 LightVela，點擊右上角「我的 Hermes」進入管理台，找到「通道 」按鍵。
2. 選擇 QQ 通道
點擊下拉框，選擇「QQ」。下方顯示 QQ 通道介紹。
3. 註冊 QQ 開放平台
訪問 QQ 開放平台，使用手機 QQ 掃描頁面上的二維碼進行註冊/登錄。首次訪問時，掃碼後系統會自動完成註冊，並將當前 QQ 與開放平台賬號綁定。
在手機 QQ 掃碼後選擇同意，即完成註冊，進入 QQ 機器人配置頁。
4. 創建 QQ 機器人
在 QQ 開放平台的機器人頁面，點擊「創建機器人」新建一個 QQ 機器人。
5. 獲取 AppID 與 AppSecret
機器人創建完成後，在頁面中找到 AppID 與 AppSecret，分別點擊右側「複製」按鈕，保存到本地記事本或備忘錄。
創建完成後，QQ 中會自動添加該機器人至消息列表，併發送第一條歡迎消息。此時尚未完成與 LightVela 的綁定，發送消息會收到"該機器人去火星了，稍後再試吧"——屬於正常現象，繼續下一步即可。
6. 在 LightVela 填入參數
回到管理台的「通道」卡片，下拉選擇「QQ」，將剛才複製的參數依次粘貼到輸入框：
-
AppID：粘貼已複製的 AppID
-
AppSecret：粘貼已複製的 AppSecret
7. 點擊「添加並應用」
LightVela 使用上述憑證連接 QQ 開放平台上的機器人，等待幾十秒後頁面提示保存成功，「已接入通道」列表中新增"QQ"記錄。
8. 在 QQ 中查找 Hermes Agent
回到 QQ，找到已創建的機器人，發送測試消息：
你好幾秒內收到 Hermes Agent 回覆。
成功狀態
-
QQ 開放平台上機器人已創建
-
管理台「已接入通道」列表中出現"QQ"
-
QQ 中的機器人能以 AI 方式正常回復消息
支持的消息類型
接入成功後，QQ 機器人除了能夠接收、回覆基礎文本信息外，還支持更多消息類型，詳情如下：
| QQ 機器人支持的消息類型和功能 | 是否支持 |
|---|---|
| 接收文本信息 | ✅ 已支持 |
| 接收圖片 | ✅ 已支持 |
| 接收文件 | ✅ 已支持 |
| 接收語音消息 | ✅ 已支持 |
| 回覆文本信息 | ✅ 已支持 |
| 回覆圖片 | ✅ 已支持 |
| 回覆文件 | ✅ 已支持 |
| 回覆內容支持 Markdown 格式 | ✅ 已支持 |
| 主動發送消息（如定時發送提醒） | ✅ 已支持 |
| 歷史消息引用 | ❌ 暫不支持 |
常見問題
| 現象 | 可能原因 | 處理方式 |
|---|---|---|
| 機器人回覆"我的'靈魂'不在線，請檢查你的主機服務部署環境" | 未在 LightVela 配置 AppID/AppSecret，或憑證錯誤 | 重新複製 QQ 開放平台的參數，確認首尾無空格後在 LightVela 重新填入 |
| 機器人回覆"該機器人去火星了，稍後再試吧" | QQ 機器人已創建但尚未與 LightVela 綁定 | 按本頁流程完成 AppID/AppSecret 的配置 |
| 完成所有配置後機器人仍不回覆 | 模型未配置或體驗積分耗盡 | 檢查「1. 模型」卡片的「當前模型」狀態 |
| 找不到 AppSecret | AppSecret 僅在創建時可見 | 在 QQ 開放平台點擊「重置密鑰」生成新值，再在 LightVela 重新填入 |
| AppSecret 泄露 | — | 前往 QQ 開放平台「重置密鑰」，並在 LightVela 重新填入新的 AppSecret |
| 二維碼過期 | 超過有效期未掃碼 | 關閉彈窗，重新點擊「授權接入」 |
通道説明
-
消息類型：支持文本、圖片、文件、語音等多種類型，詳見上方「支持的消息類型」
-
群聊支持：當前版本不建議將機器人加入 QQ 群聊
-
憑證管理：AppSecret 僅在創建時明文可見，遺失或泄露需重置
下一步
-
配置通道 - 企業微信 — 企業內部協作與辦公場景
-
配置通道 - 飛書 — 辦公場景，支持富文本與群聊
-
配置技能 — 擴展 Hermes Agent 能力