EmbedClaw可以使用QQ进行控制啦！

 

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 我们需要添加以下内容：

•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  

#pragma once// ===== LLM（必填）=====#define EC_LLM_API_KEY       "YOUR_DASHSCOPE_API_KEY"// ===== 搜索工具（可选）=====#define EC_SECRET_SEARCH_KEY "YOUR_TAVILY_API_KEY"// ===== 通道开关 =====// 本文只调 QQ，建议先关掉其他通道减少变量#define EC_FEISHU_ENABLE 0#define EC_QQ_ENABLE     1// ===== QQ 配置（必填）=====#define EC_QQ_APP_ID        "YOUR_QQ_APP_ID"#define EC_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. 拉代码并同步默认配置

•  
•  
•  

git clone https://github.com/wireless-tag-com/EmbedClaw.git cd EmbedClawcp sdkconfig.defaults.esp32s3 sdkconfig.defaults 

2. 编译

•  
•  

idf.py set-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