Seções da Base de Conhecimento ▾

Navegação

▸ Comece aqui Por funções

Categorias

Ferramentas 37
Glossário 12

Ferramentas

OpenClaw + Gonka AI — agentes AI acessíveis

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

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

JoinGonka Gateway reduz o custo em 390 vezes: $0.0047/1M de tokens. Um agente que custava $50 por tarefa, agora custa $0.129. 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 1.5M 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 maneira mais fácil de configurá-lo é usando o instalador de um comando — ele configurará automaticamente o provedor com a baseUrl correta e os modelos, fazendo um backup da sua configuração atual:

npx @joingonka/setup --tool openclaw

Este é o instalador universal do JoinGonka: sem flags — npx @joingonka/setup — ele oferecerá a escolha de uma ferramenta (Claude Code, OpenClaw ou Cline). O instalador solicitará a chave API (jg-…) e adicionará cuidadosamente apenas o provedor JoinGonka, sem afetar suas outras configurações. Mais detalhes: GitHub.

Configurar manualmente (plano B)

O OpenClaw armazena os provedores em ~/.openclaw/openclaw.json — uma estrutura aninhada de 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": "${GONKA_API_KEY}",
        "models": [
          { "id": "moonshotai/Kimi-K2.6", "name": "Kimi K2.6", "maxTokens": 8192 },
          { "id": "MiniMaxAI/MiniMax-M2.7", "name": "MiniMax M2.7", "maxTokens": 8192 },
          { "id": "deepseek-ai/DeepSeek-V4-Flash-0731", "name": "DeepSeek V4 Flash", "maxTokens": 32768 }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "gonka/moonshotai/Kimi-K2.6" }
    }
  }
}

A chave não é gravada no arquivo: apiKey refere-se à variável ${GONKA_API_KEY} (o OpenClaw resolve apenas a forma ${...}). O nome é único — não conflita com OPENAI_* de outras ferramentas. Passe a chave para o ambiente:

export GONKA_API_KEY=jg-sua-chave

Tool calling: O Kimi K2.6 suporta tool calling nativo — critico para frameworks de agentes. O agente pode chamar buscas, leitura de arquivos, execução de código e outras ferramentas através da API padrão de OpenAI function calling.

Verificação: inicie um agente simples com a tarefa «escreva hello world em Python e explique o código». Se o agente completou a tarefa, a configuração foi bem-sucedida.

Economia de agentes autônomos

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

CenárioTokens por tarefaOpenAI GPT-5.5JoinGonka Kimi K2.6Economia
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 não são economicamente viáveis para a maioria das tarefas. Com os preços da Gonka, um agente pode trabalhar 24/7 por $48 ao mês. Isso muda o modelo: os agentes deixam de ser um «brinquedo caro» e tornam-se uma ferramenta de trabalho.

Para empresas: se o seu produto utiliza agentes de IA (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 Kimi K2.6 é de 200K tokens. 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 do modelo é de até 8192 tokens (para todos os modelos da rede), o que é suficiente para um ciclo típico de agente (instrução + chamada de ferramenta).

OpenClaw + Gonka = agentes de IA autônomos por $24/mês em vez dos $12,500+ da OpenAI. A economia de ×350 torna os agentes lucrativos até para desenvolvedores indie. O tool calling nativo do Kimi K2.6 garante compatibilidade total.
← Claude Code + Gonka AI — LLM para terminal OpenCode: seu próprio modelo no terminal →

Quer saber mais?

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

Obter tokens gratuitos →