reachy-mini

🤖 开源桌面机器人的智能控制中心

🥥3总安装量 1评分人数 1
100% 的用户推荐

基于 Pollen Robotics 开源硬件的 Reachy Mini 机器人控制技能,通过 REST API 与 SSH 实现头部 6 自由度运动、情感动画、舞蹈表演及摄像头监控,为教育科研与创客场景提供实体机器人交互能力。

C

存在明显风险,不建议直接用于敏感场景

  • 来自社区或个人来源,建议先隔离验证
  • ❌ 硬编码默认 SSH 密码 `root`,存在凭据泄露风险,必须通过 `REACHY_SSH_PASS` 环境变量强制覆盖
  • ❌ SSH 连接禁用主机密钥检查(`StrictHostKeyChecking=no`),易受中间人攻击
  • ⚠️ API 通信使用未加密 HTTP 协议,局域网外传输存在窃听风险
  • ✅ 无 `eval()()`/()`/`exec()()` 等危险代码执行,无 SQL/命令注入漏洞
  • ✅ 摄像头数据仅本地保存,无静默上传行为
  • ⚠️ 需额外安装 `sshpass` 工具,部分受控环境可能受限

使用说明

核心用法

Reachy Mini 是一款由 Pollen Robotics 与 Hugging Face 联合推出的开源桌面机器人,本 Skill 通过封装其 REST API 与 SSH 通道,提供完整的机器人控制能力。用户可通过 reachy.sh 脚本执行头部 6 自由度运动(俯仰/偏航/翻滚)、360° 机身旋转、天线动画、80+ 种预设情感表情、19 套舞蹈动作,以及基于 WebRTC 的非侵入式摄像头快照。高级功能包括 4 麦克风阵列的声源定位(DOA)、扬声器音量控制、HuggingFace Space 应用管理,以及 reachy-react.sh 提供的上下文感知自动化反应系统——支持根据定时任务、心跳检测或事件触发实现「早安问候」「巡逻监控」「任务完成庆祝」等智能行为。

显著优点

硬件生态权威性:依托 Pollen Robotics 成熟的 Reachy 开源机器人平台,硬件设计经过学术验证,社区资源丰富。功能集成度高:单 Skill 覆盖运动控制、视听感知、情感表达、应用管理四大模块,无需多工具切换。非破坏性设计:摄像头快照采用 WebRTC 技术,不中断机器人守护进程;反应脚本具备故障容错,网络不可达时静默退出。教育友好性:参数化的运动指令(弧度制、持续时间、插值模式)适合机器人学教学,预设动画降低编程门槛。自动化扩展:通过 cron 与心跳机制,可将机器人无缝集成到智能家居或办公自动化工作流。

潜在缺点与局限性

网络依赖严格:默认硬编码局域网 IP(192.168.8.17),跨网段或远程控制需额外网络配置。安全基线薄弱:SSH 默认密码为 root 且禁用主机密钥检查,HTTP 通信未加密,存在中间人攻击风险。硬件门槛:需实体 Reachy Mini 机器人(售价约 3000-5000 美元),无法模拟测试。依赖链复杂:需预装 sshpassGStreamer` 插件及 Python 图像处理库,Linux/macOS 兼容性优于 Windows。并发限制:单次仅运行一个 HuggingFace Space 应用,应用独占控制期间手动运动命令失效。运动安全缺位:未内置碰撞检测或关节限位强制保护,错误参数可能导致机械结构应力损伤。

适合的目标群体

  • 机器人学研究者与高校实验室:需快速验证控制算法或人机交互假设
  • STEM 教育工作者:面向中高等教育的实体编程与 AI 课程教具
  • 创客与开源硬件爱好者:希望深度定制个性化机器人行为的极客用户
  • 智能家居集成开发者:寻求物理实体作为语音助手或自动化终端的进阶用户
  • Hugging Face 生态用户:已熟悉 Spaces 应用开发,希望延伸至物理世界交互

使用风险

网络安全风险:默认配置下 SSH 与 HTTP 明文传输,公共 WiFi 环境易被窃听或劫持。凭据泄露风险:硬编码密码若未通过环境变量覆盖,多用户系统存在横向移动隐患。物理安全风险:电机使能状态下意外运动可能夹伤手指或坠落损坏;睡眠状态下摄像头朝内,误判为故障。依赖可用性风险sshpass 在部分企业环境被安全策略禁用,需申请例外或改用密钥认证。性能瓶颈:WebRTC 快照依赖 GStreamer 解码,低算力主机可能出现 2-5 秒延迟;高频心跳触发 DOA 追踪与巡逻拍照将显著占用网络带宽与机器人计算资源。

reachy-mini 内容

文件夹图标references文件夹
文件夹图标scripts文件夹
手动下载zip · 16.0 kB
api-reference.mdtext/markdown
请选择文件