Precios y configuración de API de PicoClaw: modelos, protocolos y claves

El software PicoClaw es gratuito: el repositorio tiene licencia MIT y la propia FAQ de picoclaw.io dice "The software is free. You only pay for the LLM API usage"; por tanto, "precios de PicoClaw" significa la factura de la API de tu modelo, más lo que cueste el dispositivo. Sipeed no anuncia ninguna suscripción de PicoClaw ni ningún nivel alojado. La cifra que merece la pena presupuestar son los tokens por turno del agente, y el ajuste que más probablemente te sorprenda es el límite de iteraciones de herramientas de PicoClaw: 50 cuando el campo está ausente, 20 en el archivo de configuración de ejemplo incluido.

Primero, dos aclaraciones, porque la página de resultados las mezcla. El dominio oficial es picoclaw.io; es el campo homepage de github.com/sipeed/picoclaw. El sitio parecido pico-claw.com declara en su propio pie de página que "is not officially affiliated with Sipeed or PicoClaw", y el precio mensual que aparece allí corresponde al módulo de alojamiento gestionado de ese sitio, no a PicoClaw. Un segundo sitio parecido, picoclaw.net, tampoco es el dominio oficial. Encabeza la página con "95% AI-Generated Code" y "3 Supported Architectures" —x86_64, ARM64 y RISC-V—, mientras que la FAQ de picoclaw.io enumera seis. Y PicoClaw no es un fork de OpenClaw; es una implementación independiente en Go que se compara mediante benchmarks con OpenClaw y NanoBot.

Precios de PicoClaw, línea por línea

Todo se comprobó el 21 de septiembre de 2026. Versión, para que conste: la versión etiquetada más reciente es v0.3.1, publicada el 3 de julio de 2026, mientras que el último push del repositorio fue el 17 de septiembre de 2026; por tanto, el código de main está por delante de la etiqueta, y la propia lista de novedades del README está aún más desactualizada: su entrada de versión más reciente es v0.2.9, del 28 de mayo de 2026. Todos los comportamientos siguientes se leyeron en main, no en el binario v0.3.1 que descargarías; un lector de la versión etiquetada podría ver algo diferente. Una condición activa en la fecha de comprobación: el certificado TLS de picoclaw.io había caducado (válido del 25 de febrero al 10 de septiembre de 2026), por lo que el navegador muestra una advertencia de seguridad en la página oficial de descargas. Esto puede solucionarse cualquier día y no dice nada sobre el proyecto; GitHub Releases no se ve afectado.

Configuración de la clave de API de PicoClaw: model_list y .security.yml

picoclaw onboard crea ~/.picoclaw/config.json y el espacio de trabajo. Los modelos se declaran en un array model_list y se seleccionan por nombre desde agents.defaults.model_name; ambos deben coincidir, que es el único caso que cubre el documento de resolución de problemas de 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
    }
  ]
}

Las claves viven en un segundo archivo. La documentación de seguridad de PicoClaw denomina a config.json "Main configuration (safe to share)" y a .security.yml "Security data (never share)", y te indica que debes chmod 600. La estructura YAML es un mapa indexado por model_name, no el array usado en config.json, y api_keys está en plural y es un array incluso para una sola clave.

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

Cuatro detalles que suelen sorprender. provider es opcional: establécelo y model se envía al upstream sin cambios; omítelo y PicoClaw interpreta como proveedor todo lo que aparece antes del primer / en model, que es el formato heredado protocol/model. La configuración tiene versiones de esquema y la versión 3 es la actual; la migración escribe una copia de seguridad con fecha, y la documentación advierte que un archivo V3 no puede cargarse de forma segura en compilaciones antiguas que solo admiten V2. Durante la migración de V1 a V2, enabled se infiere automáticamente; las entradas sin clave de API y cuyo nombre no sea local-model se establecen de forma predeterminada en disabled, razón por la cual el ejemplo anterior establece explícitamente enabled después de trasladar las claves a .security.yml. Además, el streaming está desactivado de forma predeterminada y requiere dos condiciones: streaming.enabled de la entrada del modelo y settings.streaming.enabled del canal deben ser ambos true.

Hay un límite que conviene señalar antes de escribir las entradas: la tabla de proveedores de PicoClaw enumera Groq como "LLM + Voice transcription (Whisper)", y Kunavo no ofrece conversión de voz a texto, conversión de texto a voz ni embeddings; una entrada de transcripción o embeddings debe apuntar a otro proveedor, y solo las entradas de chat pueden usar una clave de Kunavo.

Los nombres de los protocolos están invertidos, y esa es toda la trampa

En PicoClaw, anthropic significa modelos con formato Claude a través del formato de conexión de OpenAI, y anthropic-messages significa la API nativa Messages de Anthropic. La documentación lo dice explícitamente: "The anthropic protocol uses OpenAI-compatible format (/v1/chat/completions), while anthropic-messages uses Anthropic's native format (/v1/messages)." El código coincide: factory_provider.go construye el proveedor HTTP compartido compatible con OpenAI para anthropic y un proveedor nativo separado para anthropic-messages. La propia tabla "All Supported Vendors" de PicoClaw contradice a ambos al etiquetar la columna de protocolo de la fila anthropic como "Anthropic"; quien solo lea esa tabla configurará el incorrecto.

Leído de openai_compat/provider.go, common/anthropic_common.go, anthropic_messages/provider.go y factory_provider.go en main, el 21 de septiembre de 2026; derivado del código, no observado en la conexión. La consecuencia es concreta: no puedes apuntar anthropic ni anthropic-messages a un gateway cuya ruta no deba terminar en /v1, porque PicoClaw lo añade siempre. Un gateway en https://gw.example.com/anthropic se convierte en https://gw.example.com/anthropic/v1/messages. Para tal endpoint, el protocolo openai, que respeta la ruta literalmente, es el único que puede expresar la URL. Solo se auditaron estos tres protocolos; no generalices la regla a gemini, azure ni al resto.

Hay otros dos límites para la ruta nativa, ambos leídos en el mismo archivo. anthropic-messages requiere una clave de API y genera un error grave si no la recibe, por lo que no se puede acceder a la rama OAuth —que factory_provider.go conecta con anthropic y openai, junto con los puentes de la CLI y antigravity— a través de ella. Y aunque cinco ramas de factory_provider.go reenvían cfg.CustomHeaders, la rama anthropic-messages no es una de ellas: su constructor solo recibe la clave, la URL base, el agente de usuario y el tiempo de espera. Por tanto, la vía de escape documentada custom_headers para un gateway con autenticación no estándar parece llegar a los protocolos compatibles con OpenAI, pero no al Messages nativo. Esta es una lectura del código fuente, no una prueba en ejecución. Lo que la ruta nativa no te hace perder es la llamada de herramientas: construye tools nativo con input_schema y gestiona los bloques tool_use y tool_result.

Para Kunavo, las dos URL base documentadas son https://api.kunavo.com/v1 para chat completions y https://api.kunavo.com/v1/messages para la ruta Messages, y el gestor Messages de Kunavo también lee la clave de x-api-key, además de Authorization: Bearer. Sobre el papel, ambas cumplen la aritmética de URL de PicoClaw desde las dos direcciones. Esto es aritmética basada en dos conjuntos de documentación; aquí no se ha realizado ninguna solicitud de PicoClaw a Kunavo, y esta página no afirma que ningún protocolo de PicoClaw se haya probado contra él. Consulta la documentación de la URL base de Anthropic y la documentación del endpoint de chat para conocer las estructuras exactas y después envía tú mismo una solicitud acotada.

Una estimación práctica del coste de la API de PicoClaw

Estas son operaciones aritméticas ilustrativas de tokens, no costes medidos de tareas ni un límite máximo de facturación. Supón un turno de agente que se resuelve en 8 rondas de herramientas, donde cada ronda vuelve a enviar una transcripción con un promedio de 12.000 tokens de entrada y devuelve 700 tokens de salida. Esas proporciones son supuestos para la ilustración. La segunda columna aplica la misma estructura hasta el valor predeterminado compilado de max_tool_iterations de 50 en pkg/config/defaults.go, que se aplica cuando el campo está ausente; el config/config.example.json incluido escribe 20, así que lee tu propio archivo antes de tratar 50 como tu límite. Las tarifas son precios actuales del catálogo de Kunavo por millón de tokens.

Lee ambas columnas como un solo hecho. Pasar de 8 rondas al límite de 50 rondas multiplica cada fila por el mismo factor 6,25x, porque la longitud del bucle es independiente de la tarifa: un turno de Claude Sonnet 4.6 cuesta $0,260 con 8 rondas y $1,627 en el límite, mientras que Claude Haiku 4.5 en ese mismo límite cuesta $0,542. Por tanto, limita max_tool_iterations a un número que hayas observado realmente antes de buscar una tarifa más barata; se encuentra bajo agents.defaults y se puede sobrescribir mediante la variable de entorno PICOCLAW_AGENTS_DEFAULTS_MAX_TOOL_ITERATIONS. Después, escálalo según los turnos diarios.

El importe del catálogo de Kunavo es un mínimo de facturación, no un límite: cuando el upstream informa de su cargo, la factura es el mayor de entre el coste del catálogo y el coste del upstream multiplicado por el margen aplicable. Las lecturas y escrituras de caché se facturan con sus propias tarifas y no se modelan aquí en ninguna dirección, y las llamadas a herramientas externas también quedan fuera del ejemplo. La recarga mínima es de $10 en crédito prepago, un mínimo de financiación, no una tarifa por tarea ni una suscripción; consulta detalles de facturación y optimización de costes de IA para conocer el método de medición.

La mejor API para PicoClaw: cuándo gana cada ruta

Los recuentos de proveedores no son un eje de comparación aquí: el propio conjunto de archivos de PicoClaw discrepa sobre qué proveedores existen, así que lo más seguro es repetir la formulación del README: "30+ LLM providers". Para situar PicoClaw entre los demás agentes de binario único, el directorio de APIs de agentes de IA enumera su superficie de configuración junto a la de ellos, y alternativas a OpenRouter compara las rutas de gateway según las condiciones de financiación, no según la profundidad de integración.

Primera solicitud, primera ronda de herramientas y un 404

Ejecuta una tarea acotada y revisa tres cosas en orden. Un error model not found in model_list es el caso documentado y se debe a una discrepancia de nombres: agents.defaults.model_name debe coincidir con una entrada de model_name, y un identificador sin prefijo y sin provider configurado no selecciona el proveedor que pretendías usar: recurre al protocolo openai, que corresponde al caso documentado de "model": "free" en el que OpenRouter recibe el identificador literal free y lo rechaza. Un 404 en la primera solicitud es la señal documentada de que elegiste el protocolo de Anthropic incorrecto: las propias indicaciones de PicoClaw recomiendan pasar a anthropic-messages cuando "el protocolo anthropic existente devuelve errores 404 (lo que indica que el endpoint no admite el formato compatible con OpenAI)". Comprueba la URL construida con la tabla anterior antes de cambiar cualquier otra cosa; no hay ninguna entrada oficial de resolución de problemas para este caso, por lo que ese diagnóstico procede de la nota sobre los proveedores y del código fuente, no de una página de soporte. En tercer lugar, si falla la primera ronda de herramientas mientras que el chat simple funcionó, sospecha de la rigurosidad de la validación del esquema en lugar de la autenticación: PicoClaw reenvía los esquemas de las herramientas sin cambios de forma predeterminada, y tool_schema_transform: "simple" es la opción por modelo para desactivar este comportamiento en los endpoints que rechazan $ref, $defs, anyOf, oneOf, allOf o pattern.

Kunavo no publica ninguna página de configuración de PicoClaw ni ha realizado ninguna prueba de compatibilidad con PicoClaw; mantén disponible una ruta funcional mientras lo pruebas y después lee el cargo que tu cuenta haya registrado realmente para esa tarea, en lugar de estimarlo a partir de esta página. Crea una cuenta de Kunavo cuando estés listo para financiar una clave y compara las tarifas de los modelos en Claude API más barata si Claude es la familia que has elegido.

Preguntas frecuentes

Comprobado el 21 de septiembre de 2026: el repositorio de GitHub y la API de releases, picoclaw.io (leído con la validación del certificado desactivada porque su certificado había caducado), el 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 y siete archivos fuente de la rama main —factory_provider.go, openai_compat/provider.go, common/anthropic_common.go, anthropic_messages/provider.go, provider_metadata.go, pkg/config/defaults.go y pkg/config/config.go—, además de los dos dominios parecidos. No se comprobaron: las cuotas de terceros de la propia tabla comparativa de PicoClaw, los precios minoristas del hardware ni las notas de la versión v0.3.1. No se instaló ni ejecutó nada: no se envió ninguna solicitud de PicoClaw a ningún endpoint. Las tarifas de tokens de Kunavo proceden del catálogo actual, y todos los ejemplos en dólares son operaciones aritméticas ilustrativas de tokens, no el coste medido de una tarea.