OpenClaw與QQ頻道完美對接，操作簡單一步到位

OpenClaw與QQ頻道完美對接，操作簡單一步到位

大家好，我是星哥，最近在Win11下養(yǎng)了一只龍蝦，需要接入qq，它能接管電腦操作、執(zhí)行各類指令，而接入QQ頻道后，我們無需切換應(yīng)用，在熟悉的QQ界面就能直接操控OpenClaw，實現(xiàn)“聊天框里辦大事”的便捷體驗。

本文將手把手教你完成OpenClaw添加QQ頻道的全流程，從前期準(zhǔn)備到實操配置，再到故障排查，全程干貨無冗余，新手也能輕松上手。

一、前置條件

• ? 已安裝并正常運行 OpenClaw（本地 / 服務(wù)器均可）

• ? 已完成實名認(rèn)證的 QQ 賬號（個人 / 企業(yè)）

首先確認(rèn)你的OpenClaw已成功部署，且版本為最新（舊版本可能不支持QQ頻道插件）。部署環(huán)境需滿足：Windows（建議安裝WSL2，原生Windows兼容性較差）、macOS 10.15+或Linux（推薦Ubuntu）；同時已安裝Node.js ≥ 22（核心依賴），可通過終端輸入“node -v”查看版本是否達(dá)標(biāo)。

若未部署OpenClaw，可先通過官方腳本一鍵安裝（新手首選）：

macOS/Linux：curl -fsSL https://openclaw.ai/install.sh | bash
Windows（WSL2內(nèi)）：iwr -useb https://openclaw.ai/install.ps1 | iex

安裝完成后，輸入“openclaw --version”，顯示版本號即部署成功。

二、步驟 1：在 QQ 開放平臺創(chuàng)建機(jī)器人

1. 1. 訪問 QQ 開放平臺：https://q.qq.com/ 或?qū)偃肟?https://q.qq.com/qqbot/openclaw/login.html

2. 2. 掃碼登錄 → 完成實名認(rèn)證（個人 / 企業(yè)）

3. 3. 進(jìn)入「機(jī)器人管理」→ 點擊「創(chuàng)建機(jī)器人」，填寫名稱、頭像等信息

4. 4. 記錄AppID和AppSecret（AppSecret 僅顯示一次，務(wù)必保存）

5. 5. 開啟「私聊 / 群聊 / 頻道」權(quán)限，將你的服務(wù)器公網(wǎng) IP 加入 IP 白名單

官方指南

1.創(chuàng)建機(jī)器人-圖

2.記錄APPID和AppSecret

三、步驟 2：在 OpenClaw 配置 QQ 頻道（命令行） 1. 安裝 QQ Bot 插件

openclaw plugins install @sliverp/qqbot@latest

openclaw channels add --channel qqbot --token "你的AppID:你的AppSecret"

• ?--channel qqbot：固定頻道類型

• ?--token：格式為AppID:AppSecret

openclaw gateway restart

驗證

可以在你的qq開放平臺，點擊掃描聊天即可

完成之后問小龍蝦：

四、步驟 3：WebUI 可視化配置（可選）

如果不用命令行，可以在后臺操作。

1. 1. 訪問 OpenClaw WebUI（默認(rèn) http:// 服務(wù)器 IP:18789）

2. 2. 進(jìn)入「應(yīng)用管理」→「Channel 配置」

3. 3. 選擇「QQ」，填入 AppID、AppSecret → 點擊「添加并應(yīng)用」

4. 4. 重啟服務(wù)

五、步驟 4：驗證與使用

1. 1. 檢查服務(wù)狀態(tài)：

   openclaw status

   確保狀態(tài)為

   running/active

2. 2. 在 QQ 中添加機(jī)器人為好友，或拉入群 / 頻道

3. 3. 發(fā)送消息測試，正常回復(fù)即配置成功

后續(xù)若需修改、刪除QQ頻道配置，或管理插件，可直接使用以下命令，無需重復(fù)操作全流程：

# 查看已配置的所有頻道
openclaw channels list

 # 刪除QQ頻道配置
openclaw channels remove qqbot

 # 更新QQ頻道token（更換AppID或AppSecret時使用）
openclaw channels add --channel qqbot --token "新的AppID:新的AppSecret"

 # 查看QQ機(jī)器人插件狀態(tài)
openclaw plugins status

 # 禁用/啟用QQ機(jī)器人插件
openclaw plugins disable qqbot
openclaw plugins enable qqbot

到這里，OpenClaw 接入 QQ 頻道的完整流程就全部講完了。

對比，飛書、企業(yè)微信、釘釘?shù)姆绞剑琎Q頻道是最簡單最省事的。

OpenClaw添加QQ頻道的核心的是“插件適配+密鑰配置”，全程無需復(fù)雜的技術(shù)操作，只要按照步驟準(zhǔn)備好環(huán)境、安裝插件、獲取密鑰并配置，就能實現(xiàn)QQ頻道與OpenClaw的無縫對接。作為一款“能執(zhí)行、可擴(kuò)展”的開源AI智能體，接入QQ頻道后，我們可以更便捷地通過QQ下達(dá)指令，讓OpenClaw幫我們處理重復(fù)任務(wù)、執(zhí)行腳本、管理文件等，真正發(fā)揮其“數(shù)字員工”的價值。

若你在操作過程中遇到其他未提及的問題，可留言補充，或查看OpenClaw官方社區(qū)的相關(guān)教程，也可通過“openclaw doctor”命令進(jìn)行環(huán)境診斷，快速定位問題所在。