ROS2와 ChatGPT 연동, 따라만 하면 10분이면 끝!

여러분, 상상해보세요. 로봇에게 "거실 청소 좀 해줘"라고 말하면 로봇이 알아서 움직이는 세상. 공상과학 영화 같다고요? 실은 ROS2와 ChatGPT만 연동하면 이게 진짜로 가능해요. 오늘 이 튜토리얼을 따라 하면, 여러분의 로봇도 자연어를 이해하는 똑똑한 로봇으로 변신할 수 있어요!

🛠️ 시작 전 준비물 — 이것만 있으면 돼요

복잡한 장비가 필요할 것 같죠? 전혀 아니에요. 준비물은 딱 세 가지예요. 첫째, Ubuntu 22.04가 설치된 컴퓨터 (가상머신도 OK). 둘째, ROS2 Humble 설치 완료. 셋째, OpenAI API 키. 이게 끝이에요. ROS2가 아직 설치 안 됐다면 공식 문서를 참고해서 먼저 설치해주세요. API 키는 OpenAI 사이트에서 무료로 발급받을 수 있어요.

📌 Step 1: Python 패키지 설치하기

터미널을 열고 아래 명령어를 입력해주세요. openai 파이썬 라이브러리를 설치하는 거예요. 마치 레시피 재료를 준비하는 것처럼, 이게 있어야 ChatGPT와 대화할 수 있거든요.

pip install openai rclpy

설치가 끝나면 제대로 들어갔는지 확인해볼게요. python3 -c "import openai; print(openai.__version__)" 이 명령어를 입력했을 때 버전 번호가 뜨면 성공이에요!

📌 Step 2: ROS2 워크스페이스 만들기

이제 ROS2 프로젝트를 만들 차례예요. 워크스페이스는 쉽게 말해서 "작업 폴더"예요. 요리할 때 도마 위에서 작업하는 것처럼, ROS2도 정해진 공간에서 작업해야 해요.

mkdir -p ~/chatgpt_robot_ws/src && cd ~/chatgpt_robot_ws/src

ros2 pkg create --build-type ament_python chatgpt_commander

이렇게 하면 chatgpt_commander라는 패키지가 만들어져요. 이 패키지 안에 ChatGPT와 로봇을 연결하는 코드를 넣을 거예요.

📌 Step 3: ChatGPT 노드 코드 작성하기

여기가 핵심이에요! chatgpt_commander 폴더 안에 새 파이썬 파일을 만들어주세요. 이 코드가 하는 일은 간단해요. 사용자의 음성이나 텍스트 명령을 받아서 ChatGPT에 보내고, ChatGPT가 분석한 결과를 ROS2 토픽으로 퍼블리시하는 거예요.

핵심 로직을 설명하면, ChatGPT에게 "너는 로봇 명령 해석기야. 사용자가 말하면 이동 방향과 속도를 JSON으로 변환해줘"라는 시스템 프롬프트를 주는 거예요. 그러면 사용자가 "앞으로 천천히 가줘"라고 하면 ChatGPT가 속도와 방향 값을 뽑아내주거든요. 신기하지 않나요?

📌 Step 4: 빌드하고 실행하기

코드를 다 작성했으면 빌드해볼게요.

cd ~/chatgpt_robot_ws && colcon build

source install/setup.bash

ros2 run chatgpt_commander commander_node

실행하면 터미널에 "ChatGPT Commander Ready!"라고 뜰 거예요. 이제 다른 터미널에서 명령을 보내보세요. "오른쪽으로 90도 회전해"라고 입력하면, ChatGPT가 이걸 분석해서 적절한 로봇 명령으로 변환해줘요.

🔧 트러블슈팅 — 이런 에러가 나면?

가장 흔한 에러 두 가지를 알려드릴게요. "API key not found" 에러가 나면 환경변수에 API 키가 제대로 설정됐는지 확인하세요. "Module not found" 에러는 가상환경 문제일 가능성이 높아요. ROS2와 pip 패키지가 같은 파이썬 환경에 있는지 체크해보세요.

🎯 다음 단계는?

축하해요! 여러분은 방금 AI와 로봇을 연결하는 첫 번째 다리를 놓았어요. 이걸 기반으로 음성 인식을 추가하거나, 실제 로봇 하드웨어에 연결하면 진짜 말 알아듣는 로봇이 완성돼요. 다음 글에서는 마이크 입력을 추가하는 방법을 다뤄볼게요. 오늘 바로 따라해보세요! 🚀