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

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

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

一、前置條件

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

• ? 已完成實名認證的 QQ 賬號（個人 / 企業）

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

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

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

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

二、步驟 1：在 QQ 開放平臺創建機器人

1. 1. 訪問 QQ 開放平臺：https://q.qq.com/ 或專屬入口 https://q.qq.com/qqbot/openclaw/login.html

2. 2. 掃碼登錄 → 完成實名認證（個人 / 企業）

3. 3. 進入「機器人管理」→ 點擊「創建機器人」，填寫名稱、頭像等信息

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

5. 5. 開啟「私聊 / 群聊 / 頻道」權限，將你的服務器公網 IP 加入 IP 白名單

官方指南

1.創建機器人-圖

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（默認 http:// 服務器 IP:18789）

2. 2. 進入「應用管理」→「Channel 配置」

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

4. 4. 重啟服務

五、步驟 4：驗證與使用

1. 1. 檢查服務狀態：

   openclaw status

   確保狀態為

   running/active

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

3. 3. 發送消息測試，正常回復即配置成功

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

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

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

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

 # 查看QQ機器人插件狀態
openclaw plugins status

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

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

對比，飛書、企業微信、釘釘的方式，QQ頻道是最簡單最省事的。

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

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