跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像AI 生图工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonAI算法

宇树 Qmini 双足机器人开源方案:硬件结构与控制系统详解

宇树 Qmini 是一款低成本开源双足机器人,提供完整硬件清单与 3D 打印模型。核心采用树莓派 4B 控制,搭载 11 个电机,支持模块化组装。软件基于 RoboTamer4Qmini 框架,利用 Isaac Gym 和 PPO 强化学习算法训练步态。项目涵盖从环境配置、URDF 建模到 PID 调优的全流程,适合开发者复现与研究。

微码行者发布于 2026/4/9更新于 2026/7/2433 浏览

宇树 Qmini 是一款由宇树科技设计并开源的低成本双足机器人,拥有完整的硬件 BOM 清单、电气系统框图、3D 结构的 STEP 文件、装配 SOP、URDF 模型和基础控制软件,适合业余爱好者、教育工作者和研究人员使用。

Qmini 机器人组装过程简单,个人开发者可以完全通过 3D 打印进行复刻,并以类似乐高的模块化方式组装自己的机器人,3-5 小时即可完成。该项目为机器人技术提供了一个便捷且经济的切入点,加速创新,并为全球机器人生态系统的发展做出贡献。

Qmini 秉承'优秀工具应该易于使用'的理念,在构建时充分考虑了简洁性和成本效益,以树莓派 4B(Raspberry Pi 4 Model B)作为默认主控板,机器人核心骨骼、四肢部件可以通过 3D 打印来制造,告别复杂机械加工;另外最关键的是开源的较为彻底从机械到驱动算法全公开;虽然编程技术门槛有一些,但相较于其他开源项目,代码结构清晰比较友好。

文章配图

Qmini 双足机器人架构方案

文章配图

Hardware: 硬件

• 提供完整的物料清单(BOM) • 提供电气系统框图 • 提供 DIY 制作说明

机械结构

• 提供所有机械部件的 STEP 文件 • 提供装配 SOP(标准操作程序)

Software: 软件

• URDF 模型 • 核心软件堆栈 RoboTamer4Qmini

结构设计

头部设计

树莓派位于头部后方,负责整个机器人的控制和数据处理。头部设计简洁,两个 4010 风扇为树莓派提供散热,确保其在长时间运行时的稳定性。

腿部结构

每条腿有 5 个自由度,包括髋关节的俯仰、侧摆和旋转,以及膝关节的俯仰和踝关节的俯仰。侧摆关节使用了齿轮来放大力矩,这种结构将侧摆运动的旋转轴线放到了身体外侧,减少了结构对其自由度的限制,提高了机器人的灵活性和稳定性。部分腿的关节设有限位,以防止过度运动导致损坏。

电池与配重

电池位于尾部,类似于恐龙等动物使用粗壮的尾巴做配重,这种设计有助于平衡机器人的前后重量,提高行走稳定性。提手的位置设计合理,便于搬运和调试。

散热设计

除了头部的两个 4010 风扇外,大腿内部还有两个 3010 离心风扇安装位,这种多风扇设计确保了机器人在高负荷运行时的散热效果。

3D 打印物料

得益于全面的开源资源,开发者可以轻松获取所有必需的组件。Qmini 的所有机械结构均可 3D 打印,几乎无需定制加工。机身主体零部件打印参数建议如下表所示。

零件材质墙层数顶部壳体层数底部壳体层数稀疏填充密度稀疏填充图案
机身顶部主架PLA44420蜂窝
机体主骨架PLA55520
蜂窝
机体前端风扇安装件PLA55520蜂窝
电池仓PLA33315网格/蜂窝
电池底部支撑件PLA33315网格/蜂窝
腿部 yaw 轴限位块PLA55520蜂窝
顶部 yaw 轴电机安装座PLA44420蜂窝
顶部陀螺仪安装座PLA33315网格/蜂窝
树莓派安装座PLA33315网格/蜂窝

图片

Qmini 机器人集成了 11 个 Unitree 8010 电机 —— 这是一种经过验证的执行器,可用于各种商业机器人平台。其中:

• 10 个电机驱动机器人的主要运动系统 • 1 个电机 位于机器人颈部,作为定制扩展预留

这种模块化鼓励开发者设计和制作自己的扩展原型,增强 Qmini 机器人的功能、美观性或交互性。

Qmini 双足机器人核心系统

Unitree Qmini 双足机器人树莓派电气连接

Qmini 机器人的电机通讯线由树莓派主板 USB3.0 接口经 Type-A 转 Type-C,接入 485 转接板。

  • 转接板 UART1 接出 485A/B 双绞,至右腿 0 号电机,右腿 0 至右腿 1 号电机,右腿 1 至右腿 2 号电机,形成 USB 总线 UART1。
  • 转接板 UART2 接出 485A/B 双绞,至左腿 0,左腿 0 号电机至左腿 1 号电机,左腿 1 号电机至左腿 2 号电机,形成 USB 总线 UART2。
  • 转接板 UART3 接出 485A/B 双绞,至髋关节 0 号电机,髋关节 0 号电机至髋关节 1 号电机,形成 USB 总线 UART3。
  • 转接板 UART4 接出 485A/B 双绞,至上身 2 号电机;上身 2 号电机至上 1,上身 1 号电机至上身 0 号电机,形成 USB 总线 UART4。
  • 发板散热风扇电源由开发板 GPIO2(正极 5V)和 GPIO14(GND)引脚输出 5V 对外供电。

软件系统安装

宇树已经帮我们准备好了现成的程序,我们只需要按步骤配置就行。就像给电脑装系统一样简单,但结果却是让你的机器人活过来!

树莓派烧录系统镜像:

# 下载 Raspberry Pi OS Lite
# 使用 Raspberry Pi Imager 烧录到 SD 卡
# 启动前在 boot 分区创建 ssh 文件(开启 SSH)

基础环境配置:

# 更新系统
sudo apt update && sudo apt upgrade -y
# 安装 Python 依赖
sudo apt install python3-pip python3-numpy python3-scipy -y
# 安装开发工具
sudo apt install git cmake build-essential -y

下载控制程序:

# 克隆官方控制代码
git clone https://github.com/vsislab/RoboTamer4Qmini.git
cd RoboTamer4Qmini
# 安装 Python 依赖包
pip3 install -r requirements.txt

控制程序主要由运动学计算(计算每个关节应该转多少度)、步态生成(规划走路的动作序列)、平衡控制(保持机器人不摔倒)组成。

URDF 模型加载:

# URDF 文件定义了机器人的结构
# 从 GitHub 下载:urdf/Qmini.urdf
# 这个文件描述了每个关节的位置和运动范围
cp urdf/Qmini.urdf ~/robot_ws/src/qmini_description/urdf/

联机调试

Qmini 采用了 VSISLab 团队开发的先进控制框架—RoboTamer4Qmini 项目。这套系统基于 Isaac Gym 仿真环境,使用 PPO 深度强化学习算法训练机器人步态控制策略。相比传统的手工编程方式,这种 AI 驱动的方法让机器人能够自主学习优化的行走模式。

图片

每条腿的 5 个关节都经过精确建模,比如髋关节 yaw 轴的活动范围设定为 -0.349 到 0.525 弧度,这个数值既保证步态灵活性,又避免机械干涉。

实际部署的技术流程:

项目提供了完整的开发工具链,虽然环境配置相对复杂(需要 Ubuntu、CUDA 11.4+、Isaac Gym 等),但一旦搭建完成,训练和部署过程非常直观:

# 训练新的控制策略
python train.py --config BIRL --name qmini_experiment
# 评估训练效果
python play.py --render --name qmini_experiment --time 10
# 导出部署模型
python export_pt2onnx.py --name qmini_experiment

工程调优的实际考量

虽然核心控制基于深度学习,但底层电机控制仍需要精确的工程调优。

项目提供了 PID 参数优化工具,帮助减小仿真与实际机器人行为之间的差异:

# 优化底层控制参数
python tune_pid.py --mode real

文章配图

目录

  1. Qmini 双足机器人架构方案
  2. 结构设计
  3. 3D 打印物料
  4. Qmini 双足机器人核心系统
  5. 软件系统安装
  6. 下载 Raspberry Pi OS Lite
  7. 使用 Raspberry Pi Imager 烧录到 SD 卡
  8. 启动前在 boot 分区创建 ssh 文件(开启 SSH)
  9. 更新系统
  10. 安装 Python 依赖
  11. 安装开发工具
  12. 克隆官方控制代码
  13. 安装 Python 依赖包
  14. URDF 文件定义了机器人的结构
  15. 从 GitHub 下载:urdf/Qmini.urdf
  16. 这个文件描述了每个关节的位置和运动范围
  17. 联机调试
  18. 训练新的控制策略
  19. 评估训练效果
  20. 导出部署模型
  21. 工程调优的实际考量
  22. 优化底层控制参数
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • Ubuntu 24.04 离线安装 Ollama 及导入模型教程
  • Pi0 机器人 VLA 大模型在昇腾 A2 平台上的测评
  • OpenClaw Dashboard 无法登录:systemd 缺失导致 Gateway 未启动
  • 阿里云大模型工程师 ACA 认证学习笔记:核心考点与知识体系
  • Llama-2-7B 昇腾 NPU 测评:性能数据、场景适配与硬件选型
  • 10 款 AI 论文辅助工具实测:选题、文献与写作全流程指南
  • HarmonyOS 6.0 Camera Kit 微距状态监听详解
  • YOLOFuse 与其他融合算法对比:性能与效率综合评估
  • 字节跳动前端社招面试经验总结
  • Claude Code 与 GitHub Copilot CLI 终端开发能力对比评测
  • AI Agent 框架选型指南:OpenClaw、LangChain、AutoGPT、CrewAI 深度对比
  • 前端 JS 加载失败处理方案:重试与多源备份
  • APK 反编译基础与静态分析方法详解
  • AI 智能体 Claude Code 从部署到项目实战详解
  • FPGA 项目开发完整流程及常用工具梳理
  • LLM 指令微调:数据质量与多样性对对齐效果的影响
  • kling-ai-vs-runway-gen-3-vs-luma-dream-machine-2026-ai视频生成器终极对比
  • 基于 OpenClaw 与微软开源组件搭建 AI 量化系统实战
  • GitHub Desktop 界面中文汉化指南
  • Trae MCP 搭建天气系统及 AI Excel 数据处理工具实战

相关免费在线工具

  • 加密/解密文本

    使用加密算法(如AES、TripleDES、Rabbit或RC4)加密和解密文本明文。 在线工具,加密/解密文本在线工具,online

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Gemini 图片去水印

    基于开源反向 Alpha 混合算法去除 Gemini/Nano Banana 图片水印,支持批量处理与下载。 在线工具,Gemini 图片去水印在线工具,online

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online