PicoClaw 설정
PicoClaw 는 Sipeed가 오픈소스로 제공하는 초경량 AI 어시스턴트입니다. Go로 작성되었으며 단일 바이너리, 10MB 미만의 메모리 사용량, 1초 미만의 시작 시간으로 라즈베리 파이, Linux, RISC-V 등 다양한 기기에 배포할 수 있습니다. 또한 Telegram, Discord, Feishu, WeChat 등 여러 메시징 플랫폼을 지원합니다.
OfoxAI를 연동하면 PicoClaw에서 GPT, Claude, Gemini, DeepSeek 등 100개 이상의 모델을 하나의 API Key로 사용할 수 있습니다.
사전 요구 사항
picoclaw-launcher를 실행한 후 브라우저에서 http://localhost:18800을 열면 WebUI 관리 화면에 접속할 수 있습니다.
설정 단계
1단계: 모델 설정 페이지 열기
WebUI 좌측 탐색에서 모델 → 모델을 클릭하여 모델 관리 페이지를 엽니다. 모델은 공급자（OpenAI, Anthropic, Google Gemini, DeepSeek 등）별로 그룹화되어 표시됩니다. 모델 카드 우측 상단의 편집 아이콘을 클릭하여 설정합니다.
2단계: 모델 설정
표시된 설정 패널에 다음 정보를 입력합니다:
| 항목 | 값 |
|---|---|
| Provider | OpenAI |
| 모델 식별자 | 사용할 모델 ID（예: openai/모델명, 모델 갤러리 참조） |
| API Key | OfoxAI API Key |
| API Base URL | https://api.ofox.ai/v1 |
PicoClaw는 OpenAI 호환 프로토콜로 OfoxAI에 연결되어 GPT, Claude, Gemini, DeepSeek 등 모든 모델에 접근할 수 있습니다. 모델 식별자에 해당 모델 ID（모델 갤러리 참조）를 openai/모델명 형식으로 입력하세요.
입력을 완료한 후 저장을 클릭합니다. 이 모델을 기본값으로 설정하려면 기본 모델 스위치를 켜거나 모델 목록에서 ☆ 아이콘을 클릭하세요.
3단계: 설정 적용 확인
저장 후 모델 카드 좌측의 상태 점이 녹색으로 바뀌고 모델 식별자와 마스킹된 API Key가 표시되면 설정이 완료된 것입니다.
4단계: 서비스 시작 및 대화
우측 상단의 서비스 시작을 클릭합니다. 서비스가 실행되면 대화 페이지로 돌아가 상단 모델 선택기에서 방금 설정한 모델을 선택하고 메시지를 보내 대화를 시작합니다.
추천 모델
추천 모델은 모델 갤러리 를 참고하세요.
자주 묻는 질문
Q: WebUI 페이지에 Failed to execute 'removeChild' 오류가 표시됩니다
브라우저 번역 확장 프로그램과 페이지의 충돌 때문입니다. 해당 페이지의 자동 번역을 끄거나 시크릿 창에서 http://localhost:18800을 여세요.
Q: Claude나 Gemini 모델을 사용할 수 있나요?
네. PicoClaw는 OfoxAI의 OpenAI 호환 엔드포인트를 통해 모든 모델에 접근할 수 있습니다. 모델 식별자에 해당 ID를 입력하세요（모델 갤러리 참조）.
Q: 연결 테스트 또는 대화가 실패합니다
- API Base URL이
https://api.ofox.ai/v1로 입력되었는지 확인 - API Key가 OfoxAI 콘솔 에서 공백 없이 올바르게 복사되었는지 확인
- 우측 상단의 서비스 시작을 클릭했는지 확인