PicoClaw 요금 및 API 설정: 모델, 프로토콜 및 키

PicoClaw 소프트웨어는 무료입니다. 저장소는 MIT 라이선스이며 picoclaw.io의 자체 FAQ에도 "소프트웨어는 무료입니다. LLM API 사용량에 대해서만 비용을 지불합니다"라고 되어 있습니다. 따라서 "PicoClaw 가격"은 모델 API 청구액과 장치 비용(해당하는 경우)을 의미합니다. Sipeed는 PicoClaw 구독이나 호스팅 등급을 광고하지 않습니다. 예산을 책정할 때 중요한 수치는 에이전트 턴당 토큰 수이며, 가장 놀라울 수 있는 설정은 PicoClaw의 도구 반복 상한입니다. 필드가 없을 때는 50이고, 제공된 예제 구성에서는 20입니다.

먼저 결과 페이지에 두 항목이 섞여 있으므로 구분해야 합니다. 공식 도메인은 picoclaw.io이며, 이는 github.com/sipeed/picoclaw의 homepage 필드에 기재되어 있습니다. 유사 도메인인 pico-claw.com은 자체 푸터에서 "Sipeed 또는 PicoClaw와 공식적으로 제휴하지 않았다"고 명시합니다. 해당 사이트의 월간 패키지 가격은 그 사이트 자체의 관리형 호스팅 모듈에 대한 것이며 PicoClaw의 가격이 아닙니다. 두 번째 유사 도메인인 picoclaw.net도 공식 도메인이 아닙니다. 이 사이트는 "AI 생성 코드 95%"와 x86_64, ARM64, RISC-V라는 "지원 아키텍처 3개"를 내세우지만, picoclaw.io의 FAQ에는 6개가 나열되어 있습니다. 또한 PicoClaw는 OpenClaw의 포크가 아닙니다. 자체 벤치마크에서 OpenClaw 및 NanoBot과 비교하는 독립적인 Go 구현입니다.

PicoClaw 가격, 항목별

모두 2026년 9월 21일에 확인했습니다. 참고로 버전은 2026년 7월 3일에 게시된 최신 태그 릴리스 v0.3.1이며, 저장소에는 2026년 9월 17일에 마지막으로 푸시되었습니다. 따라서 main의 코드는 태그보다 앞서 있고, README 자체의 뉴스 목록은 더 오래되어 최신 릴리스 항목도 2026년 5월 28일의 v0.2.9입니다. 아래의 모든 동작은 다운로드할 v0.3.1 바이너리가 아니라 main에서 확인했습니다. 태그된 릴리스를 사용하는 독자는 다른 결과를 볼 수 있습니다. 확인일의 실시간 상태로는 picoclaw.io의 TLS 인증서가 만료되어 있었습니다(유효 기간: 2026년 2월 25일~9월 10일). 따라서 공식 다운로드 페이지를 브라우저에서 열면 보안 경고가 표시됩니다. 이는 언제든 수정될 수 있으며 프로젝트에 대해 아무것도 의미하지 않습니다. GitHub Releases에는 영향이 없습니다.

PicoClaw API 키 설정: model_list 및 .security.yml

picoclaw onboard는 ~/.picoclaw/config.json 및 작업 공간을 생성합니다. 모델은 model_list 배열에서 선언하고 agents.defaults.model_name에서 이름으로 선택합니다. 두 값은 일치해야 하며, 이것이 PicoClaw 문제 해결 문서에서 다루는 유일한 사례입니다.

{
  "agents": {
    "defaults": {
      "model_name": "gateway-sonnet"
    }
  },
  "model_list": [
    {
      "model_name": "gateway-sonnet",
      "provider": "openai",
      "model": "claude-sonnet-4-6",
      "api_base": "https://api.kunavo.com/v1",
      "enabled": true
    }
  ]
}

키는 두 번째 파일에 저장됩니다. PicoClaw 보안 문서에서는 config.json를 "기본 구성(공유해도 안전함)", .security.yml을 "보안 데이터(절대 공유하지 말 것)"이라고 부르며 chmod 600하라고 안내합니다. YAML 구조는 model_name를 키로 사용하는 맵이며, config.json에서 사용하는 배열이 아닙니다. 또한 api_keys는 복수형이며 키가 하나뿐이어도 배열입니다.

# The map key must equal the model_name in config.json.
# api_keys is plural and is an array even for one key.
model_list:
  gateway-sonnet:
    api_keys:
      - "sk-kn-..."

사람들이 자주 놓치는 세부 사항은 네 가지입니다. provider는 선택 사항입니다. 이를 설정하면 model이 변경 없이 업스트림으로 전송됩니다. 생략하면 PicoClaw는 model의 첫 번째 / 앞에 있는 모든 내용을 공급자로 읽으며, 이는 레거시 protocol/model 형식입니다. 구성은 스키마 버전이 관리되며 현재 버전은 3입니다. 마이그레이션 시 날짜가 포함된 백업이 작성되고, 문서에서는 V3 파일을 이전 V2 전용 빌드에서 안전하게 로드할 수 없다고 경고합니다. V1에서 V2로 마이그레이션하는 동안 enabled가 자동 추론됩니다. API 키가 없고 local-model로 이름이 지정되지 않은 항목은 disabled로 기본 설정됩니다. 따라서 위 예제에서는 키를 .security.yml로 옮긴 뒤 enabled를 명시적으로 설정합니다. 스트리밍은 기본적으로 꺼져 있으며 두 번의 조건이 모두 필요합니다. 모델 항목의 streaming.enabled과 채널의 settings.streaming.enabled이 모두 true여야 합니다.

항목을 작성하기 전에 한 가지 경계를 밝혀 두겠습니다. PicoClaw의 공급자 표에는 Groq가 "LLM + 음성 전사(Whisper)"로 나열되어 있지만, Kunavo는 음성-텍스트 변환, 텍스트-음성 변환 또는 임베딩을 제공하지 않습니다. 따라서 전사 또는 임베딩 항목은 다른 공급자를 가리켜야 하며 Kunavo 키의 후보는 채팅 항목뿐입니다.

프로토콜 이름이 뒤바뀌어 있으며, 이것이 전체 함정입니다

PicoClaw에서 anthropic는 OpenAI 와이어 형식을 사용하는 Claude 형태의 모델을 의미하고, anthropic-messages는 Anthropic의 네이티브 Messages API를 의미합니다. 문서에는 다음과 같이 명시되어 있습니다. "anthropic 프로토콜은 OpenAI 호환 형식(/v1/chat/completions)을 사용하고, anthropic-messages는 Anthropic의 네이티브 형식(/v1/messages)을 사용합니다." 소스도 이를 뒷받침합니다. factory_provider.go는 anthropic용 공유 OpenAI 호환 HTTP 공급자를 빌드하고, anthropic-messages용으로 별도의 네이티브 공급자를 빌드합니다. 그러나 PicoClaw 자체의 "지원되는 모든 공급자" 표는 anthropic 행의 프로토콜 열을 "Anthropic"으로 표시하여 둘 다와 모순됩니다. 해당 표만 읽는 독자는 잘못된 항목을 구성하게 됩니다.

2026년 9월 21일 main의 openai_compat/provider.go, common/anthropic_common.go, anthropic_messages/provider.go 및 factory_provider.go에서 읽었습니다. 와이어에서 관찰한 것이 아니라 코드에서 도출한 내용입니다. 구체적으로 말하면 anthropic 또는 anthropic-messages를 경로가 /v1로 끝나서는 안 되는 게이트웨이에 지정할 수 없습니다. PicoClaw가 이를 무조건 추가하기 때문입니다. https://gw.example.com/anthropic의 게이트웨이는 https://gw.example.com/anthropic/v1/messages가 됩니다. 이러한 엔드포인트에는 경로를 그대로 존중하는 openai 프로토콜만 URL을 표현할 수 있습니다. 감사한 프로토콜은 이 세 가지뿐이므로 gemini, azure 또는 나머지에 이 규칙을 일반화하지 마세요.

네이티브 경로에는 두 가지 제약이 더 있으며, 둘 다 같은 파일의 소스에서 확인했습니다. anthropic-messages는 API 키를 요구하며, 키가 없으면 오류를 발생시켜 실행을 중단합니다. 따라서 factory_provider.go가 CLI 브리지 및 antigravity와 함께 anthropic 및 openai에 연결하는 OAuth 분기에는 이 경로를 통해 도달할 수 없습니다. 또한 factory_provider.go의 다섯 분기는 cfg.CustomHeaders를 전달하지만, anthropic-messages 분기는 여기에 포함되지 않습니다. 이 분기의 생성자는 키, 기본 URL, 사용자 에이전트, 타임아웃만 받습니다. 따라서 비표준 인증을 사용하는 게이트웨이를 위해 문서에 안내된 custom_headers 우회 수단은 OpenAI 호환 프로토콜에는 적용되지만, 네이티브 Messages 프로토콜에는 적용되지 않는 것으로 보입니다. 이는 소스를 읽고 내린 판단이며, 런타임 테스트 결과는 아닙니다. 네이티브 경로를 사용한다고 해서 도구 호출 기능을 잃는 것은 아닙니다. 이 경로는 input_schema를 사용해 네이티브 tools를 구성하고, tool_use 및 tool_result 블록을 처리합니다.

Kunavo에서 문서화된 두 기본 URL은 채팅 완성용 https://api.kunavo.com/v1와 Messages 경로용 https://api.kunavo.com/v1/messages이며, Kunavo의 Messages 핸들러는 x-api-key와 Authorization: Bearer 모두에서 키를 읽습니다. 문서상으로는 양쪽 방향에서 PicoClaw의 URL 연산을 충족합니다. 이는 두 문서 집합을 바탕으로 한 연산일 뿐이며, 여기서는 Kunavo에 PicoClaw 요청을 보내지 않았고 이 페이지도 PicoClaw 프로토콜이 Kunavo에서 테스트되었다고 주장하지 않습니다. 정확한 형식은 Anthropic 기본 URL 문서 및 채팅 엔드포인트 문서를 확인한 다음, 직접 제한된 요청을 하나 보내 보세요.

PicoClaw API 비용 계산 예시

이는 측정된 작업 비용이나 청구 상한이 아니라 토큰 산술 예시입니다. 한 에이전트 턴이 도구 라운드 8회에서 완료되고, 각 라운드가 평균 입력 토큰 12,000개가 포함된 대화 기록을 다시 보내며 출력 토큰 700개를 반환한다고 가정합니다. 이 비율은 예시를 위한 가정입니다. 두 번째 열은 pkg/config/defaults.go에서 필드가 없을 때 적용되는 컴파일된 max_tool_iterations 기본값 50까지 동일한 형태를 계산합니다. 제공된 config/config.example.json에서는 20을 기록하므로 50을 상한으로 간주하기 전에 자신의 파일을 확인하세요. 요율은 백만 토큰당 Kunavo 카탈로그의 현재 가격입니다.

두 열을 하나의 사실로 읽으세요. 8라운드에서 50라운드 상한으로 늘리면 모든 행이 동일한 6.25배가 됩니다. 반복 길이는 요율과 독립적이기 때문입니다. 8라운드에서 한 Claude Sonnet 4.6 턴은 $0.260이고 상한에서는 $1.627이며, 같은 상한에서 Claude Haiku 4.5는 $0.542입니다. 따라서 더 저렴한 요율을 찾기 전에 실제로 관찰한 수치로 max_tool_iterations를 제한하세요. 이는 agents.defaults 아래에 있으며 PICOCLAW_AGENTS_DEFAULTS_MAX_TOOL_ITERATIONS 환경 변수로 재정의할 수 있습니다. 그런 다음 하루 턴 수를 곱하세요.

Kunavo의 카탈로그 금액은 상한이 아니라 최소 청구 기준입니다. 업스트림이 청구 금액을 보고하면, 카탈로그 비용과 업스트림 비용에 해당 마크업을 곱한 금액 중 더 큰 금액이 청구됩니다. 캐시 읽기와 쓰기는 각각의 요율로 청구되며 여기서는 어느 쪽도 모델링하지 않았고, 외부 도구 호출도 이 예시에 포함되지 않습니다. 최소 충전 금액은 선불 크레딧 $10이며, 이는 작업 수수료나 구독이 아니라 자금 충전의 최소 금액입니다. 측정 방법은 청구 세부 정보와 AI 비용 최적화를 참조하세요.

PicoClaw에 가장 적합한 API: 어떤 경우에 어떤 경로가 우세한가

여기서는 공급자 수를 비교 기준으로 사용하지 않습니다. PicoClaw 자체 파일 세트가 어떤 공급자가 존재하는지에 대해 서로 일치하지 않으므로 README의 "30개 이상의 LLM 공급자"라는 표현을 그대로 반복하는 것이 가장 안전합니다. 다른 단일 바이너리 에이전트 사이에서 PicoClaw의 위치를 확인하려면 AI 에이전트 API 디렉터리에서 해당 에이전트의 구성 표면을 나란히 확인할 수 있고, OpenRouter 대안에서는 통합 깊이가 아니라 자금 조건을 기준으로 게이트웨이 경로를 비교합니다.

첫 요청, 첫 도구 라운드, 그리고 404

제한된 작업 하나를 실행하고 다음 세 가지를 순서대로 읽으세요. model_list에 모델이 없음 오류는 문서화된 사례이며 이름 불일치입니다. agents.defaults.model_name는 model_name 항목과 같아야 합니다. provider가 설정되지 않은 접두사 없는 ID는 의도한 공급자를 선택하지 않으며, openai 프로토콜로 폴백됩니다. 이는 OpenRouter가 리터럴 ID free를 받아 거부하는 문서화된 "model": "free" 사례입니다. 첫 요청에서 404가 발생하면 잘못된 Anthropic 프로토콜을 선택했다는 문서화된 신호입니다. PicoClaw 자체 안내에서는 "기존 anthropic 프로토콜이 404 오류를 반환하는 경우(OpenAI 호환 형식을 엔드포인트가 지원하지 않음을 의미)" anthropic-messages로 이동하라고 합니다. 다른 것을 변경하기 전에 위 표와 조합된 URL을 확인하세요. 이에 대한 공식 문제 해결 항목은 없으므로 해당 진단은 지원 페이지가 아니라 공급자 참고 사항과 소스에서 도출한 것입니다. 셋째, 일반 채팅은 작동했지만 첫 도구 라운드가 실패하면 인증보다 스키마 엄격성을 의심하세요. PicoClaw는 기본적으로 도구 스키마를 변경 없이 전달하며, tool_schema_transform: "simple"는 $ref, $defs, anyOf, oneOf, allOf 또는 pattern를 거부하는 엔드포인트를 위한 모델별 비활성화 옵션입니다.

Kunavo는 PicoClaw 설정 페이지를 게시하지 않았고 PicoClaw 호환성 테스트도 수행하지 않았습니다. 시험하는 동안 작동하는 경로를 유지한 다음, 이 페이지의 추정치가 아니라 해당 작업에 대해 계정에 실제로 기록된 요금을 확인하세요. 키에 자금을 충전할 준비가 되면 Kunavo 계정 만들기를 선택하고, Claude가 사용하려는 계열이라면 가장 저렴한 Claude API에서 모델 요금을 비교하세요.

자주 묻는 질문

2026년 9월 21일에 확인했습니다. GitHub 저장소 및 릴리스 API, picoclaw.io(인증서가 만료되어 인증서 검증을 비활성화한 상태로 읽음), README, docs/guides/providers.md, docs/security/security_configuration.md, docs/reference/config-versioning.md, docs/guides/configuration.md, docs/operations/troubleshooting.md, config/config.example.json, 그리고 main 브랜치의 소스 파일 7개 — factory_provider.go, openai_compat/provider.go, common/anthropic_common.go, anthropic_messages/provider.go, provider_metadata.go, pkg/config/defaults.go 및 pkg/config/config.go —와 두 유사 도메인을 확인했습니다. 확인하지 않은 항목은 PicoClaw 자체 비교 표의 제3자 할당량, 소매 하드웨어 가격 및 v0.3.1 릴리스 노트입니다. 아무것도 설치하거나 실행하지 않았으며 어떤 엔드포인트에도 PicoClaw 요청을 보내지 않았습니다. Kunavo 토큰 요율은 현재 카탈로그에서 가져왔고, 모든 달러 예시는 측정된 작업 비용이 아니라 토큰 산술 예시입니다.