EmbedClaw 最近更新了一個新的功能：

那就是可以

對接QQ機器人！

那么本期，就讓我們把QQ 機器人直接接進 EmbedClaw，讓 ESP32 上的 AI Agent 真正在 QQ 里“活起來”。

更關鍵的是，這條鏈路走的是官方 QQBot 接入：

AppID + ClientSecret → token → gateway → websocket

設備主動連 QQ gateway，不需要設備暴露公網回調地址。

如果你也想把這個效果復現出來，下面就按實戰順序來：

配置→編譯燒錄→前置健康檢查→ QQ 實測 →三段式排錯

項目地址：

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

1

硬件和環境

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

ESP-IDF 5.x（推薦 5.5.2）

Python 3 + Git

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

2

設置配置文件

這一次的更新，再也不是直接修改倉庫提供的ec_config.h 而是需要在main文件夾中創建ec_config.h 我們需要添加以下內容：

#pragmaonce// ===== LLM（必填）=====#defineEC_LLM_API_KEY "YOUR_DASHSCOPE_API_KEY"http:// ===== 搜索工具（可選）=====#defineEC_SECRET_SEARCH_KEY"YOUR_TAVILY_API_KEY"http:// ===== 通道開關 =====// 本文只調 QQ，建議先關掉其他通道減少變量#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上手教程！啟明云端樂鑫代理及方案商

關鍵宏一眼看懂

EC_QQ_ENABLE：QQ 通道總開關，不開就不會走 QQ 鏈路。

EC_QQ_APP_ID：QQ 應用身份標識，填錯直接 token 失敗。

EC_QQ_CLIENT_SECRET：QQ 鑒權密鑰，填錯同樣會卡在 token。

EC_FEISHU_ENABLE：并行通道開關，本篇建議關掉減少排錯干擾。

3

QQ 控制臺配置

官方入口：

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

打開鏈接后按照官方指導如下四個步驟

登錄好后點擊創建機器人

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

我們還可以給我們的機器人取個好聽的名字！

4

編譯、燒錄、聯網

1. 拉代碼并同步默認配置

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

2. 編譯

idf.pyset-target esp32s3idf.py build

3. 燒錄 + 串口監視

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

4. 首次配網

如果設備未保存過 Wi-Fi，會進入配網模式。連接設備熱點后打開：

http://192.168.4.1

完成配置后，設備會重啟并切回正常聯網模式。

5

QQ 機器人對話

這時候你就可以對機器人聊天了！

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

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