《Muse Gadgets 实战》第 11 章：树莓派变身 Muse 外设
前面十章都在玩 ESP32 小板子。今天换个大块头。把 Muse Gadgets 装到树莓派上。
说白了，ESP32 是单片机，算力有限。树莓派是一台微型电脑，跑着完整 Linux。官方仓库有个 linux/ 目录，一句话讲清它的作用：把任何 Linux 电脑变成 Muse 外设。装上、配对，Muse 就能在这台机器上跑命令、搬文件。
树莓派能干什么，ESP32 干不了
ESP32 适合按键、灯带这类小交互。树莓派不一样，它有完整操作系统。
装好 Linux SDK 后，Muse 有 4 个官方命令可以用：
| 命令 | 作用 |
|---|---|
system.run |
跑一条 shell 命令，把输出和退出码拿回来 |
file.read |
读文件，一次读 64KB |
file.write |
写文件，写完才替换原文件 |
device.health |
查机器健康：运行时间、负载、内存、磁盘、温度 |
你看出来没。device.health 直接给温度，连传感器都不用接。你要做个智能家居中控，管灯、管空调、查备份状态，树莓派才是正解。ESP32 就做单点小硬件。
还有个好消息。官方 README 原话：其他 Linux 电脑也行，只要带蓝牙 LE。你手里吃灰的旧笔记本，装个 Ubuntu，照样能当 Muse 外设。不一定非买树莓派。
硬件准备
先说板子。官方原话：带蓝牙的树莓派，3B+、4、5 或 Zero 2 W。
再说系统。Raspberry Pi OS Bullseye 或更新，Debian 11 或更新，Ubuntu 22.04 或更新。32 位 64 位都行。我个人建议用树莓派 4 或 5，跑起来顺滑。
配件清单很短：
- TF 卡一张，至少 16GB。系统加日志，不大点装不下。
- 电源一个。树莓派 4 和 5 挺吃电，别拿旧手机充电器凑合。供电不足会死机，你调试到怀疑人生。
购买提示：树莓派开发板、TF 卡、电源的购买链接暂未上线。等联盟账号审批通过后更新，本文暂不含任何购买返佣链接。
安装：一行命令，装完是个服务
树莓派装好系统、连上网。在这台机器上，以”希望 Muse 用的那个账号”登录终端。
安装就一条命令：
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_…
SDK Token 从哪来？去 gadgets.muse.ai/settings/sdk-tokens（Account > SDK tokens）领。每个设备都要一个独立的，树莓派不能用你之前 ESP32 的 Token。
安装程序干三件事：检查系统、把东西装到 /opt/musegadget、启动 musegadget 服务。装之前它会问你：确认要把 Muse 交给当前账号吗？还会告诉你这个账号能不能 sudo。想清楚再按回车。
手机配对：10 分钟窗口
安装程序跑完，会打开蓝牙配对。这时候去手机：
- Muse App 里打开 Settings > Devices > Developer mode。
- 添加设备（Settings > Devices > Add Device，右上角 + 号）。列表里会出现
MuseGadgetXXXXXX，名字就是安装程序打印的那个。 - Muse 会提示这是社区设备。是你自己的，继续点下去。
- 问 Wi-Fi 时选它显示的网络。树莓派已经在线了，不用输密码。
配对窗口只有 10 分钟。超时了没配上，在树莓派上跑 sudo musegadget pair，重新开一次。
安全警告：这段必须先看懂再装
官方 README 有一行原话，加粗标红的级别：Muse gets the same access to the machine as the account you install it for. Muse 拿到的是你安装账号的完整机器权限。
什么意思？安装账号能 sudo，Muse 就能 sudo。它能读写系统文件、能关机、能删库。出了事，官方 README 第一句就写了：这是黑客自娱项目，后果自负。
多说一句。官方给了退路：bash install.sh --run-as someone 可以把 Muse 交给另一个账号，比如一个没 sudo 的低权限账号。跑之前想清楚，你到底想让 AI 碰你系统的多少权限。
演示：动动嘴，让树莓派自己干活
配对完，直接跟 Muse 说话就行。
查磁盘空间
你说：”树莓派磁盘快满了，看看谁在占地方。”
Muse 会用 system.run 在树莓派上跑命令，把结果念给你。不用 SSH，不用开电脑。
查机器健康
你说：”树莓派现在热不热？”
Muse 会用 device.health 把温度、负载、内存、磁盘一次报给你。比你接传感器快多了。
让 Muse 自己写定时任务
你说：”写个服务，树莓派太热的时候告诉我。”
Muse 能在机器上写脚本、设定时任务，自己把监控搭起来。这是树莓派的最大优势：你现成的 Linux 技能，Muse 全会。
机器上的程序也能找 Muse
反过来也行。树莓派上的程序可以直接给 Muse 发消息，不需要任何凭证：
musegadget send-user-msg "车库门开了一个小时了"
官方给了个完整例子：examples/pebble_ring_bridge.py，一个 webhook 监听器，把 Pebble 戒指的每条提醒都发到 Muse 的独立聊天里。
读者常问
树莓派和 ESP32，到底买哪个？
看你要干什么。便携小硬件、接电池跑几个月，选 ESP32。复杂逻辑、跑脚本、管一堆设备，选树莓派。很多读者最后两个都要。
系统要装桌面版吗？
不需要。Raspberry Pi OS Lite 就够。没桌面环境，占内存小，TF 卡省空间，SDK 在命令行跑得稳。装桌面反而浪费。
零成本旧机真的能用吗？
能。官方原话：其他 Linux 电脑也行，只要带蓝牙 LE。旧电脑装 Ubuntu，跑同样的 install.sh。但旧电脑功耗大，得一直插电。树莓派赢在省电、体积小、24 小时开着不心疼。
装错了怎么卸？
bash install.sh --uninstall # 卸载
bash install.sh --uninstall --purge # 连配对记录一起忘掉
事实核实声明
- 支持板子（带蓝牙的 3B+/4/5/Zero 2 W，其他带蓝牙 LE 的 Linux 电脑也行）：2026-10-23 读取官方
linux/README.md原文实测。 - 系统要求（Raspberry Pi OS Bullseye+、Debian 11+、Ubuntu 22.04+，32/64 位均可）：2026-10-23 读取官方
linux/README.md原文实测。 - 安装命令（curl 拉
linux/install.sh，bash install.sh --sdk-token mgst_…，装到/opt/musegadget，起musegadget服务）：2026-10-23 读取官方linux/README.md原文实测。 - Token 领取地址（gadgets.muse.ai/settings/sdk-tokens，Account > SDK tokens，每个设备一个）：2026-10-23 读取官方
linux/README.md原文实测。 - 安全警告原文（”Muse gets the same access to the machine as the account you install it for.”）：2026-10-23 读取官方
linux/README.md原文，未改动。 - 低权限账号方案（
bash install.sh --run-as someone）：2026-10-23 读取官方linux/README.md原文实测。 - 4 个官方命令（system.run/file.read/file.write/device.health，64KB 分片，health 含温度）：2026-10-23 读取官方
linux/README.md原文实测。 - 配对流程（开发者模式→添加设备→MuseGadgetXXXXXX→社区设备确认→Wi-Fi 选显示的网络→10 分钟窗口→
sudo musegadget pair重开）：2026-10-23 读取官方linux/README.md原文实测。 - Token 存储位置（
/var/lib/musegadget/sdk_token，仅 root 可读；换 Token 后要sudo musegadget pair --force重配）：2026-10-23 读取官方linux/README.md原文实测。 - 机器给 Muse 发消息（
musegadget send-user-msg）：2026-10-23 读取官方linux/README.md原文实测。 - 仓库状态：2026-10-23 调 GitHub API 实测，star 2370，最后推送 2026-10-21，open issue 135，未归档。
- 本章初稿由外部 AI 生成，安装流程部分与官方文档不符，已按 2026-10-23 读取的官方
linux/README.md原文全部改写。
相关章节
上一章：《Muse Gadgets 实战》第 10 章：M5Stack 生态快速上手（https://jinbufenzi.com/13505.html）
下一章：《Muse Gadgets 实战》第 12 章：Skills 系统：40+ 智能家居玩法（待发布）
常见问题
树莓派能干什么，ESP32 干不了
ESP32 适合按键、灯带这类小交互。树莓派不一样，它有完整操作系统。
树莓派和 ESP32，到底买哪个？
看你要干什么。便携小硬件、接电池跑几个月，选 ESP32。复杂逻辑、跑脚本、管一堆设备，选树莓派。很多读者最后两个都要。
系统要装桌面版吗？
不需要。Raspberry Pi OS Lite 就够。没桌面环境，占内存小，TF 卡省空间，SDK 在命令行跑得稳。装桌面反而浪费。
零成本旧机真的能用吗？
能。官方原话：其他 Linux 电脑也行，只要带蓝牙 LE。旧电脑装 Ubuntu，跑同样的 install.sh。但旧电脑功耗大，得一直插电。树莓派赢在省电、体积小、24 小时开着不心疼。
