lch
发布于 2026-03-20 / 0 阅读
0

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

Embe dC law 最近更新了一个新的功能:

那就是可以

对接QQ 机器人

那么本期,就让我们把 QQ 机器人 直接接进 EmbedClaw,让 ESP32 上的 AI Agent 真正在 QQ 里“活起来”。

更关键的是, 这条链路走的是官方 QQBot 接入

Ap pI D + ClientSecret → token → gateway → websocket

设备主动连 QQ gateway,不需要设备暴露公网回调地址。

如果你也想把这个效果复现出来,下面就按实战顺序来:

配置→编译烧录→前置健康检查→ QQ 实测 →三段式排错

项目地址:

8259e06a-2444-11f1-96ea-92fbcf53809c.png

1

硬件和环境

ESP32-S3(建议 16MB Flash + PS RAM

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"// ===== 搜索工具(可选)=====#defineEC_SECRET_SEARCH_KEY"YOUR_TAVILY_API_KEY"// ===== 通道开关 =====// 本文只调 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:并行通道开关,本篇建议关掉减少排错干扰。

82733ca4-2444-11f1-96ea-92fbcf53809c.png

3

QQ 控制台配置

官方入口:

打开链接后按照官方指导如下四个步骤

827ea792-2444-11f1-96ea-92fbcf53809c.png

登录好后点击创建机器人

828a0042-2444-11f1-96ea-92fbcf53809c.png

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

我们还可以给我们的机器人取个好听的名字!

8298defa-2444-11f1-96ea-92fbcf53809c.png

4

编译、烧录、联网

1. 拉代码并同步默认配置

gitclonehttps://github.com/wireless-tag-com/EmbedClaw.gitcdEmbedClawcp sd kconfig.defaults.esp32s3 sdkconfig.defaults

2. 编译

idf.pyset-target esp32s3idf.py build

3. 烧录 + 串口监视

# Windows(示例 端口 COM5)idf.py -p COM5 flash monitor# Linux / macOS(示例端口 /dev/tty AC M0)idf.py -p /dev/ttyACM0 flash monitor

4. 首次配网

如果设备未保存过 Wi-Fi ,会进入配网模式。连接设备热点后打开:

完成配置后,设备会重启并切回正常联网模式。

82a48caa-2444-11f1-96ea-92fbcf53809c.jpg

5

QQ 机器人对话

这时候你就可以对机器人聊天了!

如果你也对我们开源的AI Agent 项目embedClaw感兴趣,欢迎提交Star、PR、Issue 我们一起把它打造成esp32上最好用的AI Agent: