Seções da Base de Conhecimento ▾

Navegação

▸ Comece aqui Por funções

Categorias

Ferramentas 52
Glossário 12

Ferramentas

OpenClaw + Gonka AI — agentes AI acessíveis

OpenClaw é um framework para criar agentes de IA autônomos capazes de realizar tarefas complexas: pesquisa, escrita de código, automação de processos de negócios. Os agentes funcionam em um ciclo de "pensar → agir → observar", decompondo tarefas de forma independente e invocando ferramentas.

O principal problema dos agentes autônomos é o custo. Um agente pode fazer de 50 a 500 chamadas de LLM por tarefa. Com os preços da OpenAI ($5—30/1M tokens), isso custa entre $10 e $100 por tarefa. Se o agente trabalha continuamente, a conta mensal chega a milhares de dólares. Essa é a diferença entre um produto lucrativo e um deficitário.

JoinGonka Gateway reduz o custo em ~720—1,400 vezes: $0.0069/1M tokens na entrada e $0.021/1M na saída. Um agente que custava $100 por tarefa, agora custa cerca de 10 centavos (segundo preços de setembro de 2026). Isso torna os agentes autônomos economicamente viáveis até mesmo para startups e desenvolvedores indie.

Passo 1: Obter a chave API

Registro no JoinGonka Gateway:

  1. Acesse gate.joingonka.ai/register.
  2. Receba um bônus de 3M tokens gratuitos.
  3. Crie uma API-key no Dashboard → API Keys (formato: jg-xxx).

O bônus é suficiente para testar a conexão nas primeiras execuções do agente; a economia é radicalmente diferente comparada à OpenAI.

Passo 2: Configurar o OpenClaw

O OpenClaw funciona com o JoinGonka Gateway em modo compatível com OpenAI. A forma mais simples de configurá-lo é com o instalador de um único comando — ele mesmo registra o provedor com o baseUrl e os modelos corretos, fazendo backup da sua configuração atual:

npx @joingonka/setup --tool openclaw

É o instalador universal do JoinGonka: sem flag — npx @joingonka/setup — ele oferece para você escolher uma ferramenta da lista. Já são 25: Claude Code, Codex CLI, OpenClaw, Cursor, Cline e outras — lista completa no README do pacote.

O instalador vai pedir a API key (jg-…) e adicionar em ~/.openclaw/openclaw.json apenas o provedor JoinGonka, sem mexer no restante das suas configurações. A chave é gravada no arquivo como literal e o arquivo recebe permissões 600. O modelo principal passa a ser o DeepSeek V4 Flash, e como reservas o GLM-5.3 Flash e o MiniMax M2.7: se um modelo estiver ocupado, ele alterna o agente para o próximo em vez de pará-lo. O instalador não mexe na sua própria lista de modelos de reserva, se você já tiver uma; outro modelo principal é definido com a flag --model minimax|deepseek|glm.

Configurar manualmente (plano B)

O OpenClaw guarda os provedores em ~/.openclaw/openclaw.json — estrutura aninhada models.providers. Adicione o provedor gonka em modo OpenAI (api: openai-completions, baseUrl com /v1):

{
  "models": {
    "providers": {
      "gonka": {
        "baseUrl": "https://gate.joingonka.ai/v1",
        "api": "openai-completions",
        "apiKey": "jg-your-key",
        "models": [
          { "id": "deepseek-ai/DeepSeek-V4-Flash-0731", "name": "DeepSeek V4 Flash", "contextWindow": 380000, "maxTokens": 32768 },
          { "id": "zai-org/GLM-5.3-Flash", "name": "GLM-5.3 Flash", "contextWindow": 390000, "maxTokens": 8192 },
          { "id": "MiniMaxAI/MiniMax-M2.7", "name": "MiniMax M2.7", "contextWindow": 200000, "maxTokens": 8192 }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "gonka/deepseek-ai/DeepSeek-V4-Flash-0731",
        "fallbacks": ["gonka/zai-org/GLM-5.3-Flash", "gonka/MiniMaxAI/MiniMax-M2.7"]
      }
    }
  }
}

A chave fica gravada no arquivo como literal, então deixe o acesso ao arquivo só para você: chmod 600 ~/.openclaw/openclaw.json. O OpenClaw também entende uma referência a variável de ambiente ("apiKey": "${GONKA_API_KEY}"), mas ela só funciona enquanto a variável estiver exportada no ambiente a partir do qual o agente é iniciado; o literal não depende do ambiente. O bloco fallbacks são os modelos de reserva: se o principal estiver ocupado, o agente alterna para o próximo em vez de parar. Cada modelo indica sua janela de contexto real e seu teto de resposta.

Tool calling: todos os modelos da rede suportam tool calling nativo — algo crítico para frameworks de agentes. O agente pode chamar busca, leitura de arquivos, execução de código e outras ferramentas através da API padrão de function calling da OpenAI.

Verificação: rode um agente simples com a tarefa «escreva hello world em Python e explique o código». Se o agente concluiu a tarefa, a configuração deu certo.

Economia de agentes autônomos

Agentes autônomos são algumas das aplicações mais exigentes em termos de tokens. Um ciclo de agente (prompt → ferramentas → reflexão) consome de 5 a 50K tokens. Uma tarefa complexa pode exigir de 50 a 500 ciclos. Vamos comparar a economia:

CenárioTokens por tarefaOpenAI GPT-5.5JoinGonka MiniMax M2.7Economia
Tarefa simples (10 ciclos)~500K$1.25 — $5.00$0.0072170x — 700x
Tarefa média (100 ciclos)~5M$12.50 — $50.00$0.072170x — 700x
Tarefa complexa (500 ciclos)~25M$62.50 — $250.00$0.36170x — 700x
Mês de operação contínua~5B$12,500 — $50,000$72170x — 700x

Com os preços da OpenAI, os agentes autônomos são economicamente inviáveis para a maioria das tarefas. Com os preços da Gonka, um agente pode trabalhar 24 horas por dia por $48 por mês. Isso muda o modelo: os agentes deixam de ser um «brinquedo caro» para se tornarem uma ferramenta de trabalho.

Para empresas: se o seu produto utiliza agentes AI (suporte ao cliente, análise de dados, automação), a migração para a Gonka pode reduzir o custo de produção em 99.81% — o que significa aumentar a margem ou reduzir o preço para os clientes.

Limitações: a janela de contexto do MiniMax M2.7 é de 200K tokens, e a do DeepSeek V4 Flash é de 380K. Para agentes com um histórico muito longo (mais de 500 ciclos), pode ser necessária a sumarização do contexto. O comprimento máximo de cada resposta é de 8192 tokens no MiniMax M2.7 e GLM-5.3 Flash, e 32768 no DeepSeek V4 Flash, o que é suficiente para um ciclo típico de agente (instrução + chamada de ferramenta).

OpenClaw + Gonka = agentes AI autônomos por $24/mês em vez de $12,500+ na OpenAI. A economia de centenas de vezes torna os agentes lucrativos até para desenvolvedores independentes. O tool calling nativo em todos os modelos da rede garante compatibilidade total.

Quer saber mais?

Explore outras seções ou comece a ganhar GNK agora mesmo.

Obter tokens gratuitos →