OpenClaw

O OpenClaw é um agente pessoal de IA auto-hospedado, que você usa por apps de conversa como Telegram e WhatsApp. Ele aceita provedores compatíveis com a OpenAI no arquivo de configuração.

Prompt para o seu agenteCopia as instruções de configuração desta página, para colar no seu agente de código.

Ver o prompt

Me ajude a configurar isto para usar a Bayle AI, uma API compatível com a OpenAI. Guia completo: https://docs.bayle.ai/pt-br/guides/agents/openclaw/

Objetivo: rodar o agente pessoal OpenClaw (https://openclaw.ai) com um modelo da Bayle.

1. Instale o OpenClaw se `openclaw --version` falhar:
   curl -fsSL https://openclaw.ai/install.sh | bash
   No Windows ou por outros métodos, siga https://docs.openclaw.ai/install.
2. Escolha um modelo com suporte a function calling, já que o OpenClaw usa ferramentas:
   curl -s "https://api.bayle.ai/models?type=text" \
     | jq -r '.data[] | select(.model_spec.capabilities.supportsFunctionCalling) | .id'
   Me mostre a lista, deixe eu escolher e use esse id como MODEL_ID.
3. Confirme que BAYLE_API_KEY está definida no ambiente em que o OpenClaw roda (o shell ou serviço que o inicia). Se não estiver, me explique como defini-la ali.
4. Edite ~/.openclaw/openclaw.json (JSON5), mesclando com o que já existe. MODEL_ID entra nos dois lugares, e a key continua sendo uma referência:
   {
     agents: {
       defaults: { model: { primary: "bayle/MODEL_ID" } },
     },
     models: {
       mode: "merge",
       providers: {
         bayle: {
           baseUrl: "https://api.bayle.ai",
           apiKey: "${BAYLE_API_KEY}",
           api: "openai-completions",
           models: [{ id: "MODEL_ID", name: "MODEL_ID" }],
         },
       },
     },
   }
5. Verifique mandando ao OpenClaw uma mensagem curta pela CLI ou pelo chat. Um 404 quer dizer que a base URL tem um caminho no final; um 401 quer dizer que a key não chegou à requisição.

Regras:
1. A base URL é https://api.bayle.ai exatamente como está escrita. Não acrescente nenhum caminho a ela.
2. Leia a key da variável de ambiente BAYLE_API_KEY. Nunca escreva a key em um arquivo que você criar, em um comando, em um commit nem no chat. Onde a ferramenta guarda a key na própria tela de configurações, me diga onde colar. Se BAYLE_API_KEY não estiver definida, pare e peça que eu crie uma key em https://chat.bayle.ai/developers e a exporte.
3. Pegue os ids de modelo só de GET https://api.bayle.ai/models (sem key). Nunca chute um.
4. Termine com uma requisição de teste de verdade, me mostre o resultado e liste os arquivos que você alterou.

Instalação

curl -fsSL https://openclaw.ai/install.sh | bash

Esse é o instalador para macOS e Linux. Para Windows e outros métodos, veja o guia oficial de instalação.

Configure

Ainda não tem uma chave da Bayle?Obter chave de API

Defina a key no ambiente em que o OpenClaw roda:

export BAYLE_API_KEY="your-key"

Adicione a Bayle como provedor em ~/.openclaw/openclaw.json (JSON5), dentro de models.providers, e deixe-a como modelo padrão do agente:

{
  agents: {
    defaults: { model: { primary: "bayle/MODEL_ID" } },
  },
  models: {
    mode: "merge",
    providers: {
      bayle: {
        baseUrl: "https://api.bayle.ai",
        apiKey: "${BAYLE_API_KEY}",
        api: "openai-completions",
        models: [{ id: "MODEL_ID", name: "MODEL_ID" }],
      },
    },
  },
}

• baseUrl é https://api.bayle.ai. O OpenClaw acrescenta /chat/completions sozinho.
• api: "openai-completions" escolhe o formato de chat completions, que é o que a Bayle serve.
• Um modelo é referenciado como provedor/id, ou seja, bayle/MODEL_ID, e também precisa aparecer na lista models do provedor.
• mode: "merge" mantém os outros provedores do OpenClaw junto com este.

Escolha um modelo

O OpenClaw usa ferramentas, então escolha um modelo com suporte a function calling:

curl -s "https://api.bayle.ai/models?type=text" \
  | jq -r '.data[] | select(.model_spec.capabilities.supportsFunctionCalling) | .id'

Troque MODEL_ID nos dois lugares por um desses ids. Para adicionar mais, liste cada um em models.

Se não funcionar

• Um 404 quer dizer que a base URL tem um caminho no final. Ela deve ser exatamente https://api.bayle.ai.
• Um 401 quer dizer que a key não chegou à requisição. Confira se BAYLE_API_KEY está definida no shell ou serviço que inicia o OpenClaw.
• Veja A Bayle como backend de agentes sobre retentativas e erros de saldo.