1. 项目缘起当代码成为“脱水剂”干了这么多年开发我发现自己有个老毛病一坐到电脑前敲起代码来就跟入了定似的。经常是早上倒的一杯水到中午发现一口没动全凉透了。等回过神来嗓子干得冒烟颈椎也开始抗议。这问题说大不大但长期下来对身体的影响是实实在在的。我也试过各种方法手机设闹钟吧经常被专注模式屏蔽掉或者顺手就关掉了用一些专门的健康提醒软件又觉得太臃肿动不动就是一堆社交、数据统计功能反而成了干扰。直到最近在折腾本地AI智能体接触到了OpenClaw。这名字挺有意思直译过来是“开放的爪子”其实它是一个开源的、模块化的AI智能体框架。简单说它就像一个乐高底座你可以给它装上不同的“技能”Skill比如查天气、控制智能家居或者像我需要的——定时提醒。它的核心魅力在于“本地化”和“可编程性”数据在自己手里功能完全由自己定义。看着它我灵光一闪能不能用OpenClaw结合最简单的硬件做一个极简、无干扰、专属于程序员的喝水提醒器成本要低最好手边零件就能搞定时间要短不能耽误正经开发工作。于是这个“一分钟手搓版”的想法就诞生了。所谓“手搓”不是真的只用一分钟从头开发一个AI框架而是利用OpenClaw已有的能力快速配置和对接一个外部提醒装置整个过程力求简洁高效。目标很明确当我沉迷代码时一个温和但无法忽视的物理信号比如灯光、声音会提醒我“嘿该喝水了”2. 核心思路OpenClaw 物理输出 无感提醒这个项目的核心逻辑非常直接就是让虚拟的AI智能体通过一个简单的桥梁去触动现实世界。整个系统的架构可以分为三层第一层大脑OpenClaw。它负责逻辑和调度。我们需要在OpenClaw中创建一个定时任务或者更灵活一点创建一个响应特定指令的Skill。这个Skill的逻辑很简单当到达预设时间或者接收到“提醒我喝水”的指令时就触发一个动作。第二层桥梁通讯接口。这是连接数字与物理世界的关键。OpenClaw运行在电脑上它需要一种方式告诉外部硬件“现在该动作了。”最通用、最简单的协议就是HTTP。我们可以在OpenClaw的Skill里当触发条件满足时向一个特定的本地URL发送一个HTTP GET或POST请求。第三层手脚执行单元。这是一个能接收HTTP请求并做出物理反应的设备。对于“一分钟手搓”这个目标我们需要一个极其简单、免开发的方案。这里首推ESP8266开发板比如NodeMCU它自带Wi-Fi能用Arduino IDE快速编程成本仅十几元。我们让它连接本地Wi-Fi并启动一个微型Web服务器。当它收到来自OpenClaw的特定HTTP请求时就控制一个GPIO引脚点亮一个LED灯或者让一个蜂鸣器响一声。为什么不直接用电脑弹窗或播放声音因为对于深度沉浸的开发者来说软件弹窗很可能被下意识地最小化或忽略而一个突然亮起的实体灯光或轻微的“嘀”声这种来自物理世界的信号更能穿透专注状态形成有效提醒。同时这个硬件可以放在显示器上方、键盘旁边等视线自然可及的地方不占用屏幕空间。注意选择ESP8266是因为其生态成熟有现成的库让它在几行代码内变成一个Web服务器。如果你手头有树莓派Raspberry Pi Pico W或者其他支持Wi-Fi的开发板原理也完全相通。3. 硬件准备与“手搓”要点虽然标题是“一分钟手搓”但实际的硬件搭建和基础编程还是需要一些时间的不过对于有动手能力的开发者来说确实可以在很短时间内完成。这里我们分解一下步骤。3.1 硬件清单与连接你需要准备以下东西大部分都能在电子配件店或网上轻松购得ESP8266开发板一块如NodeMCU或Wemos D1 mini。USB数据线一条用于供电和烧录程序。LED发光二极管一个任何颜色都可以作为视觉提醒。220欧姆电阻一个用于限流保护LED和ESP8266的GPIO引脚。面包板和杜邦线若干用于免焊接连接。如果想做得更永久也可以用焊锡直接焊接。连接电路非常简单这是一个典型的数字输出电路将ESP8266的3.3V引脚连接到面包板的正极电源轨。将ESP8266的GND引脚连接到面包板的负极电源轨。将LED的长脚正极阳极通过一个220欧姆电阻连接到ESP8266的某个GPIO引脚例如D4对应NodeMCU的GPIO2。将LED的短脚负极阴极直接连接到面包板的GND负极轨。这样就完成了硬件连接。接上USB线ESP8266应该会亮起电源指示灯。3.2 ESP8266固件编程这是“手搓”的核心编码部分但代码量非常小。你需要先安装Arduino IDE并添加ESP8266开发板支持具体教程网上很多搜索“Arduino IDE 安装 ESP8266”即可。接下来是完整的Arduino代码其功能是让ESP8266连接你的Wi-Fi并启动一个Web服务器。当访问根路径“/”时它会快速闪烁一下LED当访问特定路径如“/remind”时它会让LED亮起5秒作为提醒。#include ESP8266WiFi.h #include ESP8266WebServer.h // 你的Wi-Fi配置 const char* ssid 你的Wi-Fi名称; const char* password 你的Wi-Fi密码; // 创建Web服务器对象监听80端口 ESP8266WebServer server(80); // 定义LED引脚 const int ledPin 2; // NodeMCU上D4对应GPIO2 void handleRoot() { // 访问根路径时快速闪烁一下LED作为响应 digitalWrite(ledPin, HIGH); delay(100); digitalWrite(ledPin, LOW); server.send(200, text/plain, ESP8266 Reminder Server is Running.); } void handleRemind() { // 访问/remind路径时执行提醒动作LED亮5秒 digitalWrite(ledPin, HIGH); server.send(200, text/plain, Reminder Activated! LED ON for 5s.); delay(5000); // 保持亮灯5秒 digitalWrite(ledPin, LOW); } void handleNotFound() { server.send(404, text/plain, 404: Not Found); } void setup() { Serial.begin(115200); pinMode(ledPin, OUTPUT); digitalWrite(ledPin, LOW); // 连接Wi-Fi WiFi.begin(ssid, password); Serial.print(Connecting to ); Serial.println(ssid); while (WiFi.status() ! WL_CONNECTED) { delay(500); Serial.print(.); } Serial.println(); Serial.println(WiFi connected.); Serial.println(IP address: ); Serial.println(WiFi.localIP()); // 记住这个IP地址 // 设置服务器路由 server.on(/, handleRoot); server.on(/remind, handleRemind); // 这是我们给OpenClaw调用的关键接口 server.onNotFound(handleNotFound); // 启动服务器 server.begin(); Serial.println(HTTP server started); } void loop() { server.handleClient(); // 处理客户端请求 }代码要点解析server.on(“/remind”, handleRemind)这行代码是关键。它定义了一个路由当ESP8266的Web服务器收到对http://[ESP8266的IP地址]/remind的请求时就会执行handleRemind函数。handleRemind函数里我们先点亮LED然后立刻用server.send返回响应最后才执行delay(5000)。这样做是为了避免服务器在等待期间无法响应其他请求。虽然我们这个简单应用并发请求不多但这是一个好的编程习惯。上传代码前务必将ssid和password替换成你实际的Wi-Fi信息。上传成功后打开串口监视器查看ESP8266获取到的本地IP地址例如192.168.1.105记下它后面OpenClaw会用到。实操心得如果连接Wi-Fi一直失败检查密码是否正确或者尝试让手机热点作为Wi-Fi源有时公司网络有认证页面会导致连接失败。上传代码时如果遇到“上传错误”或端口问题确保在Arduino IDE的“工具”-“端口”菜单中选择了正确的COM口并且开发板型号选择正确如“NodeMCU 1.0”。测试在电脑浏览器里输入http://[ESP8266的IP地址]/remind回车你应该能看到LED亮起5秒并且浏览器显示“Reminder Activated!”的文字。这说明硬件和桥梁部分已经畅通。4. OpenClaw侧技能配置与触发逻辑现在“手脚”已经就位并且有了一个明确的触发地址http://[ESP-IP]/remind。接下来就是配置“大脑”OpenClaw让它学会在合适的时间去调用这个地址。4.1 OpenClaw技能创建原理OpenClaw的技能Skill本质是一个Python类它继承自基类并实现特定的方法。最核心的方法是_handle它定义了技能如何响应用户的指令或系统事件。对于定时任务OpenClaw通常可以通过其内置的调度器Scheduler或者通过响应自然语言指令如“每隔一小时提醒我喝水”来触发。为了最简化和最可控我们选择创建一个响应固定指令的技能。例如我们可以让技能响应“喝水提醒测试”这个指令一旦在OpenClaw的聊天窗口输入这个指令它就触发HTTP请求。首先你需要找到OpenClaw的技能目录。通常在你部署OpenClaw的目录下有一个skills或plugins文件夹。我们在里面创建一个新的Python文件比如叫water_reminder_skill.py。4.2 技能代码实现下面是这个喝水提醒技能的完整代码示例import requests from openclaw.skills.base import Skill from openclaw.skills.decorators import intent_handler class WaterReminderSkill(Skill): 一个简单的喝水提醒技能。 当收到特定指令时向ESP8266发送HTTP请求触发硬件提醒。 def __init__(self, name, path, config): super().__init__(name, path, config) # 从配置文件或硬编码获取ESP8266的IP地址和端口 self.esp_ip config.get(esp_ip, 192.168.1.105) # 默认IP请修改 self.remind_url fhttp://{self.esp_ip}/remind intent_handler(remind.drink.water) def handle_remind_intent(self, message): 处理‘提醒喝水’的意图 self.logger.info(接收到喝水提醒指令正在触发硬件...) try: response requests.get(self.remind_url, timeout5) if response.status_code 200: reply 提醒信号已发送看看你的LED灯亮了吗 else: reply f发送请求失败硬件返回状态码{response.status_code} except requests.exceptions.RequestException as e: self.logger.error(f连接硬件失败: {e}) reply 哎呀连接不上提醒硬件请检查网络或硬件状态。 # 将回复返回给用户在聊天窗口显示 self.speak(reply) def stop(self): pass代码关键点解析intent_handler(‘remind.drink.water’)这是一个装饰器它将下面的函数注册为对特定“意图”的处理程序。在OpenClaw中用户的自然语言指令会被解析成“意图”。我们需要在OpenClaw的NLU自然语言理解配置中将类似“提醒我喝水”、“该喝水了”这样的话术映射到remind.drink.water这个意图上。对于这个极简项目我们可以先简化直接在技能里响应固定关键词但使用意图是更规范的做法。requests.get(self.remind_url)这是发起HTTP GET请求的核心代码。当意图被触发时这行代码会向ESP8266的Web服务器发送请求。错误处理网络请求必须包含超时和异常处理。try…except块确保了即使硬件没开机或网络不通OpenClaw也不会崩溃而是给出友好的错误提示。self.speak(reply)这个方法会将文本回复发送到OpenClaw的对话界面让用户知道操作结果。更简单的触发方式定时任务如果不想依赖语音指令希望完全自动化定时触发可以利用Python的schedule库或OpenClaw可能提供的定时机制。可以在技能的__init__方法中启动一个后台线程来运行定时任务import threading import time import schedule class WaterReminderSkill(Skill): def __init__(self, name, path, config): super().__init__(name, path, config) self.esp_ip config.get(esp_ip, 192.168.1.105) self.remind_url fhttp://{self.esp_ip}/remind # 设置每45分钟触发一次 schedule.every(45).minutes.do(self._send_remind) # 启动定时任务线程 self._schedule_thread threading.Thread(targetself._run_scheduler, daemonTrue) self._schedule_thread.start() def _send_remind(self): self.logger.info(定时提醒发送喝水信号) try: requests.get(self.remind_url, timeout3) except Exception as e: self.logger.warning(f定时提醒发送失败: {e}) def _run_scheduler(self): while True: schedule.run_pending() time.sleep(1)这种方式实现了全自动后台提醒无需任何交互。4.3 技能安装与配置放置文件将写好的water_reminder_skill.py文件放到OpenClaw的技能目录下例如~/.openclaw/skills/或项目目录下的skills/文件夹。修改配置找到OpenClaw的配置文件通常是config.yaml或config.json在技能加载部分添加你的新技能。具体格式取决于OpenClaw版本大致如下skills: water_reminder: path: skills/water_reminder_skill config: esp_ip: 192.168.1.105 # 这里填写你ESP8266的实际IP配置意图如果你使用了intent_handler需要在OpenClaw的NLU训练数据文件中添加对应的意图和样本语句。例如在nlu.md文件中添加## intent:remind.drink.water - 提醒我喝水 - 该喝水了 - 喝水时间到 - 我渴了然后重新训练NLU模型。重启OpenClaw重启OpenClaw服务让它加载新技能。重要提示不同版本的OpenClaw在技能结构和配置上可能有差异。上述代码和步骤是基于通用模式的示例。实际操作时请务必查阅你所使用版本的OpenClaw官方文档或Wiki了解创建技能的确切方法。这是从“能用”到“用好”的关键一步。5. 系统联调与效果优化当硬件代码烧录完成、OpenClaw技能也配置好后就进入了联调阶段。这个过程就是让两端“握手”成功。5.1 基础连通性测试首先进行最基础的测试排除网络问题确保你的电脑和ESP8266在同一个局域网连接同一个Wi-Fi。在电脑的命令行CMD或终端里使用ping命令测试ESP8266的IP地址是否可达ping 192.168.1.105。如果能收到回复说明网络层是通的。在浏览器中再次访问http://[ESP-IP]/remind确认LED灯能正常响应。这一步验证硬件Web服务器工作正常。5.2 OpenClaw技能触发测试如果使用意图触发启动OpenClaw通常通过openclaw start命令。在OpenClaw的Web界面或命令行对话窗口中输入你训练的样本语句如“提醒我喝水”。观察OpenClaw的日志输出看是否识别到了remind.drink.water意图并进入了你的技能处理函数。同时观察ESP8266的LED灯是否被点亮以及OpenClaw的回复是否符合预期。如果使用定时任务触发启动OpenClaw后等待到你设置的时间间隔如45分钟。观察OpenClaw的日志应该会打印出“定时提醒发送喝水信号”之类的信息。同时观察LED灯是否被点亮。为了测试你可以将定时间隔暂时改为1分钟快速验证功能。5.3 常见问题与排查实录在实际操作中你可能会遇到以下问题这里是我的排查记录问题1OpenClaw日志显示技能加载失败报ModuleNotFoundError。排查这通常是因为技能文件的Python依赖问题或者文件路径不对。首先检查技能文件首行是否有拼写错误。其次检查技能类是否正确定义并继承自Skill。最后查看OpenClaw的依赖是否包含requests库如果没有需要在技能目录或OpenClaw的全局环境中安装pip install requests。解决确保技能文件在正确的目录类名和文件名无误并安装缺失的依赖包。问题2OpenClaw能识别意图但日志显示连接硬件超时或连接被拒绝。排查首先在电脑上直接用浏览器或curl命令访问http://[ESP-IP]/remind看是否能通。如果不通回到硬件排查。如果电脑能通但OpenClaw不通可能是OpenClaw运行在容器如Docker内。Docker容器默认有独立的网络命名空间可能无法直接访问宿主机的局域网IP。解决针对Docker部署方案A推荐在运行Docker容器时添加--networkhost参数让容器使用宿主机的网络栈这样容器内就能直接访问局域网IP了。命令如docker run --networkhost ...。方案B如果ESP8266的IP是192.168.1.105对于Mac和Windows的Docker Desktop或Linux下非host模式需要将请求地址改为宿主机的特殊域名或IP。例如在Mac/Windows上通常可以使用host.docker.internal代替192.168.1.105。但这需要你的电脑能通过这个域名访问到ESP8266有时需要额外的路由或防火墙设置比较复杂。因此对于这种需要频繁访问本地硬件的小项目使用host网络模式是最简单的。问题3定时任务不执行。排查检查技能__init__方法中的定时任务线程是否成功启动。查看OpenClaw启动日志是否有报错。确保schedule库已安装。解决在_run_scheduler循环里加一句调试日志看线程是否在运行。确保OpenClaw主进程没有因为异常而退出。问题4提醒方式太单一LED灯亮一下容易忽略。优化方案硬件层面将LED灯换成更醒目的RGB LED提醒时闪烁彩色灯光。或者增加一个无源蜂鸣器发出“嘀嘀”声。ESP8266的GPIO足够驱动这些元件。代码层面修改ESP8266的handleRemind函数让LED以特定模式闪烁如快闪3次停顿再快闪3次而不是常亮5秒。蜂鸣器也可以编写一段简单的旋律。交互层面在OpenClaw技能里可以增加更多交互。比如收到提醒后如果用户回复“知道了”就停止本次提醒如果用户不回应5分钟后再次提醒。6. 项目扩展与玩法升级这个“喝水提醒器”虽然简单但它是一个完美的起点展示了如何用OpenClaw作为控制中心将AI指令转化为物理世界动作。基于这个框架你可以玩出很多花样1. 多传感器输入智能判断提醒时机硬件加装在ESP8266上连接一个超声波传感器HC-SR04或红外传感器放在水杯附近。逻辑升级ESP8266不仅作为执行端也作为感知端。它可以定时检测杯子里是否有水或者水杯是否被拿起。然后将这个状态通过HTTP POST报告给OpenClaw运行的一个状态监测服务。OpenClaw技能升级OpenClaw技能根据接收到的状态例如“水杯已空超过30分钟”再决定是否发送提醒信号。这样就实现了“只在需要时提醒”的智能逻辑。2. 集成到日常办公流对接日历/待办写一个OpenClaw技能读取你的谷歌日历或Todoist待办事项。当检测到你有一个长时间的“编码”或“会议”日程时自动在日程开始后为你设置喝水提醒。与IDE联动开发一个编辑器插件如VSCode Extension在检测到连续输入时间过长时通过本地API调用OpenClaw的提醒技能。这样提醒的上下文更精准。3. 升级提醒媒介抛弃LED改用其他执行器舵机控制一个机械臂举起一个小牌子上面写着“喝水”。继电器控制一个加湿器或氛围灯的开关提醒时自动开启创造湿润的环境或柔和的提醒光。WS2812B灯带在显示器背后贴一圈提醒时呈现流动的波浪光效既醒目又不刺眼。这些改动只需要修改ESP8266的代码将digitalWrite控制LED的逻辑换成控制相应舵机、继电器或灯带库的函数即可。OpenClaw侧的技能代码完全不用变。4. 创建技能市场或共享你的技能如果你把这个技能打磨得很好可以将它打包提交到OpenClaw的社区技能库。这样其他开发者就可以一键安装你的“智能健康提醒”技能只需配置一下自己的硬件IP就能享受成果。这本身就是对开源社区的一种贡献。这个项目的精髓不在于它现在有多复杂而在于它清晰地演示了一条路径用开源AI框架OpenClaw作为大脑用廉价微控制器ESP8266作为手脚通过最通用的HTTP协议作为神经快速构建一个解决具体问题的物理智能体。从“提醒喝水”出发你可以扩展到提醒休息、控制智能家居、监控环境数据等等。动手的过程也是理解智能体如何感知、决策、执行这一完整闭环的过程这比单纯调用云服务API要有趣和深刻得多。下次当你又因为沉迷代码而口干舌燥时看着那个为你而亮的小灯或许会心一笑然后乖乖拿起水杯。