# xr_teleoperate 报错 No module named inspire_sdkpy

> 原文链接：https://robotics.hellobike.com/pitfalls/2026-05-09-xr-teleoperate-254
> 频道：pitfalls | 更新日期：2026-05-09 | 标签：auto, github-issue, xr_teleoperate
> 核心摘要：运行 xr_teleoperate 缺失 inspire_sdkpy 模块，需更新至指定 commit 或参考 inspire_hand_ws 仓库配置。

# xr_teleoperate 报错 No module named inspire_sdkpy

::: v-pre
> 本文由 AI 根据公开内容整理，可能有误，请以原文为准：[No module named 'Inspire_sdkpy'](https://github.com/unitreerobotics/xr_teleoperate/issues/254)（GitHub unitreerobotics/xr_teleoperate #254）

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

## 问题

在运行最新版 unitreerobotics/xr_teleoperate 时抛出 ModuleNotFoundError: No module named 'inspire_sdkpy' 异常。该问题同时出现在 G1 真机遥操作与个人电脑仿真环境中，即使 Inspire DFX 灵巧手服务已通过 ./hand_example 验证正常启动，Python 端仍无法导入 SDK。

## 环境

机型：Unitree G1；软件：unitreerobotics/xr_teleoperate 最新版；硬件：Inspire DFX 灵巧手；环境：G1 真机及个人电脑仿真环境。

## 解决办法

1. 拉取 xr_teleoperate 仓库最新代码，确保包含修复依赖的 commit `04e35a357ece1e56cd848a07ae33c0f6643b9f32`。
2. 若更新后仿真环境仍报错，参考已关闭 issue 中提及的 `NaCl-1374/inspire_hand_ws` 仓库进行 SDK 环境配置与依赖安装。
3. 重新运行遥操作程序验证 `inspire_sdkpy` 模块是否可正常导入。

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

## 原始参考来源 (Sources)

- [GitHub unitreerobotics/xr_teleoperate #254：No module named 'Inspire_sdkpy'](https://github.com/unitreerobotics/xr_teleoperate/issues/254)