EmbedClaw 最近更新了一個(gè)新的功能：

那就是可以

對(duì)接QQ機(jī)器人！

那么本期，就讓我們把QQ 機(jī)器人直接接進(jìn) EmbedClaw，讓 ESP32 上的 AI Agent 真正在 QQ 里“活起來(lái)”。

更關(guān)鍵的是，這條鏈路走的是官方 QQBot 接入：

AppID + ClientSecret → token → gateway → websocket

設(shè)備主動(dòng)連 QQ gateway，不需要設(shè)備暴露公網(wǎng)回調(diào)地址。

如果你也想把這個(gè)效果復(fù)現(xiàn)出來(lái)，下面就按實(shí)戰(zhàn)順序來(lái)：

配置→編譯燒錄→前置健康檢查→ QQ 實(shí)測(cè) →三段式排錯(cuò)

項(xiàng)目地址：

https://github.com/wireless-tag-com/EmbedClaw

1

硬件和環(huán)境

ESP32-S3（建議 16MB Flash + PSRAM）

ESP-IDF 5.x（推薦 5.5.2）

Python 3 + Git

這里推薦大家使用啟明云端自研WT9932S3-NANO開(kāi)發(fā)板，完美符合硬件要求。

2

設(shè)置配置文件

這一次的更新，再也不是直接修改倉(cāng)庫(kù)提供的ec_config.h 而是需要在main文件夾中創(chuàng)建ec_config.h 我們需要添加以下內(nèi)容：

#pragmaonce// ===== LLM（必填）=====#defineEC_LLM_API_KEY "YOUR_DASHSCOPE_API_KEY"http:// ===== 搜索工具（可選）=====#defineEC_SECRET_SEARCH_KEY"YOUR_TAVILY_API_KEY"http:// ===== 通道開(kāi)關(guān) =====// 本文只調(diào) QQ，建議先關(guān)掉其他通道減少變量#defineEC_FEISHU_ENABLE 0#defineEC_QQ_ENABLE 1// ===== QQ 配置（必填）=====#defineEC_QQ_APP_ID "YOUR_QQ_APP_ID"#defineEC_QQ_CLIENT_SECRET"YOUR_QQ_CLIENT_SECRET"

其中LLM和搜索功能的API Key可以參考上一期的配置：

ESP32里的AI Agent：EmbedClaw上手教程！啟明云端樂(lè)鑫代理及方案商

關(guān)鍵宏一眼看懂

EC_QQ_ENABLE：QQ 通道總開(kāi)關(guān)，不開(kāi)就不會(huì)走 QQ 鏈路。

EC_QQ_APP_ID：QQ 應(yīng)用身份標(biāo)識(shí)，填錯(cuò)直接 token 失敗。

EC_QQ_CLIENT_SECRET：QQ 鑒權(quán)密鑰，填錯(cuò)同樣會(huì)卡在 token。

EC_FEISHU_ENABLE：并行通道開(kāi)關(guān)，本篇建議關(guān)掉減少排錯(cuò)干擾。

3

QQ 控制臺(tái)配置

官方入口：

https://q.qq.com/qqbot/openclaw/index.html

打開(kāi)鏈接后按照官方指導(dǎo)如下四個(gè)步驟

登錄好后點(diǎn)擊創(chuàng)建機(jī)器人

然后就能看到我們需要的AppID和AppSecret。

我們還可以給我們的機(jī)器人取個(gè)好聽(tīng)的名字！

4

編譯、燒錄、聯(lián)網(wǎng)

1. 拉代碼并同步默認(rèn)配置

gitclonehttps://github.com/wireless-tag-com/EmbedClaw.gitcdEmbedClawcpsdkconfig.defaults.esp32s3 sdkconfig.defaults

2. 編譯

idf.pyset-target esp32s3idf.py build

3. 燒錄 + 串口監(jiān)視

# Windows（示例端口 COM5）idf.py -p COM5 flash monitor# Linux / macOS（示例端口 /dev/ttyACM0）idf.py -p /dev/ttyACM0 flash monitor

4. 首次配網(wǎng)

如果設(shè)備未保存過(guò) Wi-Fi，會(huì)進(jìn)入配網(wǎng)模式。連接設(shè)備熱點(diǎn)后打開(kāi)：

http://192.168.4.1

完成配置后，設(shè)備會(huì)重啟并切回正常聯(lián)網(wǎng)模式。

5

QQ 機(jī)器人對(duì)話

這時(shí)候你就可以對(duì)機(jī)器人聊天了！

如果你也對(duì)我們開(kāi)源的AI Agent 項(xiàng)目embedClaw感興趣，歡迎提交Star、PR、Issue 我們一起把它打造成esp32上最好用的AI Agent：

https://github.com/wireless-tag-com/EmbedClaw