一台机器人,怎么被写进一个文本文件?读懂启元 Q1 的 URDF
两万块买回来的机器人,你会得到一个包装箱、一份说明书。但很多人不知道,机器人出厂时还自带另一份"自我介绍":一个记事本就能打开的文本文件。里面没有一张照片,全是数字和标签,却把这台机器人描述得清清楚楚:有哪些骨头、骨头之间怎么连接、每块多重、关节能弯到什么程度、碰撞时按什么形状计算。
这个文件叫 URDF(Unified Robot Description Format,统一机器人描述格式)。启元 Q1 的官方仓库里就有一个,文件名 q1_v3.urdf。
本文不谈怎么用它跑程序,只回答一个问题:一台真实的机器人,是怎么被写成一个文件的。读完你会看到,这份"档案"里的每一个字段,背后都站着一段机械学或数学的传统,最久的可以追溯到 1876 年。

一、档案总览:一类骨头,一类关节
打开 q1_v3.urdf,整个文件只反复做两件事:声明 <link> 和声明 <joint>。

link 是"骨头",机器人的每个刚体部件:骨盆、躯干、左大腿、右脚踝,各是一条 link。joint 是"关节",把两根骨头连起来并规定它们之间的相对运动。官方文件里数出来:26 条 link、25 个 joint。
这 25 个连接构成一个标准的"运动树"(kinematic tree):骨盆 pelvis 是树根,向下分出左、右两条腿链,向上经腰部连到躯干,躯干再分出双臂和头部。从树根到任意末端构件的一条路径,机器人学里叫"运动链"(kinematic chain)。运动链与运动树是机器人学教材的开篇概念(**《Modern Robotics》《机器人学导论》**都从它讲起),URDF 做的事,就是把这章知识变成程序可读的格式。


谁都可以验证这件事。我用 30 行纯标准库的 Python 写了个小工具,把官方文件数一遍:
git clone https://atomgit.com/primebot/q1-urdf.git
git clone https://atomgit.com/m0_63947499/q1-urdf-guide.git
python3 q1-urdf-guide/urdf_inspect.py q1-urdf/urdf/q1_v3.urdf

机器人: q1_v3
link 数: 26 joint 数: 25
关节类型: fixed×3 revolute×22
总质量(Σ link mass): 16.917 kg
根 link(树根): pelvis
可动关节: 22 个
二、关节解剖三要素:装在哪,绕哪转,转多少
关节是整份档案的核心,URDF 给每个 joint 写了三样东西,恰好对应机械设计里问一个关节的三个问题。
装在哪:origin 的位姿变换。 每个 joint 用 origin 声明子构件相对父构件的安装关系,xyz 是平移,rpy 是三个转角(roll-pitch-yaw 欧拉角)。看左髋关节的实际数值:xyz="0.0015 0.067658 0.021375" rpy="-0.34907 0 0",意思是髋关节装在骨盆左侧 6.8 厘米、偏下 2.1 厘米处,且带一个 -20° 的初始安装角。这一行在数学上是一个 4×4 的齐次变换矩阵(homogeneous transformation),是机器人学里最基本的工具。
绕哪转:axis 转轴。axis xyz="0 1 0" 表示绕 Y 轴(人体左右方向)转动,这正是髋、膝、肩、肘这类"屈伸"关节的方向;而腰部的 yaw 关节是 axis xyz="0 0 1",绕竖直轴转,所以它能左右转身。
转多少:limit 限位。lower 和 upper 用弧度写死行程。最好的例子是左膝:lower=0, upper=2.4435,换算成角度是 0° 到 140°,下限正好是 0。膝盖只能往一个方向弯,这句话在文件里的表达,就是下限为零。
把三要素连起来,就触到了 URDF 最深的一层:从树根出发,把路径上每个关节的变换矩阵连乘,就得到任意末端构件在世界里的位置和姿态。这叫正运动学(forward kinematics),是机器人学的第一门必修课。你在 RViz 里看到的机器人模型每一帧的姿态,本质就是这串矩阵乘法的实时结果。

三、关节类型的血统:六低副与 URDF 的取舍
q1_v3 只用了两种关节:revolute(转动关节,22 个)和 fixed(刚性连接,3 个:双腕和头部)。但 URDF 规范里其实定义了六种:revolute、continuous、prismatic、fixed、floating、planar。
为什么是这几种,要追溯到 19 世纪。德国机械学家 Franz Reuleaux 在 1875 年的德文原著《Theoretische Kinematik》中提出:**一切机构的基本连接可以归结为六种"低副"(lower pairs):转动副 R、移动副 P、螺旋副 H、圆柱副 C、球面副 S、平面副 E。**次年英译本《The Kinematics of Machinery》出版,这套分类从此进入全世界的机械原理教材,至今仍是第一课。URDF 的关节类型与之一脉相承:revolute 对应带限位的转动副 R,prismatic 对应移动副 P,continuous 是不限角度的 R。


URDF 没有把六种全做进去,只保留了机器人最常用的几种。这不是缺陷而是聚焦:人形机器人身上清一色的 revolute,一个转轴加上下限,就是一个可精确控制的膝关节或肘部。q1_v3 连一个 prismatic 都没有,因为人类的关节里本来就没有"直线滑动"的自由度。

四、体检指标:惯量档案
每条 link 里都有一段看起来最"劝退"的内容:
<inertial>
<origin xyz="0.002043 -4e-06 0.049044" rpy="0 0 0" />
<mass value="1.82817" />
<inertia ixx="0.004199" ixy="1e-06" ixz="-7.6e-05"
iyy="0.002489" iyz="0.0" izz="0.003016" />
</inertial>
三行分别是:质心位置(origin,通常是三个小数)、质量(mass)、惯性张量(inertia)。以骨盆为例:重 1.83 千克,质心偏移几毫米,惯性张量六个数。前三个(ixx、iyy、izz)描述绕三根轴转动的"倔强程度",越大越难让它转起来;后三个(ixy、ixz、iyz)描述轴与轴之间的耦合。把 26 条 link 的质量加总,就是整机 16.917 千克。
这套语言来自刚体动力学,牛顿-欧拉方程里的常客,《Modern Robotics》(Lynch & Park 著,官方网站提供免费电子版)用了整章讲它。在 URDF 里的角色可以概括成一句话:每块骨头的体重报告。物理引擎要算"这个零件被推一下会怎么运动",凭的就是质量加惯性张量;缺了这段,机器人在仿真里就是个没有重量、一碰就飞的空壳。

五、两套几何:给人看的,给引擎算的
很多读者会以为 URDF 里机器人的形状只有一个定义,实际有两套,q1_v3 里甚至数量都不一样:visual 24 个、collision 40 个。
visual 是外观层,引用 meshes 目录下的 STL 网格文件(三角面片拼出的精细外形),给 RViz 和渲染器显示用,追求"画得像"。collision 是碰撞层,用圆柱、盒这样的基元几何(geometric primitives)近似身体形状,给物理引擎做碰撞检测用,追求"算得快"。文件里的真实例子:某个碰撞体是一根半径 0.045 米、长 0.13 米的圆柱。一根腿用两三个圆柱近似,碰撞检测的计算量比用上千个三角面片低几个量级。
一个部件、两套几何、按需取用,这是 URDF 工程成熟度的直观体现:同一份档案既服务"好看"也服务"好算"。

六、安全边界:力矩分档与行程限位
档案里还有一类数字直接关系安全:每个可动关节都写着力矩上限 effort,q1_v3 的关节清晰地分成两档。髋、膝与腰部共 10 个承重关节是 36 N·m,踝、肩、肘等其余关节是 22 N·m。一档撑起全身重量,一档负责摆动肢体,电机的选型逻辑直接写在档案里。两万块的人形机器人,成本的大头就藏在这些各有力矩上限的关节电机里。
把几个代表关节的档案集中成一张表,一台机器人的"身体能力边界"一目了然(全部数值取自官方文件):
| 关节 | 类型 | 转轴 | 行程 | 力矩上限 |
|---|---|---|---|---|
| 左髋 pitch | revolute | Y(左右方向) | -175° ~ 90° | 36 N·m |
| 左膝 | revolute | Y | 0° ~ 140°(单向弯曲) | 36 N·m |
| 腰 yaw | revolute | Z(竖直方向) | ±90° | 36 N·m |
| 左肩 pitch | revolute | Y | -180° ~ 90° | 22 N·m |
| 左肘 | revolute | Y | -50° ~ 95° | 22 N·m |
| 头部连接 | fixed | — | — | — |
超出这些行程的指令,轻则被拒绝,重则损伤硬件。上表同时是理解机器人行为的钥匙:为什么跳舞流畅而空翻困难,为什么弯腰比转身慢,答案的一半都在这张表里。

七、这套写法从哪来:从 4 个数字到一棵树
**用文件描述机器人,URDF 不是第一个。**1955 年,Jacques Denavit 与 Richard Hartenberg 在《Journal of Applied Mechanics》上发表了论文《A Kinematic Notation for Lower-Pair Mechanisms Based on Matrices》:只需给每个关节配 4 个参数(后称 DH 参数),就能完整描述一条机械臂的几何。此后几十年,教科书里的机器人是一张参数表,每行四个数。
DH 参数强大但有两道门槛:它是为推导公式设计的,人读起来不直观;而且天生适配"单链"的机械臂,描述人形机器人这样的树形身体十分别扭。2010 年前后,URDF 随 ROS 1 出现,思路完全反转:不压缩成参数表,直接用 XML 把整棵树写出来,每个关节一段,父子关系一目了然。2017 年 ROS 2 延续这套格式,URDF 成为机器人描述的事实标准;2026 年,启元把 Q1 的 URDF 与 MuJoCo 格式模型一并开源。

DH 参数并没有被淘汰,它至今活在教材与工业机械臂的标定表里。"人人可读的树"取代"工程师专用的参数表"成为主流,是软件工程方法进入机器人领域的一个缩影。
八、URDF 不是孤岛:四种格式的格局
URDF 之外还有几位同行,各有靠山。Gazebo 生态用 SDF,物理引擎 MuJoCo 用自家的 MJCF,NVIDIA Isaac Sim 拥抱影视行业出身的 USD。它们解决的问题高度相似,侧重各不相同:SDF 强在描述完整场景,MJCF 强在物理细节的可调性,USD 强在复杂资产的分层组装。
启元 q1-urdf 仓库同时提供 URDF 与 MJCF 两套模型:一套对接 ROS 生态,一套对接 MuJoCo 物理仿真。这个细节值得玩味:厂商每多提供一种格式,就向一类工具生态多开一扇门。

九、为什么要关心一个文件
回望全文的路径:从一个文本文件出发,我们数出了机器人的骨头与关节,读懂了它的装配关系与正运动学,称出了它的体重,摸清了它的力矩分档与行程边界,还一路遇到了 1876 年的低副理论与 1955 年的 DH 参数。这就是 URDF 的意义:它把"机器人"从一台拧在一起的机器,变成一份任何人都可以检查、计算、复用的公共描述。
对开发者,开源的 URDF 意味着不买真机也能精确获得机器人的几何与惯性参数,仿真、规划、控制算法都可以先行;对普通读者,它是理解机器人最便宜的一扇门,打开官方仓库,比拆开机器更直观。机器人还没有走进千家万户,但它的"数字分身"早已在开源仓库里站了起来。
配套小工具(30 行读出机器人档案):https://atomgit.com/m0_63947499/q1-urdf-guide 官方模型仓库:https://atomgit.com/primebot/q1-urdf
更多启元机器人开发资源与文档,见启元机器人开发者社区:https://dev.primebot.com/
DAMO开发者矩阵,由阿里巴巴达摩院和中国互联网协会联合发起,致力于探讨最前沿的技术趋势与应用成果,搭建高质量的交流与分享平台,推动技术创新与产业应用链接,围绕“人工智能与新型计算”构建开放共享的开发者生态。
更多推荐



所有评论(0)