ESP-Claw 边缘智能体框架
让 ESP32 设备通过对话定义行为,并在芯片上完成感知、决策与执行。
- Star 数
- ★ 2.3k
- 最近更新
- 4 天前
- License
- Apache-2.0
- 主语言
- C
- FA 评分
- 37/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配OpenAI API · Claude API
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 希望通过即时通讯对话配置设备行为、而非编写程序的物联网爱好者。
- 不适合
- 需要在非乐鑫芯片上直接运行的项目
- 要求无需配置模型 API 的团队
这个 Agent 能做什么,适合哪些场景?
ESP-Claw 是乐鑫面向物联网设备的 C 语言 Chat Coding 智能体框架,将 Agent Runtime 部署到乐鑫芯片上。用户可通过即时通讯对话定义设备行为,框架支持动态加载 Lua。它采用事件驱动的 Agent Loop,可由事件触发,并在某些情况下实现毫秒级响应。框架支持结构化记忆,并称记忆数据保留在云端之外。设备可通过 MCP 作为服务端或客户端通信。项目支持 ESP32 系列开发板,可在线刷写或本地构建固件。
ESP-Claw 在乐鑫芯片上运行 Agent Runtime,响应可触发 Agent Loop 的事件。用户可以通过 Telegram、QQ、飞书或微信与设备对话,并借助动态 Lua 加载定义设备行为。框架支持 OpenAI 风格和 Anthropic 风格 API,也支持自定义端点;它可连接支持 MCP 的设备,既能作为 MCP Server,也能作为 Client。最终行为在设备端执行,支持的开发板可通过浏览器配置并在线刷写,也可按文档本地构建和刷写。
- 希望通过即时通讯对话配置设备行为、而非编写程序的物联网爱好者。
- 需要让 ESP32 系列设备响应传感器或其他事件的嵌入式开发者。
- 希望在乐鑫芯片上运行本地决策逻辑的物联网原型团队。
- 需要让 ESP32 设备通过 MCP 与其他兼容设备通信的开发者。
- 希望在支持的开发板上用浏览器完成配置和刷写的创客。
如何安装或部署这个 Agent?
README 未提供可复制的安装命令、完整本地构建命令、模型 API 凭据配置步骤或首次运行命令。已说明的部署路径是:选择 application/edge_agent/boards/ 中支持的开发板,通过在线刷写页面在浏览器中配置并刷写;或按本地构建文档适配开发板、构建和刷写。设备需为 ESP32 系列;使用模型功能还需配置兼容的 OpenAI 风格或 Anthropic 风格 API,但具体凭据设置步骤未在所给材料中说明。
如何使用这个 Agent?
README 没有给出可复制的首次对话、API 调用或配置示例。它说明用户可通过 Telegram、QQ、飞书或微信与设备交互,并以对话定义设备行为;框架支持动态 Lua 加载和事件驱动的 Agent Loop。要实际使用,需刷写固件、设置模型 API 端点,并按所选通讯平台完成连接;所给材料未包含这些配置的具体字段或命令。
这个 Agent 有哪些优点和局限?
- Agent Runtime 在乐鑫芯片上运行,感知、决策和执行可在设备侧完成。
- 支持动态 Lua 加载,用户可通过即时通讯对话定义设备行为。
- 支持事件驱动的 Agent Loop,并称响应可快至毫秒级。
- 支持 OpenAI 风格及 Anthropic 风格 API、自定义端点,以及 MCP Server 和 Client 模式。
- 支持的开发板可通过浏览器配置和在线刷写,无需先在本地编译。
- 核心运行目标是乐鑫芯片;直接迁移到其他芯片需要适配。
- 模型能力依赖外部 API 或自定义端点;README 未说明费用或离线模型路径。
- 本地构建、模型凭据、通讯平台连接和首次运行的具体命令未在所给材料中说明。
- 项目仍在积极开发,且 README 未说明稳定性承诺。
这个 Agent 与同类方案有什么区别?
README 将 ESP-Claw 与传统物联网设备的被动执行方式作对比,并说明其灵感来自 OpenClaw、部分实现借鉴 MimiClaw;没有提供与这些项目的功能或性能对比。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| ESP-Claw 边缘智能体框架 当前 | 37 · 缺口较多 | 开发框架 | ★ 2.3k | 4 天前 | C | OpenAI API · Claude API |
| Grok CLI | 52 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 3.5k | 5 个月前 | TypeScript | — |
| Franklin Agent | 43 · 缺口较多 | 命令行工具免费版 + 付费版 | ★ 561 | 今天 | TypeScript | — |
| CommitLore | 89 · 表现良好 | 命令行工具免费 | ★ 18 | 今天 | TypeScript | — |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
README 描述设备本地执行、结构化记忆留在云端之外,并列出聊天、MCP 和可扩展模块;但未说明权限模型、敏感凭据存储、传输边界或调用外部效果前的确认流程,因此这些控制仅有部分证据。源码材料没有展示回滚机制;README 对 OpenClaw 和 MimiClaw 的启发及借鉴作了归因,但未提供更细的来源映射。
README 明确列出支持的芯片系列、模型 API 类型和消息平台,并提示自编程依赖较强工具调用能力的模型;但“毫秒响应”等性能主张没有材料佐证,文件中也没有可评估的故障提示策略或依赖可用性保障。
材料明确面向 ESP32 系列设备、普通用户对话配置以及本地构建者,并提到 Board Manager、在线刷写和组件裁剪;但 Agent 能力的边界、事件触发条件及错误或危险操作处理方式没有说明,故只对目标场景和环境适配给予较高分。
README 按功能、快速开始、平台、开发计划和安全等主题组织内容,提供在线刷写入口及本地构建文档指引;但示例和 FAQ 只以文档链接呈现,已知限制说明有限,项目命名虽一致但版本变更记录未见。LICENSE 文件完整提供 Apache-2.0 条款。维护渠道有 issue 和中文调查表,但未说明负责团队或维护承诺。
产品说明了在低成本 ESP32 设备上结合对话配置、事件驱动、MCP 和组件扩展的用途,这些能力可能为 IoT 场景带来实际价值;但可复用输出、实际效果和成本收益没有可核验的示例或量化资料,评分因此有限。
部分产品主张可追溯到 README 中的功能说明、平台列表和快速开始指引,也有 LICENSE 文件支持许可声明;不过这些材料没有相互独立的实现、测试或结果证据来印证主要能力,部分性能和隐私表述仍是未经支持的陈述。
- 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
- 这是基于所给静态文件的低置信度评估,未执行代码,也未独立验证能力、性能或安全性。
- README 提及设备本地处理和隐私,但没有说明聊天内容、模型请求或凭据的完整数据流及保护措施。
- 项目仍在积极开发;在部署到真实设备前,应查阅完整构建文档,并评估设备控制操作的权限和恢复方式。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v0.1.0 ESP-Claw v0.1.0
发布说明摘录
Release Note - ESP-Claw v0.1.0 The first release of ESP-Claw. Thanks to all contributors for their code, board support, and feedback that helped shape this release. > [!TIP] > > For build and usage instructions, please refer to the documentation at https://esp-claw.com/ <details> <summary> <b>Architecture diagram</b> (Click here to expand) </summary> <img width="5196" height="6652" alt="architecture-diagram-dark-2" src="https://github.com/user-attachments/assets/5e989a59-0fea-4c29-8414-8c98e82ef4ab" /> </details> Agent Core …在 GitHub 查看 ↗