装好并连上 Reachy Mini Control
Reachy Mini Control 是官方的桌面应用,把状态与 3D 可视化、App 启动器、系统设置收在一个窗口里,官方明确写着 no command line required,装好之后大部分日常操作都不必碰命令行。先从官方下载页取对应系统的安装包,下载不到时官方也把 GitHub Releases 列作备选来源。它会自己更新,也会顺带把机器人内部的软件一起更到合适版本,所以首次连上后别急着跳过更新提示。装完打开应用,让它去发现同一网络里的设备;正常的话主界面会列出机器人并能点进去,如果列表一直空着,先确认电脑和机器人处在同一个网段,再看下面的网络与重启两节。
下载前把系统这事定清楚:官方安装页把 Linux、macOS、Windows 三项都标成支持,Windows 还有独立的安装小节。网上把 Windows 说成不受支持、或说要等以后才支持,都是过时的说法,别据此去等一个不存在的更新,直接装当前版本即可。
但桌面应用对机器架构有硬性前提。在 ARM64 的 DGX、Jetson、Surface 这类设备,以及一些特殊的 Linux 发行版上,桌面应用可能装不上或跑不起来;官方给的退路很明确:这类环境改用 Python SDK 直连机器人,功能不受影响,只是少了图形界面,控制与动作都从脚本发起,桌面应用里的表情、状态面板这些界面功能也就用不上了。碰到安装即报错、窗口打不开,先对照是不是落在这些平台里,别在桌面应用上反复折腾。
Reachy Mini Wireless 首次配好 Wi-Fi 之后,还有一步必须补做:进 Control 的 Settings(界面上是齿轮图标)页,点 System Updates 跑一次系统更新。这一步把板内软件对齐到能正常工作的版本,漏掉后容易出现命令跑不通、状态对不上这类难查的问题。看到更新完成、应用提示已是最新,再往下走。
界面上每一页分别管什么
连上之后,主要就在这几页之间切换。各页职责是并列的,照用途找即可:
| 页签 | 能做的事 |
|---|---|
| Controller | 手动控制头部姿态与两根天线,适合先确认电机有没有反应 |
| Expressions | 播放内置的情绪表情,点一下就能看到机器人做出成套动作 |
| Settings | System Updates 做系统更新,Network 查看与调整网络 |
Reachy Mini Lite 打开应用后还有一块常驻的状态面板,排障时先扫一眼它,四块信息各管各的:
| 面板区域 | 你会看到 |
|---|---|
| 3D 实时视图 | 机器人当前姿态的同步模型,手动动一下头会跟着变 |
| 状态指示 | Ready 或 Not Ready,显示 Not Ready 时先别发动作指令 |
| 音频 | 麦克风输入电平与扬声器音量 |
| 底部日志 | 运行时的滚动日志,报错信息从这里抄 |
出问题先更新再重启
不管症状是连不上、动作卡住还是页面报错,官方给的万能第一步都是先更新、再重启,很多问题到这一步就消失了。按这个顺序做:把机器人按到 OFF,等 5 秒,再按回 ON;在 Control 里点 Check for updates;如果是从克隆仓库跑的,把代码对齐到最新 tag 或直接 git pull;Reachy Mini Wireless 上再跑一次系统完整性校验:
reachyminios_check
校验通过、应用重新识别到设备、状态回到 Ready,才算这一轮收尾。若重启后仍是老样子,再按现象往下分。
环境坏了选哪一档重置
桌面应用里装的应用跑不起来、依赖乱了,通常是 Python 环境被改坏。官方在设置里给了两档重置,差别在于动多少东西,选错会白等一场:
| 档位 | 会清掉什么 | 代价 | 什么时候用 |
|---|---|---|---|
| Reset apps environment | 只重建 apps_venv 这个应用虚拟环境 | 已装的应用需要重装 | 只是某个应用起不来、其余功能正常 |
| Full Environment Reset | 删掉全部 Python 文件并重新下载 | 要等几分钟重新拉取 | 多个应用都坏、依赖彻底乱掉 |
先试轻的那一档,确认不行再上 Full Environment Reset;后者执行后别断电,等它把文件重新下载完再操作。选档的判据就是坏的范围:单个应用的问题归第一档,整套环境都不对才归第二档。
电机红灯或不响应:用 Testbench 扫描
电机亮红灯、完全不响应,或者报 Overload、缺电机,这类硬件层面的症状交给 Reachy Mini Testbench 这个应用来查。安装并启动后先扫描一遍电机,看哪些 ID 没被找到;如果全部电机都在但状态仍有问题,用应用里的 Check all motors 校验配置,配置不对时 daemon 会在重启时自动 reflash 全部电机。扫描结果里连续缺号、或干脆一个都找不到,属于更细的硬件排查,按故障排查页继续查线。
关于扫描前要先做什么,两份官方材料写法并不一致,这里都列出来:整仓英文的电机诊断页写的是在桌面 App 设置里关掉 motor backend,把 daemon 停下来;HF 繁体中文镜像站的同一页写的是 Reachy Mini Lite 需先执行 reachy-mini-daemon --no-autostart,再打开 dashboard 安装 Testbench。镜像站版本与主分支并不同步,真要动手时以主分支英文文档为准;同一功能在不同版本里的入口位置也可能不一样,界面上找不到就按名称就近找对应开关。