ai2saveai2save

OpenClaw Tutorial de Configuração

OpenClaw adiciona fornecedores de modelos personalizados através do models.providers. ai2save usa a interface OpenAI Compatible, e Base URL deve ser preenchido com https://ai2save.com/v1.

1. Preparar OpenClaw e API Key

Se o OpenClaw já estiver instalado, a instalação pode ser ignorada:

npm install -g openclaw@latest
openclaw --version
  1. Abra https://ai2save.com/keys.
  2. Crie um API Key que pertença ao grupo de modelos OpenAI / GPT.
  3. Copie a chave completa do sk-....

2. Editar o arquivo de configuração do OpenClaw

O arquivo de configuração padrão do OpenClaw é:

~/.openclaw/openclaw.json

O Windows geralmente está em %USERPROFILE%\.openclaw\openclaw.json. O arquivo suporta JSON5 e pode ser mesclado na configuração existente conforme a estrutura abaixo:

{
  env: {
    vars: {
      AI2SAVE_API_KEY: "sk-sua-chave-api",
    },
  },
  agents: {
    defaults: {
      model: {
        primary: "ai2save/gpt-5.5",
      },
    },
  },
  models: {
    mode: "merge",
    providers: {
      ai2save: {
        baseUrl: "https://ai2save.com/v1",
        apiKey: "${AI2SAVE_API_KEY}",
        api: "openai-completions",
        timeoutSeconds: 300,
        models: [
          {
            id: "gpt-5.5",
            name: "GPT 5.5",
            reasoning: true,
            input: ["text"],
            contextWindow: 200000,
          },
        ],
      },
    },
  },
}

Descrição dos campos principais:

  • models.providers.ai2save.baseUrl: Deve sempre ser usado com /v1.
  • api: "openai-completions": Tipo de interface usada por OpenClaw para acessar OpenAI Compatible como proxy.
  • models[].id: Deve corresponder exatamente ao ID do modelo aberto no console ai2save.
  • agents.defaults.model.primary: O formato é id-do-provedor/id-do-modelo.
  • apiKey pode ser diretamente escrito como "sk-..."; ao referenciar com ${AI2SAVE_API_KEY}, deve ser definido em env.vars.

Se você quiser adicionar múltiplos modelos, continue adicionando na matriz models e altere primary para o ai2save/model-id que deseja usar como padrão.

3. Aplicar e verificar a configuração

OpenClaw Gateway vão monitorar mudanças no arquivo de configuração e aplicar automaticamente. Se a configuração não entrar em vigor a tempo, execute:

openclaw gateway restart

Então verifique se o modelo já apareceu em OpenClaw:

openclaw models list --provider ai2save

Mude o modelo padrão para ai2save:

openclaw models set ai2save/gpt-5.5

Se o modelo não aparecer, execute o diagnóstico e verifique erros de configuração:

openclaw doctor

4. Verificação da Solicitação

  1. Abra a interface de chat do OpenClaw ou o WebChat.
  2. Inicie uma nova conversa e envie "Olá, por favor informe o nome do modelo atual".
  3. Confirme se o roteamento do modelo está exibindo como ai2save/gpt-5.5.
  4. Na primeira vez, verifique apenas com tarefas de texto; depois de bem-sucedido, abra arquivos, navegador, contexto longo e outras ferramentas complexas.

O OpenClaw faz automaticamente compatibilidade para agentes não oficiais da OpenAI, não sendo necessário ativar o developer role manualmente. Se houver problemas ao chamar ferramentas, primeiro confirme se o ID do modelo suporta chamadas de ferramentas e aumente o tempo limite, se necessário.

5. Erros Comuns

  • 401 / invalid_api_key: AI2SAVE_API_KEY não definido, Key copiada incompleta ou Key com grupo incompatível.
  • 404 / model not found: models[].id, primary ou o nome do modelo solicitado não corresponde ao real.
  • Falha de conexão / resposta vazia: verifique se baseUrl é https://ai2save.com/v1, não escreva como endereço raiz.
  • Lista de modelos vazia: confirme o models.mode: "merge" e garanta que models.providers.ai2save.models[] contenha pelo menos um modelo.
  • Configuração salva mas não aplicada: execute novamente openclaw doctor e, se necessário, reinicie OpenClaw e Gateway.