Muse Gadgets把个人AI从手机和电脑里的应用，延伸到创客可以自己搭建的实体设备。项目开放了ESP32固件和Linux设备SDK，开发者可以把显示屏、按钮、麦克风、扬声器、传感器、执行器或本地HTTP服务连接到Muse，让同一个个人AI出现在桌面看板、掌上终端、树莓派和智能家居中。
Muse Gadgets是什么？
Muse Gadgets是Meta围绕Muse个人AI推出的开源硬件项目。它不是一块固定规格的开发板，而是一套连接协议、设备SDK、参考固件和示例工程。开发者可以选用现成ESP32板卡，也可以把带Bluetooth LE的树莓派或Linux电脑改造成Muse Gadget。
官方代码托管在Facebook Incubator的GitHub仓库，主体采用Apache License 2.0。项目同时提供多种参考设备，包括ESP32-C5 DevKitC-1、Waveshare触控AMOLED、Seeed reTerminal墨水屏、M5Stack StickS3、Home Assistant Voice Preview Edition和Raspberry Pi 5。
为什么值得推荐？
这套方案把AI硬件从购买一台封闭成品，变成选择现成模块并自由组合。开发者可以先用低成本板卡验证用途，再决定是否增加屏幕、音频、传感器或外壳。它特别适合常亮信息屏、语音按钮、家庭自动化入口、状态提醒器和专用任务终端。
仓库还针对编码智能体提供了AGENTS.md。Muse Code以及能读取项目说明的其他编码工具，可以协助安装ESP-IDF、识别板卡、编译固件、刷写和读取串口日志，降低嵌入式开发的初始门槛。不过，涉及USB串口与真实硬件的命令仍需要人工检查。
核心能力
- ESP32 Device SDK：给开发板增加Muse连接、状态灯、按钮、显示、图像和音频交互。
- Linux Device SDK：把树莓派或Linux电脑接入Muse，支持运行命令、读写文件和查看设备状态。
- 智能家居连接：通过Linux应用、本地HTTP API或Home Assistant扩展家庭设备控制。
- 多种参考板卡：官方仓库已包含多款ESP32屏幕设备和树莓派示例，方便从现成配置起步。
- 开放扩展：可增加自定义命令、Webhook、传感器、执行器和新的设备适配。
开始前需要准备
无论选择ESP32还是Linux路线，都需要Muse手机App、Muse账户以及从官方页面获取的SDK Token。每台Gadget都需要Token才能配对。Token条款当前限定为个人、非商业用途，而且项目被明确标注为非正式支持的实验性产品，接口可能调整或停止。
硬件方面，ESP32最快可以从ESP32-C5 DevKitC-1开始；Linux路线可使用带Bluetooth LE的Raspberry Pi 3B+、4、5、Zero 2 W，或运行Debian 11、Ubuntu 22.04及以上版本的其他Linux电脑。
ESP32安装与使用教程
方法一：使用编码智能体辅助
先克隆官方仓库并进入ESP32目录，再让Muse Code或其他能够读取AGENTS.md的编码工具按板卡配置编译和刷写：
git clone https://github.com/facebookincubator/muse-gadget-sdk
cd muse-gadget-sdk/esp32官方示例使用Muse Code并关闭沙箱，以便访问USB串口和下载ESP-IDF工具链。关闭沙箱会扩大工具权限，运行前应确认当前目录、板卡型号和每一条命令，不要在包含敏感文件的工作环境中直接照搬。
方法二：手动安装ESP-IDF
官方固件要求ESP-IDF 6.0.1。macOS需要先安装CMake、Ninja、dfu-util与Python 3，再下载对应版本的ESP-IDF：
brew install cmake ninja dfu-util python3
git clone -b v6.0.1 --recursive https://github.com/espressif/esp-idf.git ~/esp/esp-idf-v6
~/esp/esp-idf-v6/install.sh esp32c5,esp32s3,esp32c6,esp32
. ~/esp/esp-idf-v6/export.sh进入仓库的esp32目录后，在配置界面填写SDK Token，然后编译：
idf.py menuconfig
idf.py build连接数据线，找到串口并刷写。下面端口名只是示例，需要替换为自己的设备：
idf.py -p /dev/cu.usbmodem1101 flash monitor固件启动后，打开Muse App，在Settings > Devices中开启Developer mode，再选择Add Device。设备名称通常以MuseGadget开头；按板卡按钮确认配对，状态灯变绿表示已经连接。
Linux与树莓派安装教程
官方提供安装脚本。建议先下载并阅读脚本，再传入自己的Token执行，不要直接把未知远程脚本交给高权限Shell：
curl -fsSL https://raw.githubusercontent.com/facebookincubator/muse-gadget-sdk/main/linux/install.sh -o install.sh
less install.sh
bash install.sh --sdk-token mgst_你的Token安装器会把程序放到/opt/musegadget并启动系统服务，然后打开蓝牙配对。手机端同样需要开启Developer mode并添加MuseGadget设备。配对窗口默认持续10分钟，之后可运行：
sudo musegadget pair安装完成后可以查看设备信息、服务状态和实时日志：
musegadget info
sudo systemctl status musegadget
sudo journalctl -u musegadget -fLinux版本能做什么？
Linux SDK内置运行Shell命令、分块读写文件和查询运行时间、负载、内存、磁盘及温度的能力。你可以让Muse检查树莓派磁盘占用、监控备份、连接Home Assistant，或编写服务在设备过热时主动发消息。
这些能力也意味着明显的权限风险。命令继承安装账户的权限；如果账户能够无密码使用sudo，Muse就可能影响整个系统。更稳妥的方式是使用专用低权限账户、限制sudo、隔离敏感目录，并把实验设备与生产网络分开。
使用限制与安全提示
开源代码许可与服务Token许可不是一回事。代码采用Apache 2.0，并不代表可以把Muse服务凭证用于商业硬件。官方Token条款规定个人非商业使用，允许分享的设备数量和方式也有限制，不能把嵌入Token的设备拿去销售或公开上架。
ESP32端应启用NVS加密来保护Wi-Fi凭证和设备Token；Linux端不要公开/var/lib/musegadget/sdk_token。社区设备配对没有制造商认证，无法完全阻止主动中间人攻击，因此只应在可信网络中完成初始配对。
综合评价
Muse Gadgets的价值不在于又增加了一款AI硬件，而是提供了让个人AI适配不同外形的开源起点。ESP32路线适合小屏、按钮和便携终端，Linux路线适合树莓派、自动化和本地服务。二者共同把AI智能体从软件界面带到真实设备。
它目前仍偏向创客实验：需要Muse生态、个人Token和一定硬件经验，稳定性与商业授权也有限。对于想研究AI与物联网、智能家居或嵌入式交互如何结合的开发者，它很值得动手；对于需要稳定量产的团队，则应先评估服务许可、权限模型、长期维护和供应链风险。