espclaw

About

ESPClaw 是什么 嵌入式领域的 OpenClaw，最便宜的嵌入式 AI Agent 学习平台。一个能在 2 美元芯片上跑的 AI Agent 固件，纯 C 实现，4MB Flash 就够了。 我们想回答一个问题：Agent 的核心能力，能不能塞进最便宜的芯片里？ 演示视频 ESPClaw 想在这些探索上再往前走一步：如果砍掉 PSRAM，用最便宜的 C3，Agent 还能跑吗？ 架构设计 串口 / Telegram / WebSocket │ ┌────▼────┐ │ Channel │ ← vtable 抽象，可扩展新通道 └────┬────┘ │ ┌────▼────────┐ │ Message Bus │ FreeRTOS 队列，异步解耦 └────┬────────┘ │ ┌────▼──────┐ │ Agent │ ReAct 循环：思考 → 行动 → 观察 │ Loop │ 多轮上下文，对话历史管理 └────┬──────┘ │ ┌────▼──────────┐ │ Provider │ ← vtable 抽象，多后端支持 │ Anthropic/ │ 流式 JSON 解析（省内存） │ OpenAI/... │ └────┬──────────┘ │ ┌────▼──────────┐ │ Tool Registry │ 能力位掩码，按平台自动过滤 │ GPIO/Memory/ │ LLM 可调用硬件 │ Cron/System │ └────┬──────────┘ │ ┌────▼────┐ │ HAL │ 硬件抽象层，安全护栏 └─────────┘ 设计理念 1. vtable 抽象，一切可替换 Channel、Provider、Tool、HAL 全部用 vtable（函数指针表）抽象。想换 LLM 后端?实现一个新的 Provider。想加新通道?实现一个新的 Channel。 嵌入式里没有继承，但我们用 C 的函数指针做到了同样的事。 2. 流式解析，极限省内存 ESP32-C3 只有 400KB RAM。我们用 SAX 风格的流式 JSON 解析器，边收边解析，不需要把整个响应塞进内存。这让我们能用 4KB 缓冲区处理 LLM 的长回复——这也是为什么不需要 PSRAM。 3. 能力位掩码，自动适配平台 同一个固件，C3 / C5 / S3 都能跑。Tool Registry 在启动时根据芯片能力自动过滤可用工具：C3/C5 用基础工具，S3 用全部工具。一套代码，三种芯片。 4. 安全护栏在 HAL 层 GPIO 操作不直接调用 ESP-IDF API，而是走 HAL 层。HAL 层会检查引脚是否在允许范围内，不在就拒绝。安全不是靠"小心写代码"，而是靠架构设计。 5. 异步消息总线 FreeRTOS 队列把输入/输出/处理完全解耦。串口接收 task 只管往队列塞消息，Agent task 只管从队列取消息。谁也不阻塞谁。 与其他项目的对比 | 项目 | 硬件成本 | 语言 | 特点 | |------|----------|------|------| | OpenClaw | 服务器 | TypeScript | 功能完整的 Agent 框架 | | NanoBot | 服务器 | Python | ~4000 行，学习友好 | | ZeroClaw | 任意 | Rust | <5MB 内存，零开销 | | PicoClaw | $10 | Go | <10MB 内存，1 秒启动 | | MimiClaw | $5 (S3+PSRAM) | C | 嵌入式完整 AI 助手 | | ESPClaw | $2 (C3) | C | 最便宜的学习平台 | ESPClaw 不是要取代谁——每个项目都有自己的定位。我们想做的是 Agent 的"Arduino"：够便宜、够简单、架构够清晰，让任何人都能理解 Agent 是怎么实现的。 能做什么 一块 ESP32-C3/C5/S3，接上 WiFi： 多轮对话：串口和 LLM 聊天，上下文自动保持 定时提醒：LLM 设置定时任务，到点发消息 智能家居：LLM 控制 GPIO，接继电器、传感器 学习 Agent：ReAct 循环、工具调用、状态管理，代码全透明 支持 Anthropic / OpenAI / OpenRouter / Ollama / 任意 OpenAI 兼容 API bash idf.py set-target esp32c5 idf.py menuconfig # 填 WiFi + API Key idf.py build flash monitor 当前进度 Step 1-4 已完成：固件启动 → WiFi 连接 → 串口交互 → 多轮 LLM 对话 Step 5 正在进行：ReAct Agent + 工具系统 完整路线图见 PLAN.md 一起来 ESPClaw 还很早期，代码量也不大——正是参与的好时候。 如果你也想： 理解 Agent 架构是怎么设计的 用最便宜的价格做一个能"思考"的硬件 把 AI 接进智能家居、机器人、可穿戴设备 欢迎提 Issue、提 PR，或者只是 star 一下。如果这个方向对你有用，一起来吧。 致敬 这个项目站在很多优秀项目的肩膀上： OpenClaw — 开创了个人 AI Agent 的范式，证明了 AI 可以是每个人的私人助手 NanoBot — 用 ~4000 行代码展示了 Agent 可以多简洁，学习友好的典范 PicoClaw — 用 Go 实现了超轻量 Agent，<10MB 内存的标杆 ZeroClaw — 展示了 Rust 在嵌入式 Agent 的可能性，零开销的追求 MimiClaw — 证明了 ESP32-S3 能跑完整的 AI 助手，Telegram + 记忆 + 工具调用

Discovery history

1. 阮一峰周刊·用户投稿

   Mar 4, 2026 · 1 observations