Custos e provedores da API do NanoClaw: Claude, OpenCode e rotas locais

O NanoClaw custa US$ 0. Ele é licenciado sob a MIT, auto-hospedado, não tem contas de usuário nem plano pago, e seu site de documentação não publica nenhuma página de preços — portanto, "preços do NanoClaw" significa a cobrança do modelo do provedor que você conectar, além de uma assinatura do Docker Desktop se sua empresa estiver acima dos limites de uso gratuito do Docker. O número que vale planejar é o cobrado pelo runtime padrão, porque o NanoClaw é distribuído apontando para o Claude; o Codex é a única alternativa que a configuração pode instalar diretamente, e o restante são complementos instalados depois.

Primeiro, duas desambiguações, porque a página de resultados mistura os projetos. Clawland-AI/nanoclaw é um agente Python não relacionado para computadores de placa única, e os custos de hardware dele não são deste produto. Um título de terceiros amplamente compartilhado também associa um valor em dólar às palavras "fábrica de PRs do NanoClaw"; qualquer que seja a métrica desse valor, ele não é um preço cobrado pelo NanoClaw, porque o NanoClaw não cobra nada. Esta página trata de nanocoai/nanoclaw — MIT, não arquivado, 30.814 estrelas, criado em 31 de janeiro de 2026, último push em 19 de setembro de 2026 (API do GitHub, 21 de setembro de 2026). O endereço antigo qwibitai/nanoclaw agora retorna um 301 para esse mesmo repositório, portanto um texto ou diretório que ainda aponte para lá não está descrevendo um segundo projeto. A instalação documentada pelo NanoClaw é bash nanoclaw.sh a partir desse checkout, portanto trate uma listagem no SourceForge como um espelho, não como o canal próprio do projeto.

Quanto o software custa e o que realmente gera cobrança

A seção de perguntas frequentes da página inicial do NanoClaw responde à questão financeira em uma linha: ele é gratuito e de código aberto sob a licença MIT, e "your agent provider may charge for model usage." O índice da documentação lista 56 páginas, e nenhuma delas é uma página de preços, cobrança ou planos. A cobrança vive inteiramente do outro lado do contêiner.

Tudo foi verificado em 21 de setembro de 2026. A parte do Docker é a que as pessoas mais deixam passar: o Docker Engine no Linux não aciona essa cláusula, mas uma instalação comercial no macOS ou Windows acima desses limites aciona. Antes de tudo, os requisitos do README são macOS ou Linux (Windows via WSL2), Node.js 22+ e pnpm 10+, Docker e o próprio Claude Code — que é um pré-requisito para /customize, /debug, a recuperação de erros de configuração e todas as skills /add-<channel>, não apenas para o provedor padrão. A versão atual é v2.4.0, publicada em 23 de setembro de 2026, e package.json na branch main está de acordo.

O runtime padrão é o Claude, e há três formas de pagar por ele

Esta é a distinção que a maioria das listas de provedores obscurece. Pronto para uso, o NanoClaw executa o Claude Code dentro do contêiner do agente por meio do Anthropic Claude Agent SDK — container/cli-tools.json fixa @anthropic-ai/claude-code em 2.1.280. O guia de credenciais do NanoClaw descreve três formas pelas quais o assistente se conecta ao Claude — uma assinatura do Claude, uma chave de API ou um token OAuth que você já possui, ou um endpoint compatível com Anthropic — e afirma que as três acabam como um segredo no vault, e não como uma variável de ambiente, com o caminho de assinatura executando claude setup-token e armazenando o token OAuth resultante. Os preços dos fornecedores abaixo são os valores mostrados por essas páginas na data indicada; confirme o valor no checkout do próprio fornecedor antes de assumir o compromisso.

Na opção de assinatura, duas declarações oficiais aparecem lado a lado, e esta página não as reconciliará por você. O assistente de configuração do NanoClaw identifica o login por assinatura como "recomendado se você tiver Pro ou Max", e a página de preços do Claude lista o Pro a $20 por mês com cobrança mensal, ou $17 por mês no plano anual de $200 cobrados antecipadamente, e o Max a partir de $100 por mês. A visão geral do Agent SDK da Anthropic afirma separadamente que, salvo aprovação prévia, não permite que desenvolvedores terceiros ofereçam login do claude.ai ou limites de taxa para seus produtos, incluindo agentes criados com o Agent SDK. Não é possível estabelecer, com nenhuma fonte pública aqui, se o NanoClaw tem essa aprovação; tampouco é possível estabelecer a cota de uso que uma assinatura concede a um agente — a Anthropic não publica nenhum número de tokens para Pro ou Max.

API personalizada do NanoClaw: o único caminho documentado

Um endpoint compatível com Anthropic é um caminho de configuração de primeira classe, e é mais restrito do que o README sugere. Definir ambas as variáveis abaixo faz com que a configuração crie um segredo OneCLI com injeção de cabeçalho vinculada ao seu hostname, grave somente a URL base em .env e registre a configuração do provedor de endpoint personalizado.

# NanoClaw's credentials guide: set BOTH before running setup.
# Only one of the two is not enough — setup takes this branch only when
# no Anthropic secret exists yet, and the URL is an origin with no /v1.
export NANOCLAW_ANTHROPIC_BASE_URL=https://api.kunavo.com
export NANOCLAW_ANTHROPIC_AUTH_TOKEN=<your key>

# The same two values exist as setup flags:
#   --anthropic-base-url   --anthropic-auth-token

Quatro restrições decorrem da forma como isso é construído. Ambas as variáveis são obrigatórias — o branch da configuração testa o par. O branch só é executado quando ainda não existe um segredo Anthropic, portanto este é um caminho de primeira instalação, não uma forma de redirecionar uma máquina que já tem o Claude conectado. O segredo é vinculado ao hostname extraído da sua URL, portanto mudar de domínio significa recriá-lo. E a URL deve ser uma origem: a própria referência de ANTHROPIC_BASE_URL da Kunavo explica por que https://api.kunavo.com funciona e https://api.kunavo.com/v1 produz solicitações para /v1/v1/messages.

Fixe também o modelo. Um grupo sem modelo próprio executa o padrão do Claude Code, que acompanha o Opus mais recente — Opus 5.5 desde a v2.4.0, segundo o changelog do NanoClaw — e um modelo que a Kunavo ainda não oferece responde 404. O NANOCLAW_DEFAULT_MODEL no .env da instalação preenche todos os grupos que não definiram um; a referência de variáveis de ambiente diz que uma alteração exige reiniciar o host e, depois, reiniciar as sessões afetadas.

# NanoClaw 2.4.0+: the model for every agent group that has not set its
# own (a group's own model wins). Install-wide, so Codex and OpenCode groups
# without one get it too; on a mixed install set each Claude group instead:
#   ncl groups config update --id <group> --model <model>
NANOCLAW_DEFAULT_MODEL=claude-sonnet-5

Dentro do contêiner, seu token nunca aparece. O provedor Claude do NanoClaw injeta a URL base mais ANTHROPIC_AUTH_TOKEN=placeholder, e o gateway do vault reescreve o bearer na rede — o que também significa que a injeção depende de o contêiner usar o HTTPS_PROXY configurado. Qualquer coisa que ignore esse proxy também ignora a credencial. Na v2.3.0, o driver recusa uma especificação de contêiner que contenha qualquer valor de credencial no ambiente fornecido, portanto inserir manualmente uma chave real em um container.json gerado é negado pela política, e não apenas desencorajado.

Duas fontes oficiais discordam sobre a versão simples de .env, e vale conhecer ambas. O README apresenta ANTHROPIC_BASE_URL e ANTHROPIC_AUTH_TOKEN em .env "para experimentos pontuais", enquanto a referência de variáveis de ambiente diz que ANTHROPIC_BASE_URL só fica ativo depois que a configuração registra o provedor de endpoint personalizado. Na main atual, a parte do token nunca chega a uma solicitação: o arquivo do provedor Claude vinculado acima consulta .env apenas por ANTHROPIC_BASE_URL e define ANTHROPIC_AUTH_TOKEN com a string literal placeholder. Trate o trecho do README como um experimento, exatamente como está rotulado, e o caminho de configuração acima como a configuração que você executaria.

Padrão versus estendido: o que cada caminho realmente instala

Fontes verificadas em 21 de setembro de 2026: o guia de provedores do NanoClaw, seus arquivos de skill /add-opencode e /add-codex, docs/ollama.md e a página de preços do ChatGPT (a antiga URL de preços do Codex agora redireciona para lá). A primeira coluna segue o mesmo guia de provedores, que diz que o seletor de runtime da configuração oferece o Codex como instalação em linha, enquanto o OpenCode é adicionado após a configuração com /add-opencode. A ressalva do Ollama vem do próprio fornecedor: o guia de provedores afirma que a skill continua no repositório, mas aponta para um caminho de configuração mais antigo, que essas edições legadas "não são uma troca direta compatível com a main atual" e que a integração precisa ser portada e testada primeiro — enquanto o README ainda a lista como um caminho compatível. Quando os dois discordam, a declaração mais nova e específica é a do guia de provedores. O OpenRouter chega ao NanoClaw pelo backend do OpenCode, não por uma URL base Anthropic; a FAQ do OpenRouter cobra 5,5% com mínimo de $0,80 em compras de crédito com cartão e 5% em criptomoedas, sem margem sobre a inferência em si.

Uma estimativa prática do custo da API do NanoClaw

Isto é aritmética de tokens baseada nas premissas declaradas, não um custo de tarefa medido nem um teto de cobrança. Suponha um grupo de agentes que processe 40 turnos por dia, cada um enviando 30.000 tokens de entrada e retornando 1.500 tokens de saída, com nada servido a partir do cache. As tarifas são os preços atuais do catálogo da Kunavo por milhão de tokens.

Três leituras. Primeiro, Claude Sonnet 5 e Claude Opus 5 já não têm a mesma tarifa de catálogo, portanto compare diretamente essas duas linhas antes de escolher — comparando com a tarifa que a Anthropic publica para o mesmo ID de modelo Opus 5, $5.00 e $25.00 por milhão, o custo estimado para o mesmo mês de uso é de $225.00. Segundo, o cache é uma alavanca maior do que a linha do modelo, porque essa mesma página define uma leitura do cache como 0,1x a entrada base e uma gravação de cache de cinco minutos como 1,25x: se 70% da entrada acima chegasse como leituras do cache à tarifa de entrada em cache do catálogo de $0.35 por milhão, o custo estimado para o mesmo mês de uso de Claude Opus 5 seria de $78.12, em vez de $157.50. Terceiro, ajuste a quantidade de turnos aos seus próprios canais antes de tratar qualquer um desses valores como orçamento — um agente NanoClaw conectado a um grupo de conversa movimentado e outro conectado a uma única pessoa não têm a mesma carga de trabalho.

O valor do catálogo da Kunavo é um piso de cobrança, e não um teto: quando o upstream informa sua cobrança, a fatura é o maior entre o custo do catálogo e o custo do upstream multiplicado pela margem aplicável. O carregamento mínimo é $10 em crédito pré-pago — um mínimo de financiamento, não uma taxa por tarefa nem uma assinatura. Consulte os detalhes de cobrança e os relatórios de uso.

Verificação mínima e o custo de estender depois

A verificação útil mais barata é pequena: setup/index.ts registra uma etapa de verify, e a própria aceitação da skill /add-opencode consiste em enviar uma mensagem, confirmar uma resposta e depois enviar uma segunda para confirmar que a sessão continua. Para um endpoint personalizado, docker exec <container> env | grep ANTHROPIC deve mostrar sua URL base ao lado de um token de marcador — se a chave real estiver visível ali, há algo errado com o caminho, não certo.

Depois, calcule o custo de manutenção, porque os provedores estendidos são software fixado. O changelog do NanoClaw registra que a fixação anterior do Codex usava por padrão um modelo que a OpenAI retirou do Codex em 31 de agosto de 2026, e que executar /add-codex novamente não refixa uma instalação existente — a fixação atual é @openai/codex 0.155.1, desde a v2.4.0. A fixação do OpenCode é, por si só, um conflito entre fontes atuais: o arquivo de skill do repositório diz que ambas as fixações devem permanecer exatamente em 1.18.25, enquanto o guia de provedores publicado ainda diz 1.4.17. O repositório é a fonte mais específica, e o OpenCode também mudou de organização — sst/opencode agora redireciona com 301 para anomalyco/opencode, cuja versão mais recente é a v1.18.31 em 14 de setembro de 2026. As instalações no OneCLI 1.41.0 também precisam de reautenticação manual quando o login do ChatGPT no OpenCode expira.

A capacidade muda quando você deixa o provedor Claude, segundo o guia de provedores: OpenCode e Codex declaram não ter comandos nativos de barra, ambos enfileiram mensagens de acompanhamento em vez de aceitar entrada durante o turno, o Codex lê AGENTS.md com um limite de 32 KiB contra 4 MiB do Claude, e somente o provedor Claude alterna as transcrições. Trocar um grupo transfere a árvore memory/, mas não o contexto da conversa em andamento, e as alterações só entram em vigor na próxima inicialização do contêiner.

Apontando o NanoClaw para a Kunavo

A Kunavo publica referências de configuração para esse tipo de cliente — os guias do Claude Agent SDK e do Claude Code cobrem o runtime padrão, e OpenCode e Codex CLI cobrem os dois estendidos. Essas são referências de configuração publicadas, não testes de compatibilidade: o NanoClaw não foi testado em runtime aqui, e tudo acima é uma leitura do repositório e da documentação dele. Mantenha um caminho funcional disponível enquanto experimenta, execute uma tarefa delimitada e depois leia o que sua conta registrou. Crie uma conta na Kunavo quando estiver pronto para financiar uma chave.

Escolhendo entre agentes, e não entre provedores? NanoClaw versus OpenClaw compara isolamento e liberdade de provedores, e preços do OpenCode, preços do Codex e alternativas ao OpenRouter cobrem os três caminhos que esta página trata como complementos. Preços do Claude Code cobre com mais detalhes a cobrança própria do runtime padrão.

Perguntas frequentes

Obtido diretamente durante a redação desta página, em 21 de setembro de 2026: o registro e a lista de versões do repositório nanocoai/nanoclaw, package.json, container/cli-tools.json, o README, o documento da imagem reforçada, nanoclaw.dev, o índice da documentação, as páginas de credenciais, variáveis de ambiente e provedores, docs/ollama.md, o changelog, os arquivos de skill /add-opencode e /add-codex, o repositório OneCLI e a página de preços da Anthropic. Os valores do Docker, da assinatura do Claude, do ChatGPT e do OpenRouter são citados das próprias páginas de preços desses fornecedores, conforme registrados na mesma data, e não foram buscados novamente aqui; portanto confirme qualquer um deles no checkout do fornecedor. As tarifas de tokens da Kunavo vêm do catálogo atual. A versão v2.4.0, seu changelog, container/cli-tools.json e a referência de variáveis de ambiente foram verificados novamente em 24 de setembro de 2026, quando a fixação do modelo foi adicionada. Nada nesta página foi testado em runtime contra uma instalação do NanoClaw, e todo valor em dólar é uma aritmética ilustrativa de tokens.