常见问题
关于使用 ESP-Claw 构建 AI 智能体的常见问题解答。
基础问题
什么是 ESP-Claw / OpenClaw？
OpenClaw 是一个运行在 ESP32 微控制器上的开源 AI 智能体平台。与普通聊天机器人不同，它是一个能推理、使用工具并与物理世界交互的智能体——可以读取传感器、控制设备，并通过 Telegram、Discord 等平台通信。最便宜的方案仅需约 $5 的零件。
ESP-Claw 和 MimiClaw 有什么区别？
MimiClaw 是为 ESP32-C3（$2 芯片，400KB RAM）设计的极简版。ESP-Claw 是为配备 8MB PSRAM 的 ESP32-S3 设计的全功能版，支持语音 I/O 和本地 ML 推理。两者运行相同的 AI 智能体核心，拥有 40+ 工具。
OpenClaw 是免费的吗？
是的，所有软件和硬件设计都是开源的（软件 MIT 许可证，硬件 CERN-OHL-P 许可证）。你只需要支付物理元器件费用（$5-25）和 AI API 使用费（使用 Claude Haiku 的典型家用场景约 $0.50/月）。
需要会编程吗？
基础使用不需要。你可以通过浏览器烧录固件、通过 Web 界面配置、编辑 Markdown 文件（SOUL.md）来自定义 AI 个性。只有在创建自定义工具时才需要 C 或 MicroPython 编程。
硬件相关
应该买哪款 ESP32 开发板？
预算优先的新手：ESP32-C3 SuperMini（约 $2）。想要完整语音体验：ESP32-S3 DevKitC N16R8（约 $8）。均可在淘宝、AliExpress 和 Amazon 购买。详细对比请查看产品页面。
功耗多少？
ESP32-C3 工作时约 0.5 瓦，比一盏 LED 小夜灯还低。全年 24/7 运行的电费约 $0.50。配合深度睡眠模式，1000mAh 电池可持续数周到数月。
可以添加自己的传感器吗？
可以。ESP-Claw 支持任何通过 GPIO、I2C、SPI 或模拟输入连接的传感器。常见扩展包括温湿度传感器（DHT22、BME280）、运动检测器（PIR）、显示屏（OLED）和伺服电机。请查看兼容硬件列表了解已测试的设备。
ESP-Claw 能控制空调吗？
可以，使用一个 IR LED（约 $0.10）。ESP-Claw 可以学习你空调遥控器的红外编码，然后通过自然语言命令控制空调。说'把空调调到 24 度'，它就会发送相应的红外信号。
AI 与隐私
支持哪些 AI 模型？
Claude（Anthropic）、OpenAI（GPT-4、GPT-3.5）、Ollama（本地模型），以及任何兼容 OpenAI 接口的 API 端点。推荐使用 Claude Haiku，性价比最高，约 $0.25/百万输入 token。
我的数据会上传到云端吗？
你的 SOUL.md、MEMORY.md 和设备配置保存在 ESP32 的本地闪存中——永远不会离开你的设备。发送消息时，只有当前对话会发送到你选择的 AI 提供商进行处理。你可以使用本地 Ollama 服务器实现完全离线运行。
AI API 费用多少？
使用 Claude Haiku 的典型家用场景约 $0.30-0.50/月（大约每天 10-20 次对话）。一次包含 2-3 个工具调用的对话使用约 500-1000 个 token，费用 $0.0003-0.001。你可以在 API 提供商的控制台设置消费限额。
能完全离线工作吗？
部分可以。ESP32-S3 可以在本地运行小型 TensorFlow Lite 模型，用于唤醒词检测和简单意图分类。完整的对话 AI 需要云 API 或本地网络中的 Ollama 服务器。ESP32-C3 始终需要云 API 进行 AI 推理。
安装与故障排除
如何烧录固件？
最简单的方式是在安装页面使用浏览器烧录——用 USB 连接开发板，在 Chrome 或 Edge 中点击'烧录'，30 秒完成。无需安装任何软件。你也可以使用 esptool.py 或使用 ESP-IDF 从源码编译。
烧录时检测不到设备怎么办？
最常见的原因：使用了纯充电线。换一根支持数据传输的线。你可能还需要安装 USB 驱动（ESP32-C3 SuperMini 用 CH340，部分 S3 板用 CP2102）。macOS 上检查系统设置 > 隐私 > USB。
Telegram 机器人没有回复怎么办？
检查：1) ESP32 是否连接了 Wi-Fi？（LED 应该常亮而非闪烁）2) Bot token 是否正确？3) AI API 密钥是否有效且有余额？4) 通过 USB 连接查看串口监视器的错误信息。
能不用 USB 更新固件吗？
可以，ESP-Claw 支持 Wi-Fi 空中升级（OTA）。告诉你的机器人'检查更新'或配置自动更新检查。详见 OTA 更新指南。
自定义
什么是 SOUL.md？
SOUL.md 是一个纯 Markdown 文件，定义了你的 AI 智能体的个性、行为规则和知识。它是 AI 在每次对话前读取的'说明书'。你可以通过 Web 界面编辑或上传新文件，更改立即生效无需重新烧录。
AI 能记住跨对话的信息吗？
能。ESP-Claw 使用 MEMORY.md 在对话和重启间保存信息。AI 可以保存用户偏好、学到的日程和上下文笔记。你还可以在 SOUL.md 中定义它应该记住和不应该记住什么。
可以运行多个智能体吗？
可以。每块 ESP32 运行一个智能体，但你可以部署多块板子，搭配不同的 SOUL.md 个性。它们可以通过 MQTT 相互通信，形成多智能体系统——例如每个房间的气候智能体向中央枢纽智能体报告。