核心用法
本 Skill 为 Pollen Robotics 旗下 Reachy Mini 机器人提供完整的远程控制能力,通过封装好的 Bash 脚本 reachy.sh 或直接调用 REST API 实现交互。主要功能覆盖六大模块:
运动控制:头部具备 6 自由度(俯仰 ±0.5 rad、偏航 ±0.8 rad、翻滚 ±0.5 rad),支持 minjerk/linear/ease/cartoon 四种插值模式;机身支持 360° 无限旋转;双天线可独立控制角度。所有运动通过 goto 指令指定目标姿态与时长完成。
情感与舞蹈:内置 80+ 种预录制情感动画(如 curious1、cheerful1、surprised1)及 19 套舞蹈动作(如 groovy_sway_and_roll、dizzy_spin),通过 play-emotion 与 play-dance 调用,适合社交互动与演示场景。
相机抓拍:利用 WebRTC 技术通过 snap 命令非侵入式捕获 IMX708 广角相机画面,保存为 JPEG;需 SSH 凭证(默认用户 pollen/密码 root)。注意机器人需处于唤醒状态(wake-up)否则镜头朝向机身内部。
应用管理:Reachy Mini 运行 Hugging Face Space 应用,支持 app-start/app-stop/apps 等指令管理,但同一时间仅允许单个应用运行,且应用可能独占机器人控制权。
音频感知:4 麦克风阵列支持声源定位(DOA),返回角度与语音检测状态。
系统状态:提供 status、state、motors、volume、wifi-status 等诊断指令,并支持 motors-gravity 重力补偿模式便于手动摆姿。
显著优点
- 功能全面:涵盖运动、视觉、听觉、情感表达四大维度,满足教育演示、科研原型、社交互动等多场景需求。
- 非侵入式抓拍:WebRTC 快照不中断后台守护进程,保证机器人持续可用。
- 开源生态:基于 Pollen Robotics 与 Hugging Face 的开源硬件/软件栈,社区资源丰富。
- 灵活控制:CLI 封装降低使用门槛,同时保留
raw指令与直接curl访问,兼顾易用与扩展。
潜在缺点与局限性
- 硬件依赖性强:必须物理拥有 Reachy Mini 机器人并处于同一局域网,无法云端模拟。
- 网络配置敏感:默认 IP
192.168.8.17需手动配置或环境变量覆盖,网络变更时需重新调整。 - 安全凭证硬编码风险:SSH 密码默认
root,虽可通过环境变量覆盖,但用户易遗忘修改,存在横向移动隐患。 - 应用独占冲突:运行中的 HF Space 应用会抢占机器人控制权,需手动
app-stop才能恢复手动指令,易造成困惑。 - 相机视角受限:睡眠状态下镜头朝内,必须预唤醒才能获取有效画面,增加操作步骤。
适合人群
- 机器人研究者与开发者:需要快速验证算法在实体机器人上的效果。
- 教育工作者与科普机构:利用情感动画与舞蹈进行人机交互演示。
- Hugging Face 生态用户:已熟悉 Spaces 与开源硬件流程的 Maker 社区成员。
- 创意技术艺术家:将机器人作为表演或装置艺术的执行终端。
常规风险
- 物理碰撞风险:
cartoon插值模式动作幅度大,若机器人靠近边缘或障碍物,可能因旋转/俯仰导致跌落或碰撞。 - 网络暴露风险:REST API(端口 8000)与 WebRTC 信令(端口 8443)若暴露于公网,可能被未授权控制。
- 凭证泄露风险:SSH 密码若保持默认且环境变量泄露,攻击者可远程执行任意命令。
- 设备损坏风险:
motors-enable状态下强行手动搬动关节可能造成电机过载;motors-gravity虽保护电机但仍需小心操作。 - 隐私风险:相机抓拍功能若被滥用,可能拍摄到敏感环境信息,需确保物理访问控制。