Back to Picoclaw

🐛 Solução de Problemas

docs/operations/troubleshooting.pt-br.md

0.2.81.5 KB
Original Source

🐛 Solução de Problemas

Voltar ao README

"model ... not found in model_list" ou OpenRouter "free is not a valid model ID"

Sintoma: VocĂȘ vĂȘ um dos seguintes erros:

  • Error creating provider: model "openrouter/free" not found in model_list
  • OpenRouter retorna 400: "free is not a valid model ID"

Causa: O campo model na sua entrada model_list Ă© o que Ă© enviado para a API. Para o OpenRouter, vocĂȘ deve usar o ID de modelo completo, nĂŁo uma abreviação.

  • Errado: "model": "free" → OpenRouter recebe free e rejeita.
  • Correto: "model": "openrouter/free" → OpenRouter recebe openrouter/free (roteamento automĂĄtico do nĂ­vel gratuito).

Correção: Em ~/.picoclaw/config.json (ou seu caminho de configuração):

  1. agents.defaults.model_name deve corresponder a um model_name em model_list (ex.: "openrouter-free").
  2. O model dessa entrada deve ser um ID de modelo OpenRouter vĂĄlido, por exemplo:
    • "openrouter/free" – nĂ­vel gratuito automĂĄtico
    • "google/gemini-2.0-flash-exp:free"
    • "meta-llama/llama-3.1-8b-instruct:free"

Exemplo:

json
{
  "agents": {
    "defaults": {
      "model_name": "openrouter-free"
    }
  },
  "model_list": [
    {
      "model_name": "openrouter-free",
      "model": "openrouter/free",
      "api_key": "sk-or-v1-YOUR_OPENROUTER_KEY",
      "api_base": "https://openrouter.ai/api/v1"
    }
  ]
}

Obtenha sua chave em OpenRouter Keys.