原标题
《【花雕动手做】ESP32-S3 + MimiClaw 实战：通过飞书自然语言控制多色呼吸灯，打造炫酷嵌入式 AI 灯效》
——从单色点亮到多色呼吸，手把手教你扩展嵌入式 AI Agent 的“动态表情”

引言

在前面的实战中，我们已经实现了通过飞书发送“红”“绿”“蓝”等指令，让 ESP32‑S3 板载的 WS2812 RGB LED 瞬间切换颜色。然而，静态的常亮灯效终究缺少一点“灵气”。呼吸灯——那种平滑渐亮渐灭的效果，不仅能提供视觉反馈，更是嵌入式设备与人之间一种优雅的交互语言。

这里将详细介绍如何在 MimiClaw 框架下，为你的嵌入式 AI Agent 增加多色呼吸灯功能。你将看到：

• 如何设计一个支持任意 RGB 颜色的呼吸灯任务

• 如何将飞书自然语言指令（如“蓝色呼吸”“停止呼吸”）映射到对应的工具调用

• 如何通过预处理机制绕过 LLM，实现毫秒级响应的直接控制

• 完整的代码实现与扩展思路

本文假定你已经完成了开源项目迷你小龙虾 MimiClaw 的基础部署（包括Wi‑Fi、飞书、LLM 与搜索 API 配置等），并实现了基本的颜色控制。如未完成，请先参考前序文章。

一、呼吸灯的原理与设计目标

1.1 呼吸灯效果

呼吸灯的核心是亮度按周期性规律变化。对于 WS2812 这类全彩 LED，我们可以保持色调不变（例如红色），仅改变亮度值；也可以让整个色环循环，实现彩虹呼吸。

本文实现的目标：

• 支持任意 RGB 颜色的呼吸效果

• 通过飞书自然语言启动/停止不同颜色的呼吸

• 呼吸过程中不阻塞其他任务（如飞书消息接收）

• 响应速度毫秒级，不依赖 LLM API

1.2 技术选型

• 硬件：ESP32‑S3 开发板 + 板载 WS2812（GPIO 48）

• 框架：MimiClaw（基于 ESP‑IDF 5.5）

• 驱动：ESP‑IDF 官方 led_strip 组件（基于 RMT 外设）

• 任务调度：FreeRTOS 独立任务实现呼吸循环，不阻塞主循环

二、核心代码实现

2.1 呼吸灯任务的设计

呼吸灯需要一个独立的任务来不断更新 LED 亮度。为了支持任意颜色，任务中使用全局变量存储当前呼吸的目标 RGB 值，并实时计算当前亮度对应的 RGB 分量。

static TaskHandle_t s_breathing_task = NULL;
static bool s_breathing_enabled = false;
static uint8_t s_breathing_r = 255;
static uint8_t s_breathing_g = 0;
static uint8_t s_breathing_b = 0;

static void breathing_task(void *arg)
{
    int direction = 1;      // 1: 亮度递增，-1: 递减
    int brightness = 0;     // 当前亮度 0-255
    const int step = 5;     // 每次变化的步长
    const int delay_ms = 20; // 每步延时 20ms，一个完整周期约 5 秒

    while (s_breathing_enabled) {
        brightness += direction * step;
        if (brightness >= 255) {
            brightness = 255;
            direction = -1;
        } else if (brightness <= 0) {
            brightness = 0;
            direction = 1;
        }
        // 根据目标颜色和当前亮度比例计算实际 RGB
        uint8_t r = (s_breathing_r * brightness) / 255;
        uint8_t g = (s_breathing_g * brightness) / 255;
        uint8_t b = (s_breathing_b * brightness) / 255;
        ws2812_set(r, g, b);
        vTaskDelay(pdMS_TO_TICKS(delay_ms));
    }
    // 任务退出前关闭 LED
    ws2812_set(0, 0, 0);
    s_breathing_task = NULL;
    vTaskDelete(NULL);
}

关键点：

• 亮度使用线性增减，简单有效。如需更平滑的曲线，可改为正弦或指数映射。

• 任务每次迭代都会重新计算 RGB，因此可以在呼吸过程中随时改变目标颜色（但本实现要求先停止再重新启动）。

2.2 启动与停止接口

为了便于外部调用，封装了 breathing_start 函数，并注册为工具：

static esp_err_t breathing_start(uint8_t r, uint8_t g, uint8_t b, char *out, size_t len)
{
    if (s_breathing_task != NULL) {
        snprintf(out, len, "Breathing already running, stop first");
        return ESP_FAIL;
    }
    s_breathing_r = r;
    s_breathing_g = g;
    s_breathing_b = b;
    s_breathing_enabled = true;
    BaseType_t ret = xTaskCreate(breathing_task, "breathing", 2048, NULL, 5, &s_breathing_task);
    if (ret == pdPASS) {
        snprintf(out, len, "Breathing started (R=%d,G=%d,B=%d)", r, g, b);
        return ESP_OK;
    } else {
        s_breathing_enabled = false;
        snprintf(out, len, "Failed to start breathing task");
        return ESP_FAIL;
    }
}

停止函数则设置标志位，并等待任务自行退出：

static esp_err_t tool_breathing_stop_execute(const char *in, char *out, size_t len)
{
    if (s_breathing_task == NULL) {
        snprintf(out, len, "Breathing not running");
        return ESP_OK;
    }
    s_breathing_enabled = false;
    for (int i = 0; i < 50 && s_breathing_task != NULL; i++) {
        vTaskDelay(pdMS_TO_TICKS(10));
    }
    snprintf(out, len, "Breathing stopped");
    return ESP_OK;
}

2.3 注册工具到 MimiClaw

在 tool_registry.c 中注册两个工具：

mimi_tool_t breath_start = {
    .name = "breathing",
    .description = "Start red breathing effect",
    .input_schema_json = "{\"type\":\"object\",\"properties\":{},\"required\":[]}",
    .execute = tool_breathing_start_execute,
};
register_tool(&breath_start);

mimi_tool_t breath_set = {
    .name = "breathing_set",
    .description = "Start breathing with specific RGB color",
    .input_schema_json = "{\"type\":\"object\",\"properties\":{\"r\":{\"type\":\"integer\"},\"g\":{\"type\":\"integer\"},\"b\":{\"type\":\"integer\"}},\"required\":[\"r\",\"g\",\"b\"]}",
    .execute = tool_breathing_set_execute,
};
register_tool(&breath_set);

mimi_tool_t breath_stop = {
    .name = "breathing_stop",
    .description = "Stop breathing effect",
    .input_schema_json = "{\"type\":\"object\",\"properties\":{},\"required\":[]}",
    .execute = tool_breathing_stop_execute,
};
register_tool(&breath_stop);

其中 tool_breathing_set_execute 负责解析 JSON 参数并调用 breathing_start。

三、自然语言指令预处理

为了提高响应速度并避免 LLM 理解偏差，我们在 agent_loop.c 中增加预处理函数，直接匹配飞书消息中的关键词，并调用对应的工具。

3.1 匹配规则设计

static bool try_direct_command(const char *content, char *output, size_t output_size)
{
    // 去除首尾空白
    // ...

    // 匹配“蓝色呼吸”、“绿色呼吸”等
    if (strstr(content, "蓝色呼吸") != NULL || (strstr(content, "蓝") && strstr(content, "呼吸"))) {
        tool_registry_execute("breathing_set", "{\"r\":0,\"g\":0,\"b\":255}", output, output_size);
        return true;
    }
    if (strstr(content, "绿色呼吸") != NULL || (strstr(content, "绿") && strstr(content, "呼吸"))) {
        tool_registry_execute("breathing_set", "{\"r\":0,\"g\":255,\"b\":0}", output, output_size);
        return true;
    }
    if (strstr(content, "红色呼吸") != NULL || (strstr(content, "红") && strstr(content, "呼吸"))) {
        tool_registry_execute("breathing", "{}", output, output_size);  // 红色呼吸默认工具
        return true;
    }
    // 纯“呼吸”默认为红色
    if (strstr(content, "呼吸") != NULL && strstr(content, "停止") == NULL) {
        tool_registry_execute("breathing", "{}", output, output_size);
        return true;
    }
    // 停止呼吸
    if (strstr(content, "停止呼吸") != NULL || strstr(content, "关呼吸") != NULL) {
        tool_registry_execute("breathing_stop", "{}", output, output_size);
        return true;
    }
    // ... 其他颜色指令（红、绿、蓝、灭等）
    return false;
}

3.2 集成到主循环

在 agent_loop_task 中，消息入队后首先调用 try_direct_command，如果匹配成功则直接回复并跳过 LLM 调用：

if (try_direct_command(msg.content, direct_response, sizeof(direct_response))) {
    ESP_LOGI(TAG, "Direct command matched, executing tool and responding");
    // 构造回复消息并推送
    continue;
}
// 否则走正常 LLM 流程

这种设计让固定指令获得毫秒级响应，同时保留了 LLM 处理复杂自然语言的能力。

四、测试与效果

五、实验结果记录：手机飞书通信截图与ESP32S3开发板板载WS2812的点灯情况（视频）

实验动图与视频

实验视频记录
【【花雕动手做】ESP32-S3 + MimiClaw 实战：通过飞书自然语言控制多色呼吸灯，打造炫酷嵌入式 AI 灯效——从单色点亮到多色呼吸的跨越】

https://www.bilibili.com/video/BV1kBDbB2ELZ/?share_source=copy_web&vd_source=371a292a55e5ca9be994cbb4a86cc987

六、扩展与优化方向

1、呼吸速度调节

可在 breathing_set 工具中增加 speed 参数，动态调整 delay_ms。

2、彩虹呼吸

编写一个任务让 HSV 色相随时间线性增加，实现七彩渐变呼吸。

3、传感器联动

例如温度高于 30°C 时自动启动红色呼吸报警，低于 20°C 启动蓝色呼吸。

4、多灯珠级联

如果你的 WS2812 灯带有多个灯珠，可以扩展 max_leds 参数，并实现流水呼吸效果。

5、Web 控制面板

注：经测试，MimiClaw 自带的 Web 门户（http://192.168.4.1）当前出现“invalid link”报错，暂时无法正常访问。后续可排查网络配置或固件问题，修复后可在 Web 门户增加呼吸灯控制按钮，提供图形化操作。

6、定时呼吸

利用 cron_add 工具，设置“每天 19:00 启动橙色呼吸，22:00 停止”，实现智能氛围灯。

六、总结

本文详细介绍了如何在 MimiClaw 嵌入式 AI Agent 框架上实现多色呼吸灯功能。通过 FreeRTOS 独立任务、工具注册和自然语言预处理，这里实现了：

• 任意 RGB 颜色的呼吸效果

• 飞书自然语言直接控制（支持中英文、混合词）

• 毫秒级响应，不消耗 LLM API

• 清晰的模块化代码，易于扩展

呼吸灯只是一个开始。同样的模式可以用于控制舵机、步进电机、显示屏等任何硬件外设。当你能够通过飞书聊天框让硬件“活”起来时，你已经掌握了嵌入式 AI Agent 的精髓——让 AI 不再局限于屏幕，而是真正融入物理世界。

项目源码：基于 MimiClaw 二次开发，欢迎 fork 和贡献。

如果你在实现过程中遇到任何问题，欢迎在评论区留言交流。

本文为“花雕学编程”与“花雕动手做”系列博客之一，聚焦嵌入式 AI Agent 、物联网与各种开源硬件落地控制的交叉实践。