OpenClaw

O OpenClaw é uma IA pessoal auto-hospedada que roda na sua máquina e responde pelos canais que você já usa (WhatsApp, Telegram, Slack, Discord, iMessage e muitos mais). Ele suporta vários provedores de modelos — adicione o Synthorai como um deles e qualquer modelo de chat no seu workspace torna-se acessível via a configuração de agente do OpenClaw.

Antes de começar

Você precisará de (1) uma instalação do OpenClaw rodando localmente e (2) uma chave API Synthorai de Console → Chaves API.

Passo 1 — Editar ~/.openclaw/openclaw.json

Adicione o Synthorai em providers. Existentes openai/anthropic as entradas podem permanecer — o OpenClaw usará aquela referenciada por agent.model.

{
  "providers": {
    "synthorai": {
      "type": "openai",
      "base_url": "https://synthorai.io/v1",
      "api_key": "sk-..."
    }
  },
  "agent": {
    "model": "synthorai/gpt-5.4-mini"
  }
}

ℹ

type: openai diz ao OpenClaw para falar o protocolo OpenAI Chat Completions. O Synthorai é totalmente compatível com OpenAI em /v1/chat/completions, então funciona com qualquer modelo de chat no seu workspace — não apenas os hospedados pela OpenAI.

Passo 2 — (Opcional) adicionar também um provedor nativo Claude

Se você quer especificamente o formato de mensagem nativo da Anthropic (apenas modelos da família Claude), adicione um segundo provedor direcionado ao protocolo Anthropic. Observe o base_url não inclui /v1.

{
  "providers": {
    "synthorai": {
      "type": "openai",
      "base_url": "https://synthorai.io/v1",
      "api_key": "sk-..."
    },
    "synthorai-claude": {
      "type": "anthropic",
      "base_url": "https://synthorai.io",
      "api_key": "sk-..."
    }
  },
  "agent": {
    "model": "synthorai-claude/claude-sonnet-4-6"
  }
}

Passo 3 — Reiniciar o OpenClaw

O OpenClaw relê openclaw.json ao iniciar. Após reiniciar, envie sua primeira mensagem por qualquer canal ao qual o OpenClaw esteja vinculado (ex.: Slack, Telegram) — o agente responderá usando o modelo Synthorai configurado.

Modelos recomendados

Para um assistente conversacional, o melhor equilíbrio custo-qualidade costuma ser um modelo intermediário rápido:

Parâmetro	Tipo	Descrição
`gpt-5.4-mini`	`fast`	OpenAI; rápido e de baixo custo. Bom padrão.
`qwen3.5-flash`	`fast`	Alibaba Qwen; preço competitivo para chinês + código + multilíngue.
`claude-sonnet-4-6`	`balanced`	Anthropic; melhor para conversas de contexto mais longo. Requer o formato de provedor claude acima.
`gemini-2.5-flash`	`fast`	Google; janela de contexto longa para fluxos de trabalho com muitos arquivos.

Solução de problemas

Divergências de nomes de campos entre versões do OpenClaw — os campos mostrados acima (type / base_url / api_key) são o padrão comum. Se uma versão específica do OpenClaw os renomear (e.g. provider_type / baseUrl), consulte a referência de configuração oficial e insira os mesmos valores.

401 / 403 — chave API incorreta, desativada ou sem quota. Verifique /console/keys e /console/billing.

"Modelo desconhecido" — o slug do modelo deve corresponder à coluna id em /console/pricing. Se você o referenciar via agent.model = "synthorai/MODEL_ID" certifique-se de que MODEL_ID seja roteável pela chave que você forneceu.

Implantações privadas / isoladas da rede — o mesmo formato JSON funciona; basta substituir a URL pública https://synthorai.io pelo nome de host do seu gateway interno.

Para ver quanto cada opção custa para um assistente sempre ativo, passe seu volume esperado pela LLM API cost calculator.