# unitree_mujoco仿真启动报错Joystick open failed

> 原文链接：https://robotics.hellobike.com/pitfalls/2026-09-22-unitree-rl-lab-136
> 频道：pitfalls | 更新日期：2026-09-22 | 标签：auto, github-issue, unitree_rl_lab
> 核心摘要：运行unitree_mujoco时报错Joystick open failed，需加载xpad内核模块并确认/dev/input/js*设备节点存在后重启程序。

# unitree_mujoco仿真启动报错Joystick open failed

::: v-pre
> 本文由 AI 根据公开内容整理，可能有误，请以原文为准：[Error: Joystick open failed.](https://github.com/unitreerobotics/unitree_rl_lab/issues/136)（GitHub unitreerobotics/unitree_rl_lab #136）

**状态**：有绕过办法

## 问题

在env_isaaclab环境下执行./unitree_mujoco启动MuJoCo 3.3.6仿真时，模型Link与Joint数据加载正常，但程序抛出Error: Joystick open failed错误导致无法继续运行，其他用户反馈存在相同问题。

## 环境

MuJoCo 3.3.6，unitree_mujoco仿真器，Linux系统（env_isaaclab环境），依赖xpad内核驱动及/dev/input/js*手柄设备节点。

## 解决办法

1. 执行 `sudo modprobe xpad` 命令手动加载xpad内核模块以启用手柄驱动支持。
2. 运行 `ls -l /dev/input/js*` 检查设备节点，确认输出包含类似 `/dev/input/js0` 且权限正确的条目。
3. 验证设备节点生成后，重新执行 `./unitree_mujoco` 启动仿真程序。

讨论原作者：@zhijun-yin 等，版权归原作者所有。
:::

## 原始参考来源 (Sources)

- [GitHub unitreerobotics/unitree_rl_lab #136：Error: Joystick open failed.](https://github.com/unitreerobotics/unitree_rl_lab/issues/136)