VMflow：一款面向 AI Agent 的开源自动售货机物联网平台

一、项目概述

VMflow（仓库名：mdb-esp32-cashless）是一套完全开源、软硬件一体的自动售货机物联网平台，也是首个原生支持 AI Agent 调度的售货机 IoT 解决方案。项目基于 ESP32 硬件开发，实现标准 MDB（Multi-Drop Bus）无现金外设协议，可直接对接市面上绝大多数传统自动售货机主控，帮助存量售货机低成本完成智能化改造，新增线上无现金支付、云端数据监控、远程运维等数字化能力。整套方案采用 MIT 开源协议，允许开发者、设备厂商、运营商自由二次开发与商用落地。

二、核心设计目标

兼容通用标准：遵循国际售货机 MDB 协议，兼容欧洲 EVA-DTS / DEX/DDCMP 行业规范，适配国内外主流售货机；
轻量化改造：即插即用接入现有售货机，无需改动售货机原有主控逻辑；
全链路物联网能力：打通硬件终端、移动端 App、Web 管理后台、云端 API；
智能化开放：提供标准化接口，支持 AI 代理直接调用，实现无人化远程运维；
软硬件开源闭环：KiCad 硬件工程、ESP-IDF 固件、配套应用、云端接口文档全部开放。

三、硬件方案

硬件主控采用 ESP32 系列芯片，提供两种硬件版本，PCB 工程开源：

WiFi / 蓝牙标准版：依靠 Wi-Fi 联网，BLE 蓝牙实现本地近距离调试、下发支付额度；
蜂窝物联网增强版：搭载 SIM7080G LTE 模组，无现场宽带环境下也可独立联网。

硬件作为MDB 从设备（Cashless 无现金模块） 工作，与售货机主板通信，完成指令交互：接收云端支付指令、向售货机下发授信额度、上报出货交易记录。外设拓展支持客流统计（Paxcounter），采集机器周边人流量数据，辅助运营分析。

四、软件与通信体系

1. 终端固件

基于 ESP-IDF 开发，支持在线网页一键烧录，支持远程 OTA 升级；通信通道同时支持 MQTT 云端长连接 + BLE 蓝牙本地通信。

2. 配套应用

Android App：设备绑定注册、WiFi 远程配置、蓝牙近距离调试、实时下发支付额度；
Web 管理仪表盘：集中管理售货机集群，实时查看设备在线状态、交易流水、库存数据、商品目录，支持运营诊断、销售数据分析。

3. 开放 API 与 AI 集成

项目原生面向 AI Agent 设计，提供完整 RESTful API：

设备状态查询、额度下发、交易记录查询；
支持 OpenClaw、ChatGPT、Claude 等大模型直接调用接口；
AI 可自主完成设备巡检、故障告警、远程 OTA、交易调度，实现无人值守运维。

五、核心业务能力

无现金远程支付：云端下发授信额度，替代传统硬件扫码器，实现线上下单、远程驱动售货机出货；
全量数据采集：采集交易记录、库存信息，支持 EVA-DTS 标准数据上报，满足海外售货机运营规范；
设备集群管理：云端统一管控大量售货机，在线监控、故障预警；
客流数据分析：结合 Paxcounter 采集人流量，计算转化率，提供经营决策参考；
多渠道调试运维：支持云端远程操作、蓝牙本地调试两种方式。

六、典型应用场景

存量售货机改造：传统现金售货机加装本模块，低成本升级扫码支付与物联网管理；
新款售货机整机开发：厂商直接采用该开源硬件作为内置无现金支付 IoT 模块；
海内外售货机运营项目：原生支持欧洲 EVA 行业标准，适配海外市场数字化运营；
智能零售科研与二次开发：开源 MDB 协议参考实现，可供嵌入式开发者研究售货机通信协议。

七、项目优势

✅ 软硬件全套开源（MIT 协议，商用友好）

✅ 标准 MDB 协议，通用性强，兼容绝大多数售货机

✅ 同时支持 Wi-Fi / 蜂窝两种联网方案，部署灵活

✅ 原生支持 AI Agent 远程调度，差异化于传统售货机方案

✅ 配套完整工具链：一键烧录工具、安卓 App、Web 后台、开放 API 文档

✅ 支持远程 OTA 升级，设备后期维护便捷

八、License

MIT license

九、项目地址

https://github.com/nodestark/mdb-esp32-cashless