企业官网建设流程全解析

从零打造你的第一个情感机器人：Reachy Mini 开源机器人实战手记

【免费下载链接】reachy_miniReachy Mini's SDK项目地址: https://gitcode.com/GitHub_Trending/re/reachy_mini

Reachy Mini 是一个开源、可表达情感的桌面机器人项目，它把"会点头、会摇天线、能听懂你说话"的机器人伙伴，变成了任何人都能亲手组装和编程的现实。项目提供完整的 Python SDK、模拟器、示例代码与 AI 集成方案，从新手到进阶开发者，都能在几小时内让它活起来。这篇文章，我想以第一人称带你完整走一遍"从拆箱到开口说话"的全过程。

一个会"来劲"的桌面小家伙，凭什么？

第一次看到 Reachy Mini 的演示视频，我愣了好几秒。视频里那个白色的小机器人没有机械臂、没有轮子，只有一个圆圆的脑袋和两根天线，却会在说话时轻轻歪头、在开心时把天线竖起来。它不像机器，更像一只在认真听你讲话的宠物。

这让我忍不住想：一个没有腿、没有手的机器人，凭什么能传递情绪？

答案是它的"脖子"。Reachy Mini 的头部不是普通的两轴转台，而是一个6 自由度的斯图尔特平台——就是那种飞行模拟器里用的并联机构。六个小型电机推动六根连杆，让头部能完成俯仰、侧倾、偏航，甚至微妙的平移。配合头顶两根独立控制的天线，它能在点头之外，做出歪头思考、左右张望、天线一高一低表示疑惑这类"拟人化"的小动作。

传统机器人给人冷冰冰的感觉，往往不是因为功能不够，而是因为动作太"硬"。而 Reachy Mini 的运动系统从一开始就为"表达"而设计：它的 SDK 里甚至内置了"说话时轻轻摇摆头部"的功能，让 TTS 语音播报时机器人不再呆站着。这些细节，就是它"有灵魂"的原因。

拆开盒子：8 个电机与一套"脖子"的奥秘

把 Reachy Mini 拆开，硬件其实非常克制：头部 6 个电机驱动斯图尔特平台，躯干 1 个电机负责身体转向，再加 1 个电机控制天线组，总共 8 个高精度电机协同工作。所有 3D 打印文件、电路图纸、固件源码全部开源，这意味着你不仅能组装，还能随手改。

它的"感官"也很齐全：一颗 120° 广角摄像头负责看，4 麦克风阵列支持声源定位——它能判断声音从哪个方向来，然后转头"看向"说话的人；内置扬声器负责说，还能通过音频接口播放任意声音。

整机分两个版本：无线版自带树莓派 CM4 和电池，插电即自主运行；Lite 版通过 USB 连电脑，适合开发者调试。无论哪个版本，控制核心都是一个叫Daemon的后台服务，它负责跟电机、传感器打交道，对外暴露 REST API 和 WebSocket 接口，而你的 Python 代码只需要通过 SDK 连上这个服务即可。

十分钟，让一个机器人对你点头

如果你和我一样没有实体硬件，别急——项目提供了基于 MuJoCo 的完整模拟器，所有 API 与真实硬件完全一致。打开终端，启动模拟 daemon：

reachy-mini-daemon --sim

这一行命令会在你的电脑上启动一个"虚拟机器人"，它会监听 8000 端口等待你的指令。是不是很像给一个游戏服务器开了个房间？只不过这个"玩家"是机器人。

接下来安装 SDK：

git clone https://gitcode.com/GitHub_Trending/re/reachy_mini cd reachy_mini pip install -e .

安装完成后，打开浏览器访问http://localhost:8000/docs，如果能看到 API 文档页面，说明你的"虚拟机器人"已经就绪。整个过程大约十分钟，真正的硬件版也只是把连接方式从--sim换成 USB 或 Wi-Fi 而已。

亲手写第一行代码：摇天线、抬头看你

连接就绪后，第一次"驾驶"机器人的体验非常奇妙。项目官方 quickstart 里有一个最经典的例子，让机器人摇动天线向你打招呼：

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)

goto_target的意思是"在指定时间内平滑地走到某个目标姿态"，antennas=[0.5, -0.5]让两根天线一上一下，像狗狗竖耳朵。三条指令连起来，就是一次完整的"天线打招呼"。

我更喜欢的是让它"抬头看你"的感觉：

from reachy_mini import ReachyMini from reachy_mini.utils import create_head_pose with ReachyMini() as mini: mini.goto_target( head=create_head_pose(z=10, roll=15, degrees=True, mm=True), duration=1.0 )

create_head_pose用来构造一个头部姿态，z=10表示头部微微抬高 10 毫米，roll=15表示侧倾 15 度——运行这一秒，你会真切感到那个圆脑袋在"注视"你。这种体验很难用文字传达，我建议你亲手跑一次。

如果你想让动作更"活"，项目还提供了set_target高频直控接口，可以在 100Hz 下实时计算正弦波，让头部和天线像呼吸一样自然摆动：

import time, numpy as np with ReachyMini(media_backend="no_media") as mini: while True: t = time.time() pitch = np.deg2rad(10 * np.sin(2 * np.pi * 0.5 * t)) mini.set_target( head=create_head_pose(pitch=pitch, degrees=False, mm=False), antennas=[np.deg2rad(20 * np.sin(2 * np.pi * 0.5 * t))] * 2, ) time.sleep(0.01) # 100 Hz

这段代码让机器人的头部和天线按正弦曲线轻轻晃动，配合 10 毫秒的刷新间隔，运动非常丝滑。把数学公式变成活生生的动作，这就是机器人编程最迷人的地方。

让它看见、听见、开口说话

运动只是第一步。Reachy Mini 的media模块把摄像头和麦克风封装成了极简接口，比如拍一张照片：

with ReachyMini() as mini: frame = mini.media.get_frame() # 拿到一帧画面 cv2.imwrite("reachy_mini_picture.jpg", frame)

get_frame()返回摄像头的一帧图像，配合 OpenCV 就能做实时视觉处理。录音也差不多：

mini.media.start_recording() # ... 循环获取音频样本 ... mini.media.stop_recording()

真正让我惊喜的是 TTS 示例：它调用 Hugging Face 上的多语言语音克隆服务生成音频，然后让机器人播放，同时自动开启头部摇摆——机器人说话时脑袋会跟着节奏轻轻晃动，活脱脱一个在认真讲话的小演讲家。声源定位示例则让机器人能听到声音从哪来、转向声源。当它真的"看向"你说话的方向时，那种被注视的感觉，是任何屏幕上的虚拟形象都给不了的。

给机器人装上"AI 大脑"

Reachy Mini 的野心不止于"会动"，更在于"会思考"。它的生态里有一个基于 Hugging Face Spaces 的应用商店：对话应用让机器人接上大语言模型自然聊天，手部追踪应用让机器人实时跟随你的手部动作，还有电台、教育等各类应用，一键安装即用。

开发自己的 AI 应用也异常顺畅：SDK 同时提供 Python 和 JavaScript 版本，后者通过 WebRTC 让浏览器直接驱动机器人，写好的应用分享出去，别人打开网页就能操控你的机器人，零安装。你可以把视觉模型、语音模型、大语言模型统统接进去，让它真正成为你的 AI 实体化身。

我还注意到项目为 AI 编程助手准备了AGENTS.md指南——把"我想创建一个 Reachy Mini 应用"这句话粘贴给 Claude Code 或 Copilot，智能体就能读懂 SDK 规范，直接帮你生成代码。用 AI 编程做机器人，这大概是 2026 年最省力的玩法了。

没有硬件？模拟器同样能玩

如果你暂时没有实体机器人，完全不必劝退。模拟器支持全部核心 API：运动、视觉、音频、甚至重力补偿模式都能体验。你可以在模拟环境里调试好整套行为逻辑，等硬件到手直接无缝切换。先练手、后上手，成本几乎为零。

另外，SDK 对安全性的考虑也很贴心：头部俯仰和侧倾限制在 ±40 度、身体转向限制在 ±160 度，一旦超过安全范围，SDK 会自动把目标值钳制到最近的安全位置，防止机器人自己撞伤自己。还有刚性模式、断电松弛模式、重力补偿模式三种电机状态，后者让你可以徒手掰动它的头，它会像被捏住后停住的小动物一样，停在原地等你松手。

关于常见疑问的几点解答

问：完全没有机器人基础，能玩转吗？能。项目提供了 Jupyter 教程笔记本，从连接、移动到媒体播放一步步引导，跟着敲就能跑通第一个 demo。

问：需要哪些软件环境？Python 3.8 以上即可，建议使用 uv 或 pip 创建虚拟环境；运行媒体功能需要安装 GStreamer，文档里有针对各操作系统的详细说明。

问：跑不动视觉模型怎么办？分布式架构的好处就在这——SDK 可以在你性能强劲的电脑上运行 AI 逻辑，Daemon 在树莓派上管硬件，两者通过网络通信，各司其职。

别等了，让第一个机器人动起来

回头看看整个过程：十分钟装好环境，半小时跑通第一个动作，一个下午让它学会说话和转头——Reachy Mini 最打动我的，是它把"机器人"从遥不可及的神坛上拉了下来。你不需要焊接电路板，不需要写底层驱动，只需要会写几句 Python，就能拥有一个会回应你的桌面伙伴。

创造的过程，往往比结果更有趣。从让天线摆动第一下开始，到给它装上一个会说冷笑话的 AI 大脑，每一步都是你自己的作品。项目仓库就在https://gitcode.com/GitHub_Trending/re/reachy_mini，克隆下来，运行模拟器，写下属于你的第一行机器人代码。你的机器人之旅，现在就可以开始。

【免费下载链接】reachy_miniReachy Mini's SDK项目地址: https://gitcode.com/GitHub_Trending/re/reachy_mini