Preços e configuração da API do PicoClaw: modelos, protocolos e chaves

O software PicoClaw é gratuito: o repositório usa licença MIT e a própria FAQ de picoclaw.io afirma "O software é gratuito. Você paga apenas pelo uso da API de LLM" — portanto, "preço do PicoClaw" significa a fatura da API do seu modelo, mais o custo do dispositivo, se houver. A Sipeed não anuncia assinatura nem nível hospedado do PicoClaw. O número que vale a pena incluir no orçamento é o de tokens por turno do agente, e a configuração mais propensa a surpreender é o limite de iterações de ferramentas do PicoClaw: 50 quando o campo está ausente, 20 no arquivo de configuração de exemplo fornecido.

Primeiro, duas desambiguações, porque a página de resultados mistura as duas coisas. O domínio oficial é picoclaw.io — ele é o campo homepage de github.com/sipeed/picoclaw. O sósia pico-claw.com declara no próprio rodapé que "não tem afiliação oficial com a Sipeed ou o PicoClaw", e o preço do pacote mensal nele pertence ao módulo de hospedagem gerenciada do próprio site, não ao PicoClaw. Um segundo sósia, picoclaw.net, também não é o domínio oficial. Ele destaca "95% de código gerado por IA" e "3 arquiteturas compatíveis" — x86_64, ARM64 e RISC-V — enquanto a FAQ de picoclaw.io lista seis. E o PicoClaw não é um fork do OpenClaw; é uma implementação independente em Go que compara seu desempenho com OpenClaw e NanoBot.

Preço do PicoClaw, item por item

Tudo verificado em 21 de setembro de 2026. Versão, para registro: a versão marcada mais recente é v0.3.1, publicada em 3 de julho de 2026, enquanto o repositório recebeu seu último push em 17 de setembro de 2026 — portanto, o código em main está à frente da tag, e a própria lista de novidades do README está ainda mais desatualizada, com v0.2.9 de 28 de maio de 2026 como entrada de lançamento mais recente. Todo comportamento abaixo foi lido em main, não no binário v0.3.1 que você baixaria; um leitor da versão marcada pode observar algo diferente. Uma condição vigente na data da verificação: o certificado TLS de picoclaw.io havia expirado (válido de 25 de fevereiro a 10 de setembro de 2026), portanto um navegador exibe um aviso de segurança na página oficial de download. Isso pode ser corrigido a qualquer momento e não diz nada sobre o projeto; os Releases do GitHub não são afetados.

Configuração da chave de API do PicoClaw: model_list e .security.yml

picoclaw onboard cria ~/.picoclaw/config.json e o workspace. Os modelos são declarados em um array model_list e selecionados por nome em agents.defaults.model_name; os dois devem corresponder, que é o único caso coberto pelo documento de solução de problemas do 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
    }
  ]
}

As chaves ficam em um segundo arquivo. A documentação de segurança do PicoClaw chama config.json de "Configuração principal (segura para compartilhar)" e .security.yml de "Dados de segurança (nunca compartilhar)", e orienta chmod 600-lo. A estrutura YAML é um mapa indexado por model_name, não o array usado em config.json, e api_keys é plural e um array mesmo para uma única chave.

# 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-..."

Quatro detalhes que pegam as pessoas. provider é opcional: defina-o e model será enviado ao upstream sem alterações; omita-o e o PicoClaw lerá tudo antes do primeiro / em model como o provedor, que é o formato legado protocol/model. A configuração é versionada por esquema e a versão 3 é a atual; a migração grava um backup datado, e a documentação alerta que um arquivo V3 não pode ser carregado com segurança por builds antigos que aceitam apenas V2. Durante a migração de V1 para V2, enabled é inferido automaticamente — entradas sem chave de API e que não se chamam local-model assumem disabled —, razão pela qual o exemplo acima define enabled explicitamente depois que as chaves são movidas para .security.yml. O streaming fica desativado por padrão e é controlado duas vezes: streaming.enabled da entrada do modelo e settings.streaming.enabled do canal devem ser ambos true.

Um limite que vale declarar antes de escrever as entradas: a tabela de fornecedores do PicoClaw lista Groq como "LLM + transcrição de voz (Whisper)", e o Kunavo não oferece conversão de fala em texto, conversão de texto em fala nem embeddings — uma entrada de transcrição ou embedding precisa apontar para outro provedor, e somente as entradas de chat são candidatas a uma chave do Kunavo.

Os nomes dos protocolos estão invertidos, e essa é toda a armadilha

No PicoClaw, anthropic significa modelos no formato Claude usando o formato de transmissão da OpenAI, e anthropic-messages significa a API Messages nativa da Anthropic. A documentação afirma isso claramente: "O protocolo anthropic usa o formato compatível com OpenAI (/v1/chat/completions), enquanto anthropic-messages usa o formato nativo da Anthropic (/v1/messages)." O código confirma — factory_provider.go cria o provedor HTTP compartilhado compatível com OpenAI para anthropic e um provedor nativo separado para anthropic-messages. A própria tabela "Todos os fornecedores compatíveis" do PicoClaw contradiz ambos ao rotular a coluna de protocolo da linha anthropic como "Anthropic"; quem lê apenas essa tabela configura o protocolo errado.

Lido de openai_compat/provider.go, common/anthropic_common.go, anthropic_messages/provider.go e factory_provider.go em main, em 21 de setembro de 2026 — derivado do código, não observado na transmissão. A consequência é concreta: você não pode apontar anthropic ou anthropic-messages para um gateway cujo caminho não pode terminar em /v1, porque o PicoClaw o acrescenta independentemente. Um gateway em https://gw.example.com/anthropic torna-se https://gw.example.com/anthropic/v1/messages. Para esse tipo de endpoint, o protocolo openai, que respeita o caminho literalmente, é o único capaz de expressar a URL. Apenas estes três protocolos foram auditados; não generalize a regra para gemini, azure ou os demais.

Mais dois limites do caminho nativo, ambos lidos no mesmo arquivo. anthropic-messages exige uma chave de API e gera erro fatal sem ela, portanto o branch OAuth — que factory_provider.go conecta a anthropic e openai, juntamente com os bridges da CLI e antigravity — não pode ser alcançado por ele. E, embora cinco branches em factory_provider.go encaminhem cfg.CustomHeaders, o branch anthropic-messages não é um deles: seu construtor recebe apenas a chave, a URL base, o user agent e o timeout. Assim, o mecanismo de escape documentado custom_headers para um gateway com autenticação fora do padrão parece alcançar os protocolos compatíveis com OpenAI, mas não o Messages nativo. Isso é uma leitura do código-fonte, não um teste de runtime. O que o caminho nativo não elimina é o uso de ferramentas: ele cria tools nativo com input_schema e processa blocos tool_use e tool_result.

Para o Kunavo, as duas URLs base documentadas são https://api.kunavo.com/v1 para chat completions e https://api.kunavo.com/v1/messages para a rota Messages, e o handler Messages do Kunavo também lê a chave de x-api-key e de Authorization: Bearer. No papel, elas correspondem à aritmética de URLs do PicoClaw em ambas as direções. Isso é aritmética sobre dois conjuntos de documentação — nenhuma solicitação do PicoClaw foi feita ao Kunavo aqui, e esta página não afirma que algum protocolo do PicoClaw tenha sido testado contra ele. Consulte a documentação da URL base da Anthropic e a documentação do endpoint de chat para ver os formatos exatos e, depois, envie você mesmo uma solicitação limitada.

Uma estimativa detalhada do custo de API do PicoClaw

Estes são cálculos ilustrativos de tokens, não custos medidos de tarefas nem um limite máximo da fatura. Suponha um turno do agente que se resolve em 8 rodadas de ferramentas, no qual cada rodada reenvia uma transcrição com média de 12.000 tokens de entrada e retorna 700 tokens de saída. Essas proporções são suposições para fins de ilustração. A segunda coluna repete o mesmo formato até o padrão compilado de max_tool_iterations de 50 em pkg/config/defaults.go, aplicado quando o campo está ausente — o config/config.example.json fornecido escreve 20; portanto, leia o seu próprio arquivo antes de tratar 50 como o seu limite. As tarifas são preços vigentes do catálogo do Kunavo por milhão de tokens.

Leia as duas colunas como um único fato. Passar de 8 rodadas ao limite de 50 multiplica cada linha pelo mesmo fator de 6.25x, porque o comprimento do loop é independente da tarifa: um turno de Claude Sonnet 4.6 custa US$ 0.260 com 8 rodadas e US$ 1.627 no limite, enquanto Claude Haiku 4.5 nesse mesmo limite custa US$ 0.542. Portanto, limite max_tool_iterations a um número que você já tenha observado antes de procurar uma tarifa mais barata — ele fica em agents.defaults e pode ser substituído pela variável de ambiente PICOCLAW_AGENTS_DEFAULTS_MAX_TOOL_ITERATIONS. Depois, multiplique pelo número de turnos por dia.

O valor do catálogo do Kunavo é um piso de cobrança, não um teto: quando o upstream informa seu custo, a cobrança é o maior valor entre o custo do catálogo e o custo do upstream multiplicado pelo markup aplicável. Leituras e gravações de cache são cobradas com suas próprias tarifas e não são modeladas aqui em nenhuma direção, e chamadas a ferramentas externas também ficam fora do exemplo. A recarga mínima é de US$ 10 em crédito pré-pago, um mínimo de financiamento, não uma taxa por tarefa nem uma assinatura — consulte detalhes de cobrança e otimização de custos de IA para conhecer o método de medição.

Melhor API para o PicoClaw: qual rota vence quando

A contagem de provedores não é um eixo de comparação aqui: o próprio conjunto de arquivos do PicoClaw discorda sobre quais provedores existem, portanto a formulação do README, "mais de 30 provedores de LLM", é a mais segura para repetir. Para saber onde o PicoClaw se posiciona entre os outros agentes de binário único, o diretório de APIs de agentes de IA lista sua superfície de configuração ao lado das demais, e alternativas ao OpenRouter compara rotas de gateway com base nos termos de financiamento, não na profundidade da integração.

Primeira solicitação, primeira rodada de ferramentas e um 404

Execute uma tarefa limitada e leia três coisas na ordem. Um erro model not found in model_list é o caso documentado e resulta de uma incompatibilidade de nomenclatura: agents.defaults.model_name deve ser igual a uma entrada model_name, e um id sem prefixo e sem um conjunto provider não seleciona o fornecedor pretendido — ele recorre ao protocolo openai, que é o caso documentado em "model": "free" em que o OpenRouter recebe o id literal free e o rejeita. Um 404 na primeira solicitação é o sinal documentado de que você escolheu o protocolo Anthropic errado — a própria orientação do PicoClaw diz para mudar para anthropic-messages quando "o protocolo anthropic existente retorna erros 404 (indicando que o endpoint não é compatível com o formato compatível com OpenAI)". Verifique a URL montada em relação à tabela acima antes de alterar qualquer outra coisa; não há uma entrada oficial de solução de problemas para isso, portanto esse diagnóstico vem da nota sobre os fornecedores e do código-fonte, não de uma página de suporte. Terceiro, se a primeira rodada de ferramenta falhar enquanto o chat simples funcionou, suspeite de rigidez do esquema, não de autenticação: o PicoClaw encaminha os esquemas de ferramentas inalterados por padrão, e tool_schema_transform: "simple" é a opção de desativação por modelo para endpoints que rejeitam $ref, $defs, anyOf, oneOf, allOf ou pattern.

A Kunavo não publica nenhuma página de configuração do PicoClaw e não realizou nenhum teste de compatibilidade com o PicoClaw; mantenha uma rota funcional disponível enquanto você experimenta, depois leia a cobrança que sua conta realmente registrou para essa tarefa, em vez de estimá-la a partir desta página. Crie uma conta Kunavo quando estiver pronto para financiar uma chave e compare as tarifas dos modelos em API Claude mais barata se Claude for a família que você escolheu.

Perguntas frequentes

Verificado em 21 de setembro de 2026: o repositório do GitHub e a API de releases, picoclaw.io (lido com a validação de certificado desativada, porque o certificado havia expirado), o 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, e sete arquivos-fonte no branch main — factory_provider.go, openai_compat/provider.go, common/anthropic_common.go, anthropic_messages/provider.go, provider_metadata.go, pkg/config/defaults.go e pkg/config/config.go — além dos dois domínios semelhantes. Não verificado: as cotas de terceiros na própria tabela comparativa do PicoClaw, os preços de varejo do hardware e as notas de lançamento da v0.3.1. Nada foi instalado ou executado: nenhuma solicitação do PicoClaw foi enviada a qualquer endpoint. As tarifas de tokens da Kunavo vêm do catálogo ativo, e todos os exemplos em dólares aqui são cálculos ilustrativos de tokens, não o custo medido de uma tarefa.