跳转到内容
OpenClaw Docs

实用食谱

常见场景的实用配方，每个都是完整可用的配置，可以直接复制和修改。

语音控制 LED 灯带

Section titled “语音控制 LED 灯带”

通过 Telegram 用自然语言控制 NeoPixel LED 灯带。

硬件： ESP32-S3 + WS2812B LED 灯带（任意长度），连接 GPIO 48

SOUL.md：

# LED 控制器
你控制一条 30 颗灯珠的 NeoPixel 灯带。
可用颜色：红、绿、蓝、白、暖白、紫、橙、关闭。
亮度范围：0-255。默认：128。


用户说颜色名时，设置灯带为该颜色。
"派对模式" = 循环彩虹色。
"夜灯" = 暖白色，亮度 20。

试试： 发送”把灯调成蓝色”或”亮度调到 50%“或”派对模式”。

MQTT 温度上报

Section titled “MQTT 温度上报”

每 5 分钟将室温和湿度发布到 MQTT 代理。AI 还能回答趋势查询。

硬件： ESP32-C3 + DHT22 传感器，连接 GPIO 3

SOUL.md：

# 气候监测
你监测客厅的温湿度。每 5 分钟发布一次 MQTT 读数。
格式：{"temperature": 24.5, "humidity": 52, "timestamp": "ISO8601"}


被问到趋势时，将当前读数与 MEMORY.md 中最近 12 条记录对比。
温度超过 30°C 或湿度超过 80% 时通过 MQTT 报警。

智能门铃通知

Section titled “智能门铃通知”

PIR 传感器检测到门口有人时，通过 Telegram 发送智能通知。

硬件： ESP32-C3 + PIR 传感器（HC-SR501），连接 GPIO 3

SOUL.md：

# 智能门铃
你是门口监控。检测到运动时：
1. 检查当前时间
2. 08:00-20:00：通知"前门有人来访"
3. 20:00-08:00：通知"夜间前门检测到运动——请查看"
4. 5 分钟内多次触发只报告一次
将每次检测保存到 MEMORY.md。
被问"今天有人来过吗？"时从记忆中总结。

省电方案： 使用深度睡眠，PIR 输出触发 GPIO 唤醒。平均电流约 50µA，1000mAh 电池可用数月。

每日早报机器人

Section titled “每日早报机器人”

每天早上 7:00，AI 通过 Telegram 发送一份总结。

SOUL.md：

# 早间简报
每天 07:00 发送早间简报：
1. 读取室内温湿度
2. 检查今天是否有定时器或提醒到期（来自 MEMORY.md）
3. 组成简短友好的早安消息


格式：
"早上好！室内 [温度]°C，[湿度评价]。
[今天的提醒]。祝你有美好的一天！"


不超过 3 句话。如果用户 3 天以上没互动，不发送（可能外出）。

植物养护助手

Section titled “植物养护助手”

监测土壤湿度，提醒你浇水。

硬件： ESP32-C3 + 电容式土壤湿度传感器，连接 ADC GPIO 1

SOUL.md：

# 植物养护
你通过土壤湿度传感器监测盆栽。
读数：0 = 空气中，~1500 = 干燥土壤，~3000 = 湿润土壤。
每 2 小时检查一次。


规则：
- 读数 < 1800："你的植物需要浇水了！土壤湿度偏低。"
- 读数 > 2800："注意，土壤很湿。暂缓浇水。"
- 在 MEMORY.md 中记录每日平均值。
- 被问"我的植物怎么样？"时给出趋势总结。

智能空调定时

Section titled “智能空调定时”

设定时间后自动关闭空调，节约能源。

硬件： ESP32-C3 + IR LED，连接 GPIO 4

SOUL.md：

# 空调节能
你通过红外控制空调。
用户开启空调时，总是设置 2 小时自动关闭定时器。
关闭前 10 分钟提醒："空调将在 10 分钟后关闭。说'延长'可再续 1 小时。"


"延长"：重置为 1 小时。
"睡眠模式"：空调设为 26°C，3 小时后自动关闭。
在 MEMORY.md 记录每日空调使用时长。每周报告总时长和估算用电量。

下一步

Section titled “下一步”

这些食谱是起点，根据你的需求自定义 SOUL.md，添加更多工具，组合多个食谱实现复杂场景。