1. 项目概述Reachy Mini无线版是什么如果你对桌面级机器人感兴趣最近可能听说过Reachy Mini。它是一款基于Raspberry Pi树莓派的开源机器人套件设计初衷就是让机器人开发变得触手可及。而我今天要聊的是它的“无线版”——一个摆脱了USB线缆束缚完全通过Wi-Fi进行控制和编程的版本。这不仅仅是少了一根线那么简单它意味着你可以把机器人放在房间的任何角落通过你的笔记本电脑远程调试代码、查看摄像头画面甚至进行SLAM建图而无需围着它转。对于教育、原型开发甚至是家庭娱乐场景来说这种自由度是革命性的。核心的改变在于通信方式。标准版Reachy Mini通常需要通过USB数据线连接到主机进行供电和通信。而无线版则将树莓派本身变成了一个独立的无线节点你通过SSH安全外壳协议登录到机器人内部的系统就像操作一台远程服务器一样。这样一来你的开发环境比如安装了VS Code的电脑和机器人的运行环境树莓派上的Raspberry Pi OS就实现了物理分离只靠家里的路由器连接。这种模式非常接近工业或研究中对真实机器人的远程部署和运维对于学习者来说是提前熟悉生产环境工作流的绝佳机会。那么谁适合折腾这个呢首先是机器人爱好者、高校学生或创客你想在实体机器人上验证算法但又不想被线缆限制。其次是教育工作者无线连接能让课堂演示更灵活学生可以在自己的座位上编写代码并实时看到机器人的反应。最后哪怕是好奇的极客想体验一下用Python控制一个七自由度机械臂的乐趣Reachy Mini无线版也是一个入门门槛相对友好、社区支持活跃的选择。整个设置过程本质上就是配置一台特殊的、带机械臂的“树莓派电脑”接入网络并打通你的电脑到它的远程访问通道。2. 核心需求与方案选型解析2.1 为什么选择无线Wi-Fi方案选择将Reachy Mini改为无线控制背后有几个非常实际的考量。最直接的当然是物理空间的解放。有线连接时机器人的活动半径被限制在USB线长度通常1-2米内并且线缆容易被机械臂缠绕或拉扯存在安全隐患。无线化后只要在同一个Wi-Fi网络覆盖下机器人可以放置在桌子、展台甚至移动平台上大大扩展了其应用场景比如进行长时间的自主运行测试或作为交互展示装置。其次是开发体验的优化。有线模式下你的主力开发机比如性能强大的台式机必须和机器人放在一起。无线化后你可以用任何一台联网的电脑甚至是平板进行开发。你可以舒服地坐在沙发上用VS Code通过SSH远程编辑机器人上的代码文件并在远程终端里运行它们。这种“远程开发”模式是现代软件工程的常见实践提前掌握对职业发展也有好处。从技术实现角度看Wi-Fi SSH的组合是经过验证的稳定方案。树莓派内置的Wi-Fi模块性能足以传输控制指令、传感器数据和低延迟的视频流如果使用其摄像头。SSH提供了加密的通信隧道保证了控制过程的安全同时它也是访问Linux系统的标准方式兼容性极佳。相比于其他无线方案如蓝牙距离短、带宽低或专用的射频模块需要额外硬件和驱动Wi-Fi是现成的、无需额外成本且功能全面的选择。2.2 核心组件与工具链梳理要成功设置Reachy Mini无线版你需要理解并准备好以下几个核心部分硬件核心Raspberry Pi。这是机器人的“大脑”。以树莓派4B或更新的型号为例它运行着Raspberry Pi OS一个基于Debian的Linux发行版。我们的所有配置都将在这个操作系统上进行。你需要确保树莓派的Wi-Fi模块正常工作。通信基石SSHSecure Shell。这是远程访问的协议。在设置初期我们通常需要先用有线方式HDMI键盘或USB串口登录树莓派开启SSH服务。之后就可以在局域网内的其他电脑上使用ssh pi[树莓派IP地址]这样的命令进行无头Headless即无显示器访问。网络枢纽本地Wi-Fi路由器。你的电脑和Reachy Mini必须连接到同一个局域网LAN。家用的无线路由器就能完美胜任。你需要知道路由器的Wi-Fi名称SSID和密码。开发与环境管理工具操作系统镜像工具如Raspberry Pi Imager用于将系统烧录到SD卡它有一个高级选项可以直接预配置Wi-Fi和开启SSH这是极大简化流程的关键。SSH客户端Windows系统可以使用PowerShellWin10内置、Windows Terminal或者传统的PuTTY。macOS和Linux系统直接在终端Terminal中使用ssh命令即可。代码编辑器与远程开发强烈推荐使用VS Code配合“Remote - SSH”扩展。它能让你像编辑本地文件一样编辑树莓派上的代码并提供远程终端体验无缝。包管理工具树莓派系统内使用aptAdvanced Package Tool来安装软件包例如Python库、机器人SDK等。整个工具链围绕“远程”二字构建。你的电脑是客户端和控制台树莓派是服务器和执行单元Wi-Fi网络是桥梁SSH是安全通行证而VS Code等工具则让这座桥梁变得像本地道路一样方便。3. 分步实操从零完成无线配置3.1 第一步系统准备与烧录含Wi-Fi预配置这是最重要的一步正确的初始配置能避免后续很多麻烦。我们将使用官方推荐的Raspberry Pi Imager工具因为它提供了最便捷的预配置功能。下载与安装前往树莓派官网下载对应你电脑系统Windows、macOS、Linux的 Raspberry Pi Imager 并安装。选择操作系统启动Imager点击“Choose OS”。对于Reachy Mini选择“Raspberry Pi OS (other)” - “Raspberry Pi OS Lite (32-bit)”。Lite版本没有图形界面更节省资源非常适合作为机器人后台系统。当然你也可以选择带桌面的版本但无线设置完成后图形界面通常通过VNC远程查看对性能要求更高。选择存储设备插入你的Micro SD卡建议16GB或以上Class 10速度在Imager中选择它。进入核心配置不要急着点击“WRITE”。先点击右下角的齿轮图标或在某些版本中为“设置”按钮这会打开“Advanced options”高级选项。请务必勾选以下两项Set hostname设置主机名。例如reachy-mini。这会让你的设备在网络上有一个好记的名字之后可以用ssh pireachy-mini.local来连接比记IP地址方便。Enable SSH启用SSH。选择“Use password authentication”并设置一个强密码。这是你远程登录的凭证务必牢记。Configure Wi-Fi配置Wi-Fi。填入你的国家代码如CN、Wi-Fi网络名称SSID和密码。这是让树莓派开机后自动连接Wi-Fi的关键。Set locale settings设置地区选项。建议将时区Timezone设置为Asia/Shanghai键盘布局Keyboard layout根据你的需要设置。烧录与安全弹出配置完成后点击“Save”然后点击“WRITE”开始烧录。完成后Imager可能会提示你“Continue”以弹出SD卡或者你需要手动在操作系统中安全弹出SD卡。注意预配置的信息会被加密保存在SD卡启动分区的一个特定文件中。首次启动时树莓派系统会读取这些配置并自动应用。这是目前最推荐的无头启动方式。3.2 第二步首次启动与网络确认将配置好的SD卡插入Reachy Mini的树莓派中接通电源使用合适的5V/3A USB-C电源适配器。树莓派将开始首次启动。等待启动首次启动会进行文件系统扩展等操作可能需要1-3分钟。观察树莓派的绿色活动指示灯ACT LED它会不规则地闪烁说明系统正在运行。查找设备IP地址树莓派连接Wi-Fi成功后我们需要知道它获取到的IP地址。有几种方法路由器管理界面登录你家路由器的管理后台通常地址是192.168.1.1或192.168.0.1在“已连接设备”或“DHCP客户端列表”中查找主机名为reachy-mini或你设置的名字的设备记下其IP地址例如192.168.1.105。使用网络扫描工具在电脑上使用arp -aWindows/macOS/Linux命令可以查看本地网络中的设备。或者使用更友好的工具如Angry IP Scanner或Fing手机App。使用mDNS主机名推荐如果你的电脑和路由器支持mDNSBonjour/Avahi你可以直接使用主机名.local后缀访问。这是最方便的方法。在终端中尝试ping reachy-mini.local如果能通说明主机名解析成功。3.3 第三步建立SSH连接与基础配置获取到IP地址或确认主机名可用后就可以进行首次远程登录了。打开终端命令行Windows在开始菜单搜索“PowerShell”或“Windows Terminal”并打开。macOS打开“终端”Terminal应用。Linux打开任意终端模拟器。发起SSH连接在终端中输入以下命令请将[IP地址]替换为你查到的实际IP或使用主机名ssh pi192.168.1.105或者使用主机名ssh pireachy-mini.local首次连接时系统会提示你无法验证主机的真实性并显示一个RSA密钥指纹。输入yes继续。然后会提示你输入密码输入你在Imager中为pi用户设置的密码。输入时密码不会显示这是正常的。登录成功如果一切顺利你会看到命令行提示符变为pireachy-mini:~ $这表示你已经成功登录到Reachy Mini的树莓派内部。基础安全与系统更新修改默认密码强烈建议登录后立即执行passwd命令为pi用户设置一个全新的、更复杂的密码。更新系统软件包执行以下命令确保系统是最新的。这可能需要一些时间取决于网络速度。sudo apt update sudo apt upgrade -y可选扩展文件系统如果你使用的不是Raspberry Pi Imager的预配置或者感觉存储空间不对可以运行sudo raspi-config选择“Advanced Options” - “Expand Filesystem”来确保SD卡所有空间都被利用。3.4 第四步安装Reachy SDK与依赖现在我们来到了机器人功能的核心部分——安装控制Reachy Mini所需的软件。安装Python及相关工具Reachy SDK基于Python。树莓派OS Lite通常预装了Python 3但我们还需要pipPython包管理器和虚拟环境工具。sudo apt install -y python3-pip python3-venv创建并激活虚拟环境虚拟环境能将项目依赖隔离避免污染系统Python环境是好习惯。python3 -m venv ~/reachy-env source ~/reachy-env/bin/activate执行后命令行提示符前会出现(reachy-env)字样表示已激活该环境。安装Reachy SDK使用pip从官方源安装。请访问Reachy的官方文档或GitHub仓库获取最新的安装命令。通常类似于pip install reachy-sdk实操心得由于网络环境差异直接使用pip install可能会很慢或失败。可以考虑使用国内镜像源加速例如pip install reachy-sdk -i https://pypi.tuna.tsinghua.edu.cn/simple安装过程会自动拉取一系列依赖如numpy、grpcio等请耐心等待。验证安装安装完成后在Python交互环境中简单导入测试python3 -c import reachy; print(Reachy SDK imported successfully!)如果没有报错说明SDK安装成功。4. 高级配置与开发环境搭建4.1 配置VS Code进行远程开发在本地电脑上使用VS Code远程编辑树莓派上的代码体验极佳。安装VS Code及扩展在本地电脑安装VS Code然后在扩展市场搜索并安装“Remote - SSH”扩展。连接远程主机点击VS Code左侧活动栏的“远程资源管理器”图标。在“SSH TARGETS”旁边点击“”号。输入连接命令ssh pireachy-mini.local或使用IP地址。在弹出的窗口中选择SSH配置文件保存的位置默认即可。在VS Code窗口的右下角点击新出现的绿色按钮选择“Connect to Host in New Window”。首次连接会要求选择平台选择“Linux”然后输入pi用户的密码。打开远程文件夹连接成功后新窗口的左下角会显示“SSH: reachy-mini.local”。点击“文件”-“打开文件夹”你可以打开树莓派上的任意目录例如/home/pi。现在你就可以像操作本地文件一样创建、编辑、保存Python脚本了。使用集成终端在VS Code中按Ctrl反引号键可以打开集成终端这个终端已经直接运行在树莓派上你可以在这里直接运行Python脚本控制机器人。4.2 编写并运行第一个控制脚本在VS Code打开的远程文件夹中创建一个新文件例如first_move.py。#!/usr/bin/env python3 Reachy Mini无线版 - 第一个动作测试脚本 确保Reachy Mini已通电且各关节处于初始安全位置。 import time from reachy import Reachy, parts # 创建机器人对象指定主机名即树莓派的IP或.local地址 # 因为SDK运行在机器人本机上所以这里用‘localhost’ reachy Reachy( hostlocalhost, # 关键点脚本在树莓派上运行所以连接本地 with_left_armparts.LeftArm(handforce_gripper), with_right_armparts.RightArm(handforce_gripper), with_headparts.Head(), ) # 让机器人头部移动到指定位置俯仰角pitch偏航角yaw print(Moving head to look forward...) reachy.head.look_at(x0.5, y0, z0, duration2.0) # 看向前方0.5米处 time.sleep(3) # 等待动作完成 # 控制右臂关节示例让肘部弯曲 print(Moving right elbow...) reachy.r_arm.r_elbow_pitch.goal_position -90.0 # 目标角度-90度 time.sleep(2) # 回到初始放松位置 print(Going to rest position...) reachy.goto( { reachy.head.neck_roll: 0, reachy.head.neck_pitch: 0, reachy.head.neck_yaw: 0, reachy.r_arm.r_shoulder_pitch: 0, reachy.r_arm.r_shoulder_roll: 0, reachy.r_arm.r_arm_yaw: 0, reachy.r_arm.r_elbow_pitch: 0, reachy.r_arm.r_forearm_yaw: 0, reachy.r_arm.r_wrist_pitch: 0, reachy.r_arm.r_wrist_roll: 0, }, duration3.0, ) time.sleep(3) print(Demo finished.) reachy.close()保存文件后在VS Code的集成终端确保在reachy-env虚拟环境中运行cd /home/pi source reachy-env/bin/activate python3 first_move.py如果一切正常你将看到Reachy Mini的头部和右臂做出相应的动作。请注意安全确保机器人周围有足够空间且所有线缆如摄像头线已固定好避免缠绕。5. 常见问题排查与网络优化5.1 连接类问题速查表问题现象可能原因排查步骤与解决方案SSH连接超时或拒绝连接1. IP地址错误。2. SSH服务未开启。3. 树莓派未成功连接Wi-Fi。4. 防火墙阻止。1.核对IP重新登录路由器后台确认IP或尝试ping reachy-mini.local。2.检查SSH若有显示器接上查看系统是否启动完成或用SD卡读卡器在电脑上查看SD卡根目录确认是否存在名为ssh的空文件无后缀。3.检查Wi-Fi查看路由器后台设备列表。或为树莓派接上显示器用命令行sudo raspi-config- “System Options” - “Wireless LAN”重新配置。4.防火墙树莓派OS Lite默认无防火墙。可以ping通但SSH连接慢DNS解析问题。在SSH命令中使用IP地址而非主机名连接。或在本地电脑的SSH客户端配置中为树莓派IP添加主机名映射。VS Code Remote-SSH连接失败1. 本地SSH密钥问题。2. VS Code扩展版本问题。3. 远程主机磁盘空间不足。1. 尝试在系统终端用命令行SSH连接看是否有更详细的错误信息。2. 更新VS Code和Remote-SSH扩展至最新版。3. 通过命令行SSH登录后运行df -h检查树莓派磁盘使用情况。运行Python脚本报错“ModuleNotFoundError: No module named ‘reachy’”1. 未在正确的虚拟环境中运行。2. SDK未安装成功。1.激活环境务必先执行source ~/reachy-env/bin/activate看到(reachy-env)提示符。2.重新安装在虚拟环境中重新运行pip install reachy-sdk并注意观察安装过程有无错误。机器人关节不动或动作异常1. 电源功率不足。2. 机器人未初始化到“休息”姿态。3. 脚本中关节名或参数错误。4. 硬件连接松动。1.检查电源使用官方推荐或足额的5V/3A电源适配器。2.初始化先运行sdk中提供的归零或休息姿势脚本。3.检查代码对照官方API文档核对关节名称和角度范围。4.检查硬件断电后检查所有舵机与树莓派的连接线是否插紧。5.2 网络稳定性优化技巧无线控制的稳定性核心在于网络。以下是一些提升体验的技巧固定树莓派IP地址在路由器后台为树莓派的MAC地址分配一个固定的IPDHCP保留地址。这样每次重启后IP都不会变免去重复查找的麻烦。使用5GHz Wi-Fi频段如果路由器和树莓派树莓派4及以上支持5GHz都支持优先连接5GHz网络。它干扰少、速度更快对于传输摄像头视频流尤其有益。优化路由器位置尽量让路由器和Reachy Mini之间减少墙体阻隔确保信号强度。可以登录树莓派使用命令iwconfig wlan0查看连接质量和信号强度。考虑有线备用方案对于需要极高稳定性的演示或实验可以准备一根网线。当Wi-Fi不稳定时通过USB以太网适配器或树莓派的有线网口进行连接作为备用方案。5.3 性能监控与维护长期运行机器人需要关注系统状态查看CPU/内存使用在SSH终端中运行htop命令需先安装sudo apt install htop可以动态查看系统资源占用情况。如果运行复杂模型时CPU持续满载可能需要优化代码。监控温度树莓派在驱动多个舵机时可能会发热。运行vcgencmd measure_temp可以查看核心温度。如果温度持续过高如超过80°C考虑增加散热片或小风扇。管理开机自启动如果你有需要在开机时自动运行的机器人程序如一个服务端可以将其编写为systemd服务这是Linux系统标准的管理方式比放在rc.local中更可靠。设置Reachy Mini无线版的过程本质上是一次标准的嵌入式Linux设备网络配置与远程开发环境搭建。它融合了硬件操作、网络知识和软件开发是一次非常综合的实践。当你第一次通过Wi-Fi让机械臂随你的代码舞动时那种“无线操控”的成就感会让人觉得所有的折腾都是值得的。最关键的是这套基于SSH和远程开发的流程是通往更复杂机器人系统乃至服务器运维的通用技能一次投入多处受益。如果在配置过程中遇到上面未覆盖的奇怪问题不妨去Reachy的官方社区或论坛搜索一下很可能已经有先驱者踩过同样的坑并留下了解决方案。