Use Kimi K2.5 no OpenClaw (Clawdbot): Configuração Rápida para Agentes do Telegram com a Novita

Use Kimi K2.5 no OpenClaw (Clawdbot): Configuração Rápida para Agentes do Telegram com a Novita

OpenClaw é uma plataforma de agentes com foco local que se conecta aos aplicativos de chat que você já usa — para que seu assistente possa trabalhar de verdade, não apenas responder perguntas. Ele é executado na sua própria máquina, pode chamar ferramentas e fica próximo aos seus arquivos e fluxos de trabalho, o que o torna ideal para criar automações no estilo de “funcionário digital”.

Neste guia, mostraremos como executar o Kimi K2.5 dentro do OpenClaw usando a API da Novita, para que você possa ir da instalação a uma demonstração funcional no Telegram rapidamente.

O que é o OpenClaw

O OpenClaw é uma plataforma de agentes open source que é executada localmente na sua máquina e se integra perfeitamente aos aplicativos de chat que você já usa. Seja WhatsApp, Telegram, Discord, Slack ou Microsoft Teams, seu assistente de IA está sempre onde você está.

  • Como funciona: um único gateway para seus aplicativos de chat

Em vez de ficar em uma aba do navegador, o OpenClaw é executado como um processo de Gateway na sua máquina (ou em um servidor) e permite que você converse com seu agente a partir de aplicativos que você já usa — WhatsApp, Telegram, Discord, iMessage e outros —, roteando cada conversa para o agente/sessão correto.

  • O que ele pode fazer na sua máquina

Como está conectado ao seu ambiente, o OpenClaw pode executar fluxos de trabalho reais, como executar comandos, manipular arquivos, controlar navegadores e interagir com ferramentas — ficando mais próximo de um “funcionário digital” do que um chatbot tradicional.

  • Habilidades e o ecossistema

O OpenClaw suporta um sistema de Habilidades (local e embutido), além de um registro público chamado ClawHub para descobrir e sincronizar Habilidades. Isso facilita a extensão do OpenClaw para tarefas específicas — pesquisa, operações, programação e muito mais.

Por que o Kimi K2.5?

O Kimi K2.5 é uma combinação perfeita para agentes do OpenClaw porque combina multimodalidade nativa, execução real de ferramentas e capacidades agentivas em um único modelo aberto. Treinado em ~15T tokens mistos de visão e texto, ele pode transitar fluentemente entre navegação, coleta de evidências, geração de código e compreensão visual — exatamente o que agentes de longo horizonte precisam.

Benchmark do Kimi K2.5

  • Benchmarks de agentes mais fortes para fluxos de trabalho de longo horizonte: Lidera os principais conjuntos de testes de agentes com HLE-Full 50,2, BrowseComp 74,9, DeepSearchQA 77,1, superando o GPT-5.2 (65,8), o Claude 4.5 Opus (57,8) e o Gemini 3 Pro (59,2) no BrowseComp — útil para loops iterativos de busca e refinamento.
  • Programação em nível de repositório competitiva, com vantagem multilíngue: SWE-Bench Verified 76,8 e SWE-Bench Multilingual 73,0, mantendo-se forte em alterações de vários arquivos e repositórios com linguagens mistas.
  • Compreensão multimodal prática para trabalho de desenvolvimento: Resultados de imagem de primeira linha como MMMU Pro 78,5 e OmniDocBench 1.5 88,8 ajudam na leitura de documentos, diagramas e interfaces, além de raciocínio de vídeo sólido (VideoMMMU 86,6, LongVideoBench 79,8) para análise de demonstrações e gravações.

Na Novita, você pode usar o Kimi K2.5 por meio de uma API compatível com OpenAI, facilitando a integração com o OpenClaw com configuração mínima.

Como instalar o OpenClaw

Pré-requisitos

Antes de começar, certifique-se de ter:

  • Node 22+
  • Um terminal com acesso à internet (WSL2 é recomendado se você estiver no Windows)

Instalar o OpenClaw

  • macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash
  • Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex

Como usar o Kimi K2.5 no OpenClaw

Passo 1: Obtenha sua chave de API da Novita

Crie uma chave de API na Novita:

  1. Crie ou faça login na sua conta: Acesse [https://novita.ai](https://novita.ai) e cadastre-se ou faça login.
  2. Acesse o Gerenciamento de Chaves: Após fazer login, encontre “API Keys”.
  3. Crie uma Nova Chave: Clique no botão “Add New Key”.
  4. Salve sua chave imediatamente: Copie e armazene a chave assim que ela for gerada; ela é exibida apenas uma vez.

Obter chave de API

guia para criar sua própria chave de API

Passo 2: Execute o assistente de configuração do OpenClaw

Inicie o fluxo de configuração do OpenClaw:

openclaw config

No fluxo guiado, configure estas seções:

1. Espaço de trabalho

  • Escolha Local (esta máquina)

configuração do espaço de trabalho do openclaw: o gateway será executado localmente

2. Modelo

  • Modelo padrão: inserir manualmente
  • Definir como: novita/moonshotai/kimi-k2.5

configuração do modelo do openclaw

novita/moonshotai/kimi-k2.5 segue o formato:

novita = provedor (novita); moonshotai/kimi-k2.5 = ID do modelo

Você pode encontrar os 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/). Biblioteca de Modelos da Novita: você pode encontrar o Kimi K2.5

Você pode encontrar o ID do Modelo abaixo do Nome do Modelo

Explorar Biblioteca de Modelos

3. Gateway

Mantenha todas as configurações como padrão — basta pressionar Enter para continuar em cada prompt.

configuração do gateway do openclaw

4. Canais

  • Selecione Configurar/vincular
  • Escolha um canal: Telegram (Bot API) e insira o Token do Bot do Telegram
  • Insira Finished
  • Configure as políticas de acesso a DM agora e escolha Pairing

Como obter o Token do Bot do Telegram?

Procure por @BotFather no Telegram e insira /newbot para criar um novo bot

como encontrar o BotFather no Telegram

Como criar seu próprio bot no Telegram

5. Continue (concluir o assistente)

configuração de continuação do openclaw

Passo 3: Aplicar a configuração do provedor Novita

O OpenClaw se integra à Novita por meio de um endpoint compatível com OpenAI. Abra seu arquivo de configuração do OpenClaw:

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

open ~/.openclaw/openclaw.json

Cole o bloco de configuração abaixo no seu arquivo de configuração. Atualize apenas um campo: → sua chave de API da Novita

  "models": {
    "providers": {
      "novita": {
        "baseUrl": "https://api.novita.ai/openai/v1",
        "apiKey": "<your-api-key>", #set to your Novita API key
        "api": "openai-completions",
        "models": [
          {
            "id": "moonshotai/kimi-k2.5",
            "name": "Kimi K2.5 (Novita)",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },

Cole o bloco de configuração no seu arquivo de configuração

Passo 4: Inicie o gateway e emparelhe o Telegram

Instale e reinicie o gateway do OpenClaw:

openclaw gateway install
openclaw gateway restart

Quando o Telegram mostrar um código de emparelhamento, aprove-o em um novo terminal:

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

como obter o código de emparelhamento no Telegram para conectar o OpenClaw

O Telegram exibe um código de emparelhamento para o OpenClaw

Depois de aprovado, seu bot do Telegram está conectado ao agente do OpenClaw executado localmente, usando o Kimi K2.5 fornecido pela Novita.

Passo 5: Verificação rápida no Telegram

Faça uma verificação de sanidade de 10 segundos:

  1. No Telegram, execute:
  • /model (confirme que mostra o Kimi K2.5 como modelo atual)
  1. Envie uma mensagem simples:
  • hello (confirme que você recebe uma resposta normal)

teste se o Telegram está conectado com sucesso ao OpenClaw

Se ambos funcionarem, você está pronto para executar fluxos de trabalho reais (como redação de mensagens, assistentes de coleta de informações e automações de atendimento ao cliente) no Telegram — alimentados pela combinação Novita + Kimi K2.5 dentro do OpenClaw.

Conclusão

O OpenClaw torna os agentes práticos ao permitir que eles sejam executados localmente e ajam por meio dos aplicativos de chat que você já usa. Combinado com o Kimi K2.5 — forte em fluxos de trabalho de agentes e compreensão multimodal —, você pode criar assistentes que navegam, raciocinam e executam tarefas reais de ponta a ponta.

Com a API compatível com OpenAI da Novita, integrar o Kimi K2.5 ao OpenClaw é simples, para que você possa passar da configuração a uma demonstração funcional em minutos.

Novita AI é uma plataforma de nuvem de IA líder que fornece aos 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 é um assistente/agente de IA open source e auto-hospedado que conecta aplicativos de chat (por exemplo, WhatsApp, Telegram, Discord, iMessage) a agentes de IA e permite que eles realizem ações por meio de “habilidades” (extensões) instaladas.

É seguro usar o OpenClaw?

Pode ser seguro se você usá-lo com cuidado, mas não é “seguro por padrão”. Relatórios de segurança mostram que habilidades maliciosas apareceram em seu ecossistema público de habilidades, e as permissões amplas do agente podem amplificar o risco se você instalar habilidades não confiáveis.

O OpenClaw é o Moltbot?

Sim, o OpenClaw é o projeto rebatizado que era conhecido anteriormente como Moltbot (e anteriormente Clawdbot).

Leituras Recomendadas