具身智能机器人实战教程——模块1

MjModel：静态模型说明书模型一旦加载完成就不会变化，存储机器人的固定信息：机器人几何外形、关节类型、质量、摩擦系数、关节限位、场景地面灯光等参数。相当于一份图纸。
MjData：动态运行时状态数据每一步仿真都会发生改变，记录仿真实时状态：关节角度qpos、关节速度qvel、各个刚体位置姿态、接触力、施加的控制力矩等。相当于运行过程中的实时仪表盘读数。

口诀：Model 不变，Data 一直在变。所有读取机器人状态、下发控制指令，全部操作MjData对象。

第二章：MuJoCo 物理引擎基础

2.1环境安装

2.1.1前言

MuJoCo 是目前具身智能、人形机器人仿真的工业级物理引擎，凭借高精度动力学解算、高效碰撞检测、轻量化部署的优势，成为绝大多数机器人强化学习、仿真实战项目的首选工具。

本文适配T800人形机器人零基础实战课程，专门针对课程指定的 Python3.11 + Windows10/11 环境，提供从零开始的完整安装、配置、验证、排错教程。全程无复杂编译、无多余依赖，零基础可直接照搬操作，完美适配T800机器人仿真、PD控制、AI策略训练全流程开发。

✅ 适配环境：Windows10/11、Python3.11、Anaconda 虚拟环境

❌ 不兼容：Python3.12及以上高版本、老旧mujoco-py废弃版本

2.1.2环境前置准备

T800机器人实战课程全程基于Python3.11开发，高版本Python会出现依赖不兼容、仿真报错、模型加载失败等问题，务必严格统一版本。推荐使用Anaconda创建独立虚拟环境（隔离全局环境，避免版本冲突）。

第一步，下载安装miniconda，下载链接为https://www.anaconda.com/download/success

第二步，双击安装包应用程序，根据软件安装提示完成软件安装

在程序栏中出现下图内容则表明安装成功

第三步执行打开Anaconda Prompt程序，执行下面三个命令，安装虚拟环境

# 创建专属虚拟环境
conda create --name t800 python==3.11 -y

# 激活环境
conda activate t800

# 校验版本
python --version

2.1.3MuJoCo 正式安装

目前主流稳定版本为 MuJoCo 3.x，官方已废弃老旧的 mujoco-py，直接通过pip安装原生官方包即可，无需单独下载引擎、无需编译配置。

在激活的 t800虚拟环境 中执行安装命令：

conda activate t800
conda install -c conda-forge mujoco
pip install mujoco==3.4
pip install numpy==2.3.5

mujoco：官方原生物理仿真引擎，包含动力学解算、模型加载、仿真步进核心功能
numpy：数值计算依赖，机器人姿态计算、PD控制算法必备

2.1.4利用Trae等ai编程工具验证环境是否正常

第一步：下载安装Trae编译器工具，下载链接：TraeCode & AI 编程助手 | TRAE - The Real AI Engineer

第二步：创建一个文件夹，例如T800，打开Trae并注册账号，使用编程工具自动生成简单Demo验证环境是否能正常使用。

第三步，参考我的提示语生成代码

提示语：帮我写一个mujoco的木块掉落代码，在重力的作用下模拟自由落体，代码的名字01_mujoco_helloworld.py，我需要每隔200毫秒打印木块初始高度，木块的初始高度是1米。

第四步，运行生成的代码，检查是否能成功运行并打印木块具体高度信息。

命令解释如下：

(base) C:\Users\qx>conda activate t800   ##激活t800这个虚拟环境

(t800) C:\Users\qx>cd Desktop\T800       ##激活成功显示（t800）

(t800) C:\Users\qx\Desktop\T800>cd code  ##切换路径到ai代码存放的位置

(t800) C:\Users\qx\Desktop\T800\code>python 01_mujoco_helloworld.py    ##执行代码

2.2代码讲解

"""
01_mujoco_helloworld.py
MuJoCo 木块自由落体仿真（Hello World）
- 木块为 10cm 立方体，初始时底部离地 1 米
- 在重力作用下自由落体
- 每隔 200 毫秒（仿真时间）打印一次木块高度
运行: D:/miniconda3/envs/t800/python.exe 01_mujoco_helloworld.py
"""
import mujoco

# MJCF 模型: 地面平面 + 带自由关节的木块
XML = """
<mujoco>
  <option gravity="0 0 -9.81"/>     #重力加速度
  <worldbody>
    <geom name="floor" type="plane" size="2 2 0.1" rgba="0.8 0.9 0.8 1"/>
    <body name="block" pos="0 0 1.05">
      <freejoint/>
      <geom name="wood" type="box" size="0.05 0.05 0.05" mass="0.5"
            rgba="0.85 0.55 0.25 1"/>
    </body>
  </worldbody>
</mujoco>
"""

model = mujoco.MjModel.from_xml_string(XML)
data = mujoco.MjData(model)

HALF_SIZE = 0.05            # 木块半边长(米)
INITIAL_HEIGHT = 1.0        # 木块底部初始离地高度(米)
PRINT_INTERVAL = 0.2        # 打印间隔: 200 毫秒
SIM_DURATION = 2.0          # 总仿真时长(秒)

# 设置初始高度: freejoint 的 qpos[2] 是木块中心 z 坐标
data.qpos[2] = INITIAL_HEIGHT + HALF_SIZE
mujoco.mj_forward(model, data)

block_id = model.body("block").id
next_print = PRINT_INTERVAL


def print_height():
    z_bottom = data.xpos[block_id][2] - HALF_SIZE  # 底部离地高度
    print(f"t = {data.time:5.3f} s | 木块高度 = {z_bottom:7.4f} m")


print_height()  # 打印初始状态 (t = 0)

while data.time < SIM_DURATION:
    mujoco.mj_step(model, data)
    if data.time >= next_print:
        print_height()
        next_print += PRINT_INTERVAL

用 MJCF 字符串定义场景：无限地面平面 + 10cm 木块立方体，木块挂 freejoint 可自由运动
重力 -9.81，初始中心位置设为 1.0 + 0.05 = 1.05 m，使底部正好离地 1 米
仿真步长默认 0.002s，每累计 200ms 仿真时间打印一次木块底部离地高度
下落 0.2s 理论下降 ½gt² ≈ 0.196m，输出 0.8058m 与物理吻合；约 0.45s 落地后静止（-0.0001 是软接触的正常微小穿透）

总结

通过本文教程，你已完成 Python3.11 + MuJoCo 官方最新版 完整环境搭建，完美适配黑马T800人形机器人具身智能实战项目，可支撑后续所有课程内容：机器人模型加载、PD运动控制、力矩约束调试、AI策略生成、物体交互仿真等开发场景。

下一节学习预告：加载T800人形机器人官方模型，拆解机器人连杆、关节结构，掌握机器人姿态、关节状态读取方法，正式开启人形机器人仿真开发实战。

DAMO开发者矩阵

DAMO开发者矩阵，由阿里巴巴达摩院和中国互联网协会联合发起，致力于探讨最前沿的技术趋势与应用成果，搭建高质量的交流与分享平台，推动技术创新与产业应用链接，围绕“人工智能与新型计算”构建开放共享的开发者生态。

更多推荐

大模型安全之九:LLM错误信息（Misinformation）

DAMO开发者矩阵

展会快讯｜杭州AI Show盛大启幕！昕触科技携手Haply Robotics公司亮相，让AI机器人“触手可感”

在这场行业重磅盛会中，昕触科技携手Haply Robotics重磅亮相3F220展位，联合展出全套力触觉反馈硬件、主从遥操作系统、触觉数据集及仿真解决方案，以硬核技术打破传统智能交互壁垒，为工业运维、精准医疗、机器人科研、智能仿真等领域，带来可落地、高精度的具身智能交互新方案，成为展会现场超高人气焦点。双方此次再度联手，依托各自技术优势深度融合，打通硬件设备、仿真算法、数据支撑、场景落地全链路，彻