> ## Documentation Index
> Fetch the complete documentation index at: https://docs.warmcore-tech.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 문제 해결

> 민감정보 없이 진단 자료 수집하기

> **개발자 프리뷰 / 하드웨어 미검증:** X3 하드웨어와 실제 로봇에 배포된 실행 환경은 아직 검증되지 않았습니다. 로컬 테스트만으로 장치 호환성, 물리적 동작 또는 안전한 운용을 보장할 수 없습니다.

## Python에서 `rclpy`를 가져올 수 없음

같은 셸에서 호환되는 ROS 환경을 로드하고 SDK가 ROS에서 사용하는 Python 인터프리터로 실행되는지 확인하세요. [설치 안내](https://docs.warmcore-tech.com/ko/xiaoling-x3/v1/installation.md)의 가져오기 검사를 다시 실행합니다.

## 필요한 인터페이스를 찾을 수 없음

운영자가 승인한 네트워크, ROS 도메인, 미들웨어, 네임스페이스 및 실행 중인 소프트웨어 버전을 확인하세요. [노드와 패키지](https://docs.warmcore-tech.com/ko/xiaoling-x3/v1/nodes-packages.md)의 읽기 전용 명령으로 노드와 이름을 검사합니다. 탐색만으로 메시지 전달이나 QoS 호환성이 보장되지는 않습니다.

## WebSocket 이벤트가 도착하지 않음

승인된 엔드포인트, 브리지 상태, 접근 정책 및 네임스페이스를 확인하세요. 유휴 로봇은 관찰 기간에 이벤트를 생성하지 않을 수도 있습니다. 공유 로그에 대화 내용을 출력하지 마세요.

## 지원 요청

기존 Warmcore Tech 지원 채널에 SDK 및 소프트웨어 버전, 수행한 작업, 종료 코드, 민감정보가 제거된 오류 메시지를 제공하세요. 자격 증명, 주소, 식별자, 개인정보, 대화 내용 및 설정 덤프는 제외하세요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.