Muse 硬件到手先做三件事：领 token、刷机、配对

Meta 开源 Muse Gadget SDK 后，不少人的开发板已经在路上了。这篇只讲实操：从 token 到配对，把一块几十块钱的开发板真正变成 Muse 的外设，中间有三个关卡。

第一步：领 token

配对的凭证在 gadgets.muse.ai/settings/sdk-tokens 页面申请。有两个容易踩的细节：每个 token 能绑定的设备数量有限，别一块开发板领一个，按项目规划好；页面上的 Revoke 是连坐制，吊销后用这个 token 配过的所有设备全部解绑，换 token 等于重配全场。

第二步：刷机

ESP32 路线走官方 ESP-IDF 工具链，进仓库的 esp32 目录构建烧录，屏幕、音频、传感器的示例都在里面；树莓派或其他 Linux 机器走 Linux Device SDK 的安装脚本，刷完就是一台能接系统管理任务和 Home Assistant 的 gadget。两条路线都支持最省事的玩法：把仓库目录直接指给 coding agent，每个目录里的 AGENTS.md 写清了构建流程，agent 会自己把活干完。想稳一点就先跑模拟器，LVGL 加 SDL 的桌面模拟可以不上板调完界面逻辑。

第三步：配对

手机 App 里进 Settings、Devices，先打开 Developer mode，然后搜索以 MuseGadget 为前缀的设备。注意 iOS 和 Android 应用都支持，但开发者模式不开的话设备永远不会出现在列表里，这是最常见的「刷机成功却搜不到」原因。

顺手把 Home Link 认领了

同一页面下面就是 Muse Home Link 的认领入口：那台限量 5000 台的 USB-C 小盒子对美区订阅用户免费，认领会锁定排队位置，但官方明确说「认领不是下单」，出货时会另行通知，登录用的就是 Muse 账号。

刷不动的时候

两个高频卡点提前说：ESP-IDF 版本不对会直接构建失败，按仓库 README 锁定的版本来，别用系统包管理器里顺手的那个；模拟器能跑、真机搜不到，九成是 App 里的 Developer mode 没开，剩下的看 token 是不是已经过设备数上限。官方 Discord 是最快的求助渠道，固件作者和折腾出结果的玩家都在里面。

最后一条重要提醒

官方在 SDK 条款里把话说得很直白：这套 SDK 定位是个人折腾（personal tinkering），不是受支持的开发者产品或平台，随时可能变更、损坏或停用且不另行通知。把自己的智能家居入口押在上面之前，先把这句话读完。也正因为它开源，最坏情况是社区自己 fork 接盘。

三件事做完，你的 agent 就有了实体世界的开关、屏幕和传感器。剩下的玩法，Discord 社区里已经有人用会议胸牌那块 RP2350 跑通了 MicroPython 接入，思路可以直接抄。