티스토리 뷰

728x90

 

1. 프로젝트 공식 링크

zclaw는 아래의 깃허브(GitHub) 페이지에서 관리됩니다.

 

GitHub - tnm/zclaw: Your personal AI assistant at all-in 888KiB (~25KB in app code). Running on an ESP32. GPIO, cron, custom too

Your personal AI assistant at all-in 888KiB (~25KB in app code). Running on an ESP32. GPIO, cron, custom tools, memory, and more. - tnm/zclaw

github.com

 

이곳에서 소스 코드를 확인하고, 이슈(질문/오류)를 제보하거나 업데이트 사항을 볼 수 있습니다.


2. 설치 및 빌드 방법 (C6 보드 타겟)

보유하신 ESP32-C6 보드를 기준으로, 가장 표준적인 설치 흐름입니다.

1단계: 환경 준비

컴퓨터에 ESP-IDF 환경이 구축되어 있어야 합니다. (VS Code에서 ESP-IDF Extension을 설치하면 가장 편리합니다.)

2단계: 코드 가져오기

터미널을 열고 다음 명령어를 입력합니다:

Bash

git clone https://github.com/tnm/zclaw.git

cd zclaw

 

3단계: 보드 설정 (Target 설정)

C6 모델을 사용한다고 환경에 알려주어야 합니다.

Bash

idf.py set-target esp32c6

 

4단계: 빌드 및 플래싱

다음 명령어를 순서대로 실행하여 코드를 보드에 올립니다:

Bash

# 코드 빌드 (컴파일)

idf.py build

 

# 보드에 업로드 (플래싱)

idf.py -p [컴포트번호] flash monitor

 

  • [컴포트번호]는 연결된 보드의 포트(예: COM3 또는 /dev/ttyUSB0)로 바꿔주세요.

3. 이해를 돕는 구조도

이 구조를 이해하시면 나중에 C6 보드에서 문제가 생겼을 때 어디가 잘못되었는지 찾기 훨씬 수월합니다.


⚠️ 주의사항 및 팁

  • 메모리 최적화: 앞서 말씀드렸듯, C6는 PSRAM이 없기 때문에 menuconfig에서 메모리 사용 옵션을 최소화해야 할 수 있습니다. 빌드 시 오류가 발생하면 idf.py menuconfig를 실행하여 불필요한 기능(예: Wi-Fi 고도화 설정 등)을 끄고 다시 시도해 보세요.
  • 로그 확인: idf.py monitor 명령어를 사용하면 보드가 어떤 오류를 내뱉는지 실시간으로 볼 수 있습니다. "Memory allocation failed" 같은 메시지가 뜬다면 메모리 부족이 원인이니, 더 가벼운 코드로 수정해야 합니다.

 

728x90
250x250
공지사항
최근에 올라온 글
최근에 달린 댓글
Total
Today
Yesterday
링크
«   2026/03   »
1 2 3 4 5 6 7
8 9 10 11 12 13 14
15 16 17 18 19 20 21
22 23 24 25 26 27 28
29 30 31
글 보관함