指示灯不亮需依次排查供电、物理开关、固件配置和硬件通信：检查电源连接与电压，确认led硬开关开启，验证config.yaml中led_enabled为true并重启服务，运行i2cdetect和diag_led_test.sh诊断i²c通信及驱动状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您观察到 OpenClaw AI 设备的指示灯未亮起，则可能是由于供电异常、指示灯被物理关闭或设备内部发生硬件故障。以下是针对该现象的多种排查与恢复方法：
一、检查供电状态
指示灯不亮最常见原因是设备未获得有效电力输入，需确认电源适配器连接稳固、插座通电且输出电压符合设备标称要求（通常为5V/3A）。部分云盒型号具备独立电源开关，需同步确认其处于开启位置。
1、断开设备电源线，静置10秒后重新插入电源适配器。
2、使用万用表测量适配器输出端电压，确认是否稳定在标称值±5%范围内。
3、更换另一已知完好的同规格电源适配器进行交叉验证。
4、将设备接入其他经确认正常的插座或排插，排除墙插断电可能。
二、确认物理指示灯开关状态
部分 OpenClaw AI 云盒（如触觉智能 OpenClaw 云盒 BOX 整机）在机身侧面或底部设有独立的指示灯硬开关，该开关可手动关闭 LED 以降低环境光干扰，此时设备仍在正常运行，仅灯效熄灭。
1、沿设备外壳边缘缓慢触摸查找微小拨动式或按压式物理开关。
2、若发现标有“LED”“LIGHT”或图标为灯泡轮廓的开关，将其拨至“ON”或按下并保持2秒释放。
3、观察是否立即出现常亮蓝光或呼吸式白光——此为正常运行态灯效。
三、排查固件与系统级灯控逻辑
OpenClaw AI 的指示灯由 Gateway（调度中心）模块统一控制，若其未完成初始化或配置中禁用了灯效输出，指示灯亦不会点亮。该情况多见于首次启动、固件升级中断或 config.yaml 中误设 led_enabled: false。
1、通过 SSH 登录设备终端（默认用户 lighthouse，IP 为设备局域网地址）。
2、执行命令：cat /opt/openclaw/config.yaml | grep led_enabled，确认返回值是否为 true。
3、若返回 false 或无输出，编辑配置文件：nano /opt/openclaw/config.yaml，在 root 层级添加行：led_enabled: true。
4、保存后执行：sudo systemctl restart openclaw-gateway，重启调度中心服务。
四、检测硬件通信通道中断
指示灯通过 I²C 总线与主控芯片通信，若总线线路虚焊、ESD 损伤或固件加载了错误的 LED 驱动模块，会导致灯控信号无法送达。该类问题在运输震动或雷击浪涌后较易出现。
1、执行诊断命令：i2cdetect -y 1，查看地址 0x60–0x6F 区间是否识别到 LED 控制器（典型地址为 0x62）。
2、若该地址显示为 “--”，说明 I²C 通信失败，需检查主板对应焊点有无裂纹或异物短路。
3、运行底层检测脚本：/opt/openclaw/tools/diag_led_test.sh，观察终端是否输出“LED driver loaded”及“Pulse test OK”。
4、若脚本报错“Failed to write to device”，则判定为 LED 驱动芯片损坏，需返厂更换 Gateway 模块。
