TL;DR

TuyaOpenClaw는 TuyaOpen C SDK 위에서 작동하는 하드웨어 지향 Claw 에이전트로 MCU에서 Raspberry Pi와 Linux PC까지 단일 코드베이스로 배포될 수 있다. 에이전트는 메시지 버스 기반의 통합 IM 채널을 통해 입력을 받고 SOUL.md, MEMORY.md, 스킬 요약 등으로 시스템 프롬프트를 구성한 뒤 내부 도구 루프를 최대 10회 반복해 로컬 MCP 도구를 호출하거나 Tuya 클라우드의 모델을 사용하여 응답을 생성한다. 로컬 HW 제어용 FILE, EXEC, HW, CRON, Lua 스크립트 같은 도구와 PSRAM을 통한 확장 메모리 지원으로 엣지 장치에서 즉시 행동을 취할 수 있으며 단일 TuyaOpen API 키로 장치와 클라우드 통합을 간소화한다. 현재 활발히 개발 중인 상태여서 빌드 환경 설정과 시크릿 구성, 보드별 설정을 사전에 준비해야 하며 일부 기능은 특정 보드에서만 지원된다.

주요 기능

• 통합 메시지 채널을 제공하며 Telegram, Discord, Feishu, WeChat, QQ Bot을 하나의 메시지 버스와 TLS 프록시로 연결한다. 에이전트 루프는 채널별 특화 코드 없이 들어온 메시지를 처리하며 응답을 원래 채널로 되돌린다. 이 구조는 여러 IM 토큰을 설정하면 즉시 다양한 채널로 접근할 수 있게 한다.
• 디바이스-클라우드 하이브리드 에이전트를 지원하며 로컬 에이전트와 클라우드 에이전트가 동일 키로 연동된다. 에이전트는 SOUL.md, MEMORY.md, 스킬 요약 등으로 컨텍스트를 구성하고 최대 10회까지 내부 도구 루프를 반복해 결정을 완성한다. 도구 호출 결과는 즉시 응답 컨텍스트에 반영되어 로컬 행동이 신속히 수행된다.
• 여섯 가지 MCP 스타일 도구를 통해 스케줄, 파일 조작, 원격 명령 실행, 하드웨어 제어, Lua 스크립트 실행, OpenClaw 게이트웨이 제어를 로컬에서 직접 수행한다. FILE 도구로 SD나 플래시 파일 시스템을 읽고 쓰며 EXEC 도구는 RPi/Linux에서 쉘 명령을 스폰한다. HW 도구는 GPIO/I2C/PWM을 제어해 물리적 액추에이션을 가능하게 한다.
• 지속 메모리와 세션 관리 기능을 제공해 재부팅에도 대화 히스토리와 장기 메모리를 유지한다. MEMORY.md와 일일 노트 YYYY-MM-DD.md로 장기 저장을 수행하며 JSONL 기반 세션 매니저로 즉시 이어지는 세션 복구를 지원한다. 이로 인해 현장 장치의 장기 사용자 맥락 보존이 가능하다.

어떻게 동작하는가

레포의 실행 흐름은 외부 루프가 message_bus_pop_inbound로 IM 메시지를 블록 대기하고 컨텍스트 빌더가 SOUL.md, USER.md, MEMORY.md, 스킬 요약, 최근 대화 기록을 조합해 시스템 프롬프트를 구성하는 방식이다. 내부 루프는 최대 10회 반복하며 각 반복에서 프롬프트를 전송하고 AI의 툴 호출을 검사해 로컬 도구를 실행한 뒤 결과를 다시 프롬프트로 주입한다. 최종 응답은 메시지 버스를 통해 발신 채널로 다시 푸시되며 로컬 HW 제어와 클라우드 모델 호출이 이 순서로 결합된다.

해결 문제

하드웨어 제어와 에이전트 논리를 동일한 코드베이스에서 통합하여 엣지 장치에서 직접 도구 호출과 물리적 액션을 실행하는 문제를 해결한다. 단일 TuyaOpen API 키로 클라우드 모델 접근과 장치 관리를 연계해 인증과 연동 복잡도를 낮춘다. 다양한 MCU와 SoC에 맞춘 보드 설정과 빌드 플로우를 제공해 포팅 비용을 줄인다.

지금 주목받는 이유

엣지에서 실행 가능한 에이전트와 Tuya의 장치·클라우드 통합을 단일 키로 연결하는 설계가 구체적 하드웨어 지원과 결합되어 있으며, MCU에서 바로 실행 가능한 하이브리드 에이전트라는 점이 주목을 끌고 있다. 또한 Raspberry Pi, ESP32-S3, Tuya T5AI 등 다양한 보드에 대한 구성과 빌드 예제가 명시되어 있어 실험과 프로토타이핑 진입 장벽이 낮다. 활발한 개발 표시와 오픈소스 SDK 기반이라는 점이 기여도를 높였다.

차별점

• TuyaOpen C SDK 기반으로 설계되어 ARM Cortex-M, Cortex-A, x64 등에서 네이티브로 동작하며 MCU에서 Node나 Python 같은 런타임 의존이 없다. 이로 인해 자원 한정 환경에서 직접 하드웨어 드라이버와 메모리 관리 레이어를 활용할 수 있다. PSRAM 지원을 통해 대화 컨텍스트를 확장할 수 있도록 메모리 할당 경로를 분기했다.
• 디바이스-클라우드 통합을 단일 인증 키로 연결하여 로컬 행동과 클라우드 모델을 하나의 제어권 하에 둔다. 이 접근은 로컬에서 즉시 실행 가능한 하드웨어 도구와 클라우드 기반 대형 모델을 역할 분담 방식으로 결합한다. 결과적으로 로컬 제어 비중을 유지하면서도 최신 모델 기능을 원활히 활용할 수 있다.
• 스킬을 마크다운 파일로 관리하고 에이전트가 요약을 매 턴 읽어 필요 시 전체 파일을 로드하는 경량 확장 모델을 채택했다. 스킬은 파일 쓰기 도구로 런타임에 추가되거나 수정될 수 있어 개발자와 메이커가 장치에서 직접 기능을 확장할 수 있다. Lua 5.5 샌드박스는 안전한 기기 제어 스크립트를 허용한다.

사용 사례

• 음성 입력과 로컬 하드웨어 제어가 필요한 홈 오토메이션 장치에서 사용된다. T5AI 보드의 마이크와 스피커를 통해 ASR 입력을 받으면 에이전트가 로컬 HW 도구로 조명이나 스위치를 제어하며 세션 메모리에 상태를 남긴다. 이 과정은 네트워크가 불안정한 환경에서도 로컬에서 즉시 행동을 수행할 수 있게 한다.
• 원격 관리가 필요한 현장 장비에서 디버깅 또는 명령 실행 용도로 활용된다. Raspberry Pi나 ARM Linux 장비에서 EXEC 도구로 원격 쉘을 스폰해 로그를 수집하거나 유지보수 스크립트를 실행할 수 있다. JSONL 기반 세션 복원으로 중단된 작업을 재개하기 쉬운 상태를 유지한다.
• 메이커와 개발자가 하드웨어 스킬을 손쉽게 추가하는 프로토타이핑 환경으로 활용된다. skills 디렉토리에 마크다운 파일을 넣거나 채팅으로 스킬을 작성하면 에이전트가 해당 스킬을 요약해 사용 가능 상태로 만든다. Lua 스크립트를 통한 안전한 하드웨어 제어로 반복 실험을 빠르게 진행할 수 있다.

시작하기

레포 복제와 서브모듈 초기화가 첫 단계이며 include/tuya_app_config_secrets.h 파일을 복사해 Tuya 제품 ID와 OpenSDK 인증키, IM 채널 토큰을 채워야 한다. 보드에 맞는 config 파일을 app_default.config로 복사해 활성화하고 TuyaOpen 환경을 초기화하는 export.sh를 실행한 뒤 tos.py build로 대상 이미지를 빌드하면 배포용 바이너리가 dist 디렉토리에 생성된다. 개발 가이드는 보드별 퀵스타트 페이지로 연결되어 있어 T5AI, Raspberry Pi, ESP32-S3 각각의 설정 절차와 예제를 확인할 수 있다.

요구사항

• TuyaOpen API 접근을 위한 TUYA_PRODUCT_ID, TUYA_OPENSDK_UUID, TUYA_OPENSDK_AUTHKEY 같은 클라우드 자격증명이 필요하다. IM 채널 토큰과 CLAW_WS_AUTH_TOKEN, OPENCLAW_GATEWAY_* 같은 게이트웨이 관련 설정도 프로젝트 실행을 위해 준비해야 한다. 시크릿 파일은 include/tuya_app_config_secrets.h에 넣도록 예시가 제공된다.
• 타깃 보드별 툴체인과 환경 구성이 필요하며 레포의 export.sh가 가상환경과 교차 컴파일 툴체인을 준비한다. 지원 대상에는 Tuya T5AI 모듈, ESP32-S3, Raspberry Pi 4/5/CM 등이 포함되어 있고 Linux x64 빌드도 지원된다. 빌드 중 플랫폼 업데이트 프롬프트를 건너뛰는 캐시 파일 생성 지침이 README에 있다.

이미지 분석