这条主线怎么走
从快递箱到机器人第一次摆天线,中间是六步:开箱核对、组装走线、上电配网、系统更新、起 daemon、第一个动作。这一页把它们串成一条主线,每一步讲清做什么、做完该看到什么;细节拆在后面的专题页,卡住了直接跳对应页面。
第一步:开箱核对
做什么:拆箱后把所有零件与工具摊开,先整体过一遍再动手。套件内含组装所需的全部工具,包括螺丝刀,不需要自备,全程不需要焊接。会看到什么:结构件、螺丝、线缆与随附工具。官方口径组装全程约 2 到 3 小时,强烈建议配合官方的交互式在线指南或分段组装视频走,每一步都有对照,不要凭感觉硬装。卡住怎么办:觉得零件对不上号,先确认所有包装都拆完了再判定,缺件与多余螺丝的处理规则见「开箱与套件清单」页。
第二步:组装走线
做什么:按交互式数字指南逐步装配,指南里每一步都有短视频循环可以对照。官方提示组装的难点在走线与零件的拧紧扭矩,宁可慢一点一次装对,也别返工。会看到什么:机器人逐渐成形,装完接上线缆与电源;装完手里还剩少量线缆与螺丝属于正常情况,官方刻意多给备件,判定规则在开箱页。排线方向、摇臂刻线、头部线缆余量这些容易装错的点,见「组装与走线」页。
第三步:上电,Lite 与 Wireless 分两条路
Lite 路线
先把墙电电源接好给机器人供电,再用 USB 线把机器人接到电脑。注意 Lite 的 USB-C 口只走数据、不供电也不充电,电力必须来自墙电电源,USB 本身不足以驱动电机。会看到什么:电脑把机器人识别为 USB 设备;后续 daemon 就跑在这台电脑上。如果电脑没识别到设备,先换一根确认能传数据的 USB 线再试。
Wireless 路线
Wireless 不能像 Lite 那样用 USB 线接到电脑控制,USB-C 只是设备口,控制走 WiFi。首次配网按下面顺序:
- 按下电源键开机。
- 在电脑上安装官方桌面应用 Reachy Mini Control。
- 在 Control 底部点「First time connecting...」。
- 连上机器人开机后自己发出的 WiFi 热点。
- 按引导把机器人配置到你家的 WiFi 上。
会看到什么:配网完成后,Control 在网络上发现并连上你的机器人。卡住怎么办:找不到机器人发出的热点就先重启机器人再试,仍不行去「上电与首次配网」页查开关位置与网络环境限制。
第四步:系统更新
首次配网完成后必须做一次系统更新:Control → 设置 → System Updates,更新完重启一次机器人再继续。这步别跳过,低版本板内软件是配网后各种小问题的常见来源;Wireless 的更新会同时更新机器人内部软件,Control 应用本身也会自动更新。官方同时把「更新 + 重启」列为一切排障的万能第一步:按 OFF 关机等约 5 秒再按 ON 开机;在 Control 里 Check for updates;如果是克隆仓库装的,对齐最新 tag 或拉取最新代码;Wireless 还可以 SSH 进板内跑 reachyminios_check 校验系统完整性(默认登录用户名 pollen)。做完这一步,机器人处于最新软件状态,很多看起来玄学的问题到这里就消失了。
第五步:起 daemon
daemon 是机器人一侧的服务端,负责硬件 IO 与安全检查,对外暴露 REST 和 WebSocket 接口。按平台三选一:
- Wireless:开机自启,一般不用手动起,重启后稍等它起来即可。
- Lite:用桌面 App 启动,或在终端执行 reachy-mini-daemon。
- 仿真:reachy-mini-daemon --sim;macOS 用 mjpython -m reachy_mini.daemon.app.main --sim。
验证方法:浏览器打开 http://localhost:8000/docs(Lite 与仿真)或 http://reachy-mini.local:8000/docs(Wireless),看到 Reachy SDK 的接口文档页面,说明链路已通。打不开的话:先确认 daemon 进程在跑;Lite 检查 USB 线是不是数据线;Wireless 确认电脑和机器人在同一个网络。这背后的客户端-服务端架构见「第一个动作」页。
第六步:第一个动作
在电脑上装 SDK,官方安装命令用 uv 管理 Python 环境:
uv python install 3.12 --default uv venv reachy_mini_env --python 3.12 uv pip install "reachy-mini"
跑仿真的话,安装时改用带仿真附加依赖的 reachy-mini[mujoco]。然后新建 hello.py,写下第一个脚本:
from reachy_mini import ReachyMini
with ReachyMini() as mini:
mini.goto_target(antennas=[0.5, -0.5], duration=0.5)
mini.goto_target(antennas=[-0.5, 0.5], duration=0.5)
mini.goto_target(antennas=[0, 0], duration=0.5)
运行 python hello.py。会看到什么:两根天线交替左右摆动一次,然后回到中位。构造函数会自动检测你的机器是 Lite 还是 Wireless 并选择对应连接方式,不需要手动配置。卡住怎么办:安装时报 Python 版本相关的错,先去「版本辨识」页核对官方版本口径再处理。到这里主线走完,接下来按需深入:安全限位与运动 API 看「第一个动作」,不买机器先玩仿真看「MuJoCo 零硬件仿真」,装社区应用看「App Store 与社区应用」,出问题看「故障排查」。