시스템 요구 사항
PicoClaw는 하드웨어 사양에 대한 제약이 매우 적습니다:
- 운영체제: Linux / macOS / Windows (WSL2)
- 아키텍처 지원: x86_64 / ARM64 / RISC-V
- 최소 메모리: 64MB (512MB 이상 권장)
- 필수 항목: LLM API Key (설정하지 않으면 AI 대화 기능을 사용할 수 없습니다)
지원 플랫폼: macOS, Linux, Windows (WSL2), 라즈베리 파이, Docker
1단계: 코드 저장소 복제
터미널을 열고 다음 명령어를 실행하세요:
git clone https://github.com/sipeed/picoclaw.git복제가 완료되면 프로젝트 디렉토리로 이동합니다:
cd picoclaw2단계: 초기 설정
onboard 명령어를 실행하여 초기화를 진행합니다:
picoclaw onboard안내에 따라 설정을 완료하세요:
- LLM API Key: 사용하는 LLM 서비스 제공업체의 API Key를 입력합니다.
- 모델 환경 설정: 기본으로 사용할 AI 모델을 선택합니다.
- 메시징 플랫폼 토큰 (선택 사항): Telegram, Discord, QQ 또는 DingTalk 연동이 필요한 경우, 각 플랫폼의 봇 토큰을 입력합니다.
설정 파일은 로컬에 저장되며, 모든 데이터는 사용자 기기에 보관되므로 클라우드로 전송되지 않습니다.
3단계: 대화 시작
설정이 완료되면 AI와 대화를 시작할 수 있습니다.
대화형 모드
picoclaw agent대화형 인터페이스를 실행하여 연속적인 메시지 전송 및 응답을 받을 수 있습니다.
단일 질의 모드
picoclaw agent -m "안녕하세요, 자기소개 부탁드립니다"단일 메시지를 보내고 응답을 받은 뒤 종료되므로 스크립트에서 사용하기 적합합니다.
게이트웨이 서비스 실행
Telegram, QQ 등 메시징 플랫폼에서 사용하려면 다음을 실행하세요:
picoclaw gateway실행 후 각 플랫폼의 봇을 통해 PicoClaw와 상호작용할 수 있습니다.
멀티 플랫폼 봇 설정
Telegram 봇
Telegram에서 @BotFather를 찾아 /newbot을 전송하여 봇을 생성하고 토큰을 받으세요. 설정 파일에 토큰을 입력한 뒤 picoclaw gateway를 실행합니다.
Discord 봇
Discord 개발자 포털에서 애플리케이션을 생성하고, 봇 설정에서 토큰을 가져옵니다. 봇을 서버에 초대하고 설정 파일에 토큰을 입력하세요.
QQ 봇
QQ 오픈 플랫폼 문서를 참조하여 봇을 등록하고 AppID와 토큰을 발급받아 설정 파일에 입력하세요.
DingTalk 봇
DingTalk 오픈 플랫폼에서 로봇 애플리케이션을 생성하고 Webhook URL과 키를 발급받아 설정 파일에 입력하세요.
Docker 배포
PicoClaw는 Docker 배포를 지원하며, 서버나 데스크탑 환경이 없는 경우에 적합합니다:
docker pull ghcr.io/sipeed/picoclaw:latestdocker run -d --name picoclaw -v /path/to/config:/config -e PICOCLAW_API_KEY=your_key ghcr.io/sipeed/picoclaw:latest예약 작업 설정
PicoClaw는 cron을 내장하고 있으며, 설정 파일을 통해 관리할 수 있습니다.
일회성 알림
tasks: - type: reminder time: "1h" message: "회의 알림: 팀 주간 회의"주기적 작업
tasks: - type: cron schedule: "0 8 * * *" message: "오늘의 업무 요약 생성"자주 묻는 질문
PicoClaw는 인터넷 연결이 필요한가요?
PicoClaw 자체는 오프라인으로 실행 가능하지만, LLM API 호출 및 메시징 플랫폼 연동을 위해서는 인터넷 연결이 필요합니다.
어떤 LLM 서비스 제공업체를 지원하나요?
OpenRouter, Zhipu AI, Anthropic, OpenAI, DeepSeek, Groq 등을 지원하며, 설정 파일을 통해 자유롭게 전환할 수 있습니다.
PicoClaw는 어떻게 업데이트하나요?
프로젝트 디렉토리에서 git pull을 실행하여 최신 코드를 가져온 후 다시 컴파일하면 됩니다.
데이터는 어디에 저장되나요?
모든 대화 기록과 설정 데이터는 로컬 파일 시스템에 저장되며, 사용자가 완전히 제어할 수 있습니다.
Docker 이미지 용량은 얼마나 되나요?
PicoClaw의 Docker 이미지는 약 15MB로, 경쟁 제품의 350MB+보다 훨씬 가볍습니다.
라즈베리 파이에서 실행할 수 있나요?
네, PicoClaw는 ARM64 아키텍처를 지원하므로 라즈베리 파이 4(4GB 이상)에서 원활하게 실행됩니다.
여러 봇을 동시에 사용하려면 어떻게 설정하나요?
설정 파일에 각 플랫폼의 토큰과 설정 항목을 각각 추가하고 picoclaw gateway를 실행하면 모든 봇이 동시에 활성화됩니다.