openclawai未识别sd卡需按三步排查：一、清洁金手指并确认卡槽供电3.3v、led响应；二、ssh登录后用dmesg检查sdhci/mmc驱动加载及设备节点生成；三、验证/dev/mmcblk0p1存在，确认fat32/exfat格式并手动挂载测试。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您将SD卡插入openclawAI设备，但系统未识别该存储设备，则可能是由于硬件接口异常、供电不足、文件系统不兼容或驱动未加载所致。以下是解决此问题的步骤：
一、检查SD卡物理连接与供电状态
openclawAI通过专用SD卡槽接入外部存储，接触不良、卡槽异物或供电压降会直接导致控制器无法完成初始化握手，进而跳过枚举流程。
1、取出SD卡，用无水酒精棉片轻拭金手指，待完全干燥后重新插入卡槽，确保听到轻微“咔嗒”声并完全推入到底。
2、更换另一张已知完好的SD卡（建议容量≤128GB、Class 10及以上、FAT32或exFAT格式）进行交叉验证。
3、观察设备正面右上角LED灯：若插入SD卡后LED由常亮转为快闪两次再恢复，表示检测到卡但初始化失败；若无任何变化，说明卡槽未触发中断信号。
4、使用万用表测量SD卡槽第4脚（VDD）对地电压，确认稳定输出3.3V±0.15V直流电压。
二、验证内核是否加载SD主机控制器驱动
Linux内核需正确加载sdhci或mmc_block驱动模块，并完成设备树中SDHCI节点匹配，否则无法生成/dev/mmcblk*设备节点。
1、通过SSH登录openclawAI终端（默认用户lighthouse，IP为设备局域网地址）。
2、执行命令：dmesg | grep -i "sdhci\|mmc\|sd"，检查输出中是否存在“sdhci-pltfm”、“mmc0: new high speed SDHC card”等成功识别日志。
3、若出现“timeout waiting for hardware interrupt”或“failed to initialize host controller”，执行：sudo modprobe sdhci && sudo modprobe mmc_block手动加载驱动。
4、再次运行dmesg命令，确认末尾出现类似“mmcblk0: p1”分区识别信息，表明设备节点已生成。
三、检查设备节点挂载与文件系统兼容性
即使内核识别SD卡，若其文件系统为NTFS、APFS或加密格式，或挂载点权限配置错误，openclawAI仍无法读取内容。
1、执行命令：ls -l /dev/mmcblk*，确认存在/dev/mmcblk0（设备）及/dev/mmcblk0p1（首分区）节点。
2、执行命令：sudo file -s /dev/mmcblk0p1，查看返回的文件系统类型；openclawAI仅原生支持FAT32与exFAT，不支持NTFS或ext4写入。
3、创建挂载目录并手动挂载测试：sudo mkdir -p /mnt/sdcard && sudo mount -t vfat /dev/mmcblk0p1 /mnt/sdcard（若为exFAT则替换vfat为exfat）。
4、执行ls /mnt/sdcard，若能列出文件且无“Permission denied”提示，说明挂载成功；否则检查SD卡是否存在坏扇区或逻辑损坏。
