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
- Abra https://ai2save.com/keys.
- Crie um API Key que pertença ao grupo de modelos OpenAI / GPT.
- 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.apiKeypode ser diretamente escrito como"sk-..."; ao referenciar com${AI2SAVE_API_KEY}, deve ser definido emenv.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
- Abra a interface de chat do OpenClaw ou o WebChat.
- Inicie uma nova conversa e envie "Olá, por favor informe o nome do modelo atual".
- Confirme se o roteamento do modelo está exibindo como
ai2save/gpt-5.5. - 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_KEYnão definido, Key copiada incompleta ou Key com grupo incompatível. - 404 / model not found:
models[].id,primaryou 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 quemodels.providers.ai2save.models[]contenha pelo menos um modelo. - Configuração salva mas não aplicada: execute novamente
openclaw doctore, se necessário, reinicie OpenClaw e Gateway.