Como usar o GLM-5 no OpenClaw (Clawdbolt): Crie um Agente de IA para Telegram em Minutos

O OpenClaw ajuda você a conectar um agente de IA aos aplicativos de chat que você já usa (Telegram/Discord/WhatsApp/iMessage etc.) por meio de um processo de gateway que roteia conversas para o provedor de modelo escolhido.

Neste tutorial, você executará o GLM-5 dentro do OpenClaw usando a API da Novita AI — para que você possa criar uma demonstração funcional no estilo Telegram rapidamente, depois escalar o uso sem alterar sua superfície de integração.

Se você ainda não tiver uma, crie sua chave de API da Novita no console da Novita, e abra a página do modelo GLM-5 para confirmar o ID do modelo (zai-org/glm-5) e o formato do endpoint.

Experimente o GLM-5 Agora!

O que é o OpenClaw

O OpenClaw é uma estrutura de agente de IA de código aberto que permite que desenvolvedores conectem rapidamente modelos de linguagem grandes (LLMs) a canais de comunicação do mundo real, como o Telegram. Em vez de ser um modelo em si, o OpenClaw atua como uma camada de orquestração que roteia mensagens de usuários para um LLM selecionado, gerencia configurações e lida com a implantação por meio de um fluxo de trabalho CLI simples. Ao remover a necessidade de construir infraestrutura de backend do zero, ele permite que desenvolvedores transformem modelos poderosos em agentes de IA prontos para produção em questão de minutos.

Por que escolher o GLM-5 para o OpenClaw

O OpenClaw funciona melhor com um modelo que pode concluir tarefas de múltiplas etapas, escrever código de integração real e usar ferramentas de forma confiável dentro de sessões de chat longas. O GLM-5 foi desenvolvido para Engenharia Agêntica — e seu histórico em benchmarks reflete isso.

• Força de codificação comprovada em avaliações padrão da indústria
  O GLM-5 relata resultados de código aberto no estado da arte em benchmarks de engenharia de software e codificação baseada em terminal amplamente utilizados, alinhando-se bem com configurações do OpenClaw onde o agente frequentemente edita configurações, depura problemas ou gera “código cola” para ferramentas.
• Alto desempenho de agente/ferramenta em benchmarks de múltiplas etapas
  Ele também lidera os rankings de código aberto em avaliações voltadas para agentes que enfatizam chamada de ferramentas, planejamento e execução em várias etapas — exatamente o modo de falha que você quer evitar ao rotear conversas reais por um gateway de agente.
• Confiabilidade em sessões longas
  A capacidade de longo horizonte do GLM-5 é suportada por afirmações de benchmarks que medem o desempenho operacional de longo prazo, o que se alinha diretamente a agentes de aplicativos de chat que devem manter o foco em threads extensas e respostas intermitentes de usuários.

Na Novita AI, o GLM-5 é oferecido com preços baseados em uso simples: US$ 1 por 1M de tokens de entrada e US$ 3,2 por 1M de tokens de saída. Se você ativar o cache de contexto, a leitura de cache custa US$ 0,2 por 1M de tokens, o que pode reduzir custos para prompts repetidos e sessões de agente de longa duração.

Como instalar o OpenClaw

Lista de verificação de hardware/ambiente

Antes de começar, prepare:

• Node.js 22+
• Uma máquina que possa acessar a internet (usuários do Windows costumam usar o WSL2)
• Opção de implantação: O OpenClaw pode ser executado em uma máquina local ou em uma VM na nuvem/contêiner, dependendo de como você quer expor o gateway e gerenciar as operações.

Instalar o OpenClaw

Siga o mesmo padrão de instalação do guia de referência:

• macOS / Linux / WSL2

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

• Windows (PowerShell)

iwr -useb https://openclaw.ai/install.ps1 | iex

Usar o GLM-5 no OpenClaw

Passo 1: Obtenha sua chave de API da Novita

Na Novita, crie uma chave de API (ela geralmente é exibida apenas uma vez — armazene-a imediatamente). O fluxo de referência é:

1. Acesse [https://novita.ai](https://novita.ai/?utm_source=blogs&utm_medium=article&utm_campaign=use-kimi-k2-5-in-openclaw), crie/faça login na sua conta da Novita
2. Vá para Chaves de API
3. Clique em Adicionar nova chave
4. Copie e salve-a imediatamente

Crie sua conta e obtenha a chave de API

Passo 2: Execute a configuração do OpenClaw

Inicie o fluxo de configuração:

openclaw config

1. Espaço de trabalho

2. Modelo

Escolha Entrada manual, depois defina o modelo padrão novita/zai-org/glm-5:

O formato novita/zai-org/glm-5 espelha o formato “novita/<id-do-modelo>” usado no tutorial de referência, onde novita é o prefixo do provedor e a parte restante é o ID do modelo que você vê na Novita.

Você pode encontrar IDs de modelo disponíveis no site da Novita, e substituir o ID do modelo por qualquer outro modelo suportado (mantenha o prefixo de provedor novita/).

3. Gateway

Mantenha os padrões para a primeira execução, basta pressionar Enter para continuar

4. Canais

• Selecione Configurar/vincular
• Escolha um canal: Telegram (API de Bot) e insira o Token do Bot do Telegram (siga o guia abaixo para obtê-lo no @BotFather)
• Insira Concluído
• Configure as políticas de acesso a mensagens diretas agora e escolha Emparelhamento

💡Como obter o Token do Bot do Telegram?

Pesquise por @BotFather no Telegram e insira /newbot para criar um novo bot; quando terminar de criar o novo bot, você receberá o token do bot.

5. Continuar (Concluído)

Passo 3: Aplique a configuração do provedor Novita (GLM-5)

O OpenClaw pode se integrar à Novita por meio de um endpoint compatível com o OpenAI. Vamos adicionar a Novita como um provedor no seu arquivo de configuração do OpenClaw.

Caminho da configuração: ~/.openclaw/openclaw.json

# Abra o arquivo:
open ~/.openclaw/openclaw.json

Agora cole o bloco de configuração abaixo no seu arquivo de configuração. Atualize apenas um campo: <Sua chave de API> → sua chave de API da Novita

"models": {
  "providers": {
    "novita": {
      "baseUrl": "https://api.novita.ai/openai/v1",
      "apiKey": "<Your API Key>",
      "api": "openai-completions",
      "models": [
        {
          "id": "zai-org/glm-5",
          "name": "GLM-5 (Novita)",
          "reasoning": false,
          "input": [
            "text"
          ],
          "cost": {
            "input": 0,
            "output": 0,
            "cacheRead": 0,
            "cacheWrite": 0
          },
          "contextWindow": 200000,
          "maxTokens": 8192
        }
      ]
    }
  }
},

Observações:

• Os campos reasoning, cost, contextWindow e maxTokens são opcionais; o OpenClaw também documenta os valores padrão se você omiti-los.
• O ID do modelo para o GLM-5 na Novita é zai-org/glm-5, você também pode alterar o modelo que desejar.

Passo 4: Inicie o Gateway

Instale e reinicie o gateway do OpenClaw:

openclaw gateway install

openclaw gateway restart

Passo 5: Emparelhe o Telegram

No Telegram, abra o bot que você criou e envie /start. O bot fornecerá um código de emparelhamento, depois aprove-o em um novo terminal:

openclaw pairing approve --channel telegram <your-pairing-code>

Passo 6: Verificação rápida no Telegram (10 segundos)

No Telegram, envie /model para confirmar o modelo ativo

Conclusão

O OpenClaw oferece um gateway prático para colocar um agente onde os usuários já trabalham (aplicativos de chat), enquanto o GLM-5 traz um raciocínio agêntico forte, chamada de ferramentas e suporte a contexto longo para fluxos de trabalho de múltiplas etapas.

Usando a API da Novita AI, você pode integrar o GLM-5 com um código cola mínimo e escalar o uso conforme sua demonstração se torna uma carga de trabalho de produção.

Novita AI é uma plataforma de nuvem de IA líder que fornece a desenvolvedores APIs fáceis de usar e infraestrutura de GPU acessível e confiável para construir e escalar aplicações de IA.

Perguntas Frequentes

O que o OpenClaw faz? O OpenClaw executa um processo de Gateway de longa duração que conecta os aplicativos de chat que você já usa (Telegram, Discord, WhatsApp, iMessage etc.) a um assistente sempre ativo. O Gateway atua como o plano de controle — gerenciando canais, sessões e roteamento — para que as mensagens do seu aplicativo de chat possam ser entregues ao contexto e ferramentas de agente corretos.

O OpenClaw é um agente de IA? O próprio OpenClaw não é o modelo — é o runtime de agente + gateway que hospeda e roteia sessões de agente. A “inteligência” vem do(s) modelo(s) que você configura; o OpenClaw fornece a infraestrutura para fazer com que esse modelo se comporte como um agente em canais de mensagens, ferramentas e sessões.

O Clawdbot é gratuito? Sim — o Clawdbot se refere ao nome anterior do OpenClaw, e o software é gratuito e de código aberto sob a licença MIT. Seus custos reais vêm do que você conecta a ele (uso de modelo/API, hospedagem e quaisquer ferramentas/serviços pagos que você ativar).

Leituras Recomendadas

• Hospede o Clawdbot (OpenClaw) com o Modelo de Sandbox da Novita: Guia Completo
• Use o Kimi K2.5 no OpenClaw (Clawdbot): Configuração rápida para agentes de Telegram com Novita