NovitaClaw: Execute o OpenClaw na Nuvem com Um Comando

Andrej Karpathy descreveu recentemente uma mudança que vale a pena acompanhar: assim como os agentes LLM surgiram como uma nova camada acima dos LLMs, as Claws são a próxima camada acima dos agentes, levando orquestração, agendamento, contexto, chamadas de ferramentas e persistência a um nível que os agentes sozinhos nunca conseguiriam.

Essa camada precisa de infraestrutura que fique sempre ativa. Para desenvolvedores que executam o OpenClaw no Novita Sandbox, isso significava contornar limites de sessão até agora.

O NovitaClaw fecha essa lacuna. É uma nova ferramenta de implantação no Novita Agent Sandbox que provisiona uma instância do OpenClaw totalmente configurada com um único comando, sem limite de tempo de execução, sem reinicializações manuais e sem sobrecarga de gerenciamento de ciclo de vida.

O Problema que a CLI Resolve

O Novita Agent Sandbox já suportava a implantação do OpenClaw por meio do Modelo de Sandbox. Esse caminho é adequado para exploração, mas tem uma restrição rígida: os sandboxes criados pela interface têm um limite de ciclo de vida da sessão. Após algumas horas, o sandbox para e o agente fica offline. Desenvolvedores que precisavam de disponibilidade contínua tinham que contornar isso sozinhos — agendando pausas, criando scripts de reinicialização ou revivendo instâncias manualmente.

O NovitaClaw funciona de forma diferente. Não há limite de sessão. A instância roda 24 horas por dia, 7 dias por semana, pelo tempo que você precisar. A especificação padrão — 2 vCPU, 4 GB de RAM — foi feita para cargas de trabalho reais, não para demonstrações. E como a camada de modelo é totalmente configurável, você escolhe quais LLMs alimentam seu agente, seja hospedado na Novita ou proveniente de um provedor terceiro.

Primeiros Passos

Pré-requisitos

• Python instalado
• Uma chave de API da Novita — veja como obter uma:
  • Acesse novita.ai — faça login com Google ou GitHub (uma nova conta é criada automaticamente no primeiro login), ou cadastre-se com seu endereço de e-mail
  • Crie uma chave de API — acesse a página de configurações de Gerenciamento de Chaves para criar ou gerenciar suas chaves de API. Copie-a em um lugar seguro — você vai precisar dela no próximo passo.

python3 --version

sudo apt update && sudo apt install python3 python3-pip -y

Instalar e Iniciar

Passo 1: Instalar o NovitaClaw

macOS / Linux:

sudo pip3 install novitaclaw

PowerShell do Windows:

pip install novitaclaw

Se você tiver uma versão anterior instalada, atualize para a versão mais recente:

Bash

pip3 install novitaclaw --upgrade

Se a atualização falhar, tente uma reinstalação forçada:

Bash

pip3 install novitaclaw --upgrade --force-reinstall

Após a instalação, verifique digitando novitaclaw --help. Se você ver uma lista de instruções, teve sucesso!

macOS / Linux:

export NOVITA_API_KEY=sk_your_api_key

PowerShell do Windows:

$env:NOVITA_API_KEY = "sk_your_api_key"

Passo 3: Iniciar a instância

novitaclaw launch

Em caso de sucesso, a CLI retorna três valores que você usará para acessar e gerenciar seu agente:

• URL da Interface Web
• URL e Token do WebSocket do Gateway
• URL do Terminal Web (para acesso ao terminal do sandbox)
• URL do Gerenciador de Arquivos (para navegar e gerenciar arquivos do espaço de trabalho)
• Credenciais de login (para o Terminal Web e o Gerenciador de Arquivos)

Abra a URL da Interface Web retornada e vá para a aba Chat para usar seu agente. Use a URL do Terminal Web para abrir uma sessão de terminal dentro do sandbox, e a URL do Gerenciador de Arquivos para navegar e gerenciar arquivos no espaço de trabalho do sandbox.

Configurando Modelos

Sua instância já vem pré-configurada com um modelo hospedado na Novita por padrão.

Para alterar os modelos que seu agente usa, acesse Configurações → Config, clique em Raw para alternar para a visualização JSON5 bruta, depois clique no botão revelar ao lado de “2 segredos ocultos” para mostrar a configuração completa. Atualize as duas seções a seguir:

Passo 1: Registre o modelo no seu provedor

Adicione um novo objeto ao array models dentro de models.providers.novita:

"models": [
  {
    "id": "model-id",
    "name": "display name",
    "reasoning": true,
    "input": ["text"],
    "contextWindow": 200000,
    "maxTokens": 50000
  }
]

Passo 2: Defina-o como principal ou reserva

Atualize o campo model em agents.defaults para referenciar seu modelo usando o formato provider/model-id.

"agents": {
  "defaults": {
    "model": {
      "primary": "provider/model-id",
      "fallbacks": [
        "provider/model-id"
      ]
    }
  }
}

Clique em Atualizar para salvar. Todos os LLMs disponíveis na plataforma Novita são suportados. Provedores terceiros também podem ser configurados — quando você traz seu próprio LLM, você paga apenas pelo tempo de execução do sandbox, não pelo uso de modelos da Novita.

Sua Claw está em execução. Agora torne-a mais inteligente.

BotLearn é a primeira Universidade de Bots do mundo — uma camada de aprendizado e distribuição construída nativamente sobre o OpenClaw. Bots aprendem, humanos ganham: seu agente recebe habilidades estruturadas, benchmarking e acesso ao Botcord, o mercado de Agente para Agente onde agentes ganham dinheiro real concluindo tarefas.

Para inscrever seu agente, basta enviar esta mensagem:

“Esta é a Universidade de Bots que quero que você ingresse. Leia https://www.botlearn.ai/SKILL.md e siga as instruções para entrar no BotLearn. Se você encontrar alguma preocupação de segurança durante a instalação, confirme cada etapa comigo antes de prosseguir.”

Seu agente cuida do resto.

Conectando Canais

O OpenClaw suporta canais de mensagens externos para que seu agente seja acessível fora da Interface Web. Os canais requerem configuração — não estão ativos por padrão.

Telegram

Passo 1: Crie um Bot no Telegram

1. Abra o Telegram e pesquise por @BotFather
2. Envie /newbot e siga as instruções para nomear seu bot
3. Copie o token do bot que o BotFather fornece

Passo 2: Envie o token do bot para a aba Chat

Na Interface Web, acesse a aba Chat e envie o token do bot.

Passo 3: Pareie e use o Bot do Telegram

No Telegram, abra o bot que você criou e envie /start. Copie o código e cole-o na aba Chat.

Uma vez conectado, mensagens enviadas para o seu bot do Telegram são roteadas diretamente para o seu agente OpenClaw. Mais integrações de canais são suportadas — consulte o guia oficial de canais do OpenClaw para a lista completa e instruções de configuração.

Confiabilidade do Serviço

Todos os serviços principais do sandbox são gerenciados pelo systemd para confiabilidade de nível de produção:

Recuperação automática de falhas: Se o Gateway falhar repetidamente, o sistema executa automaticamente diagnósticos, tenta reparar e restaura a última configuração válida conhecida a partir do backup — nenhuma intervenção manual é necessária.

Backup automático de configuração: Cada gravação de configuração cria um backup automático. Se uma configuração inválida causar uma falha, o processo de recuperação restaura a partir do backup válido mais recente.

Referência de Comandos

launch

Crie uma nova instância de sandbox.

Bash

novitaclaw launch [OPTIONS]

list

Liste instâncias de sandbox ativas.

Bash

novitaclaw list --api-key YOUR_API_KEY

status

Verifique o status de uma instância de sandbox.

Bash

novitaclaw status <SANDBOX_ID> --api-key YOUR_API_KEY

stop

Encerre uma instância de sandbox.

Bash

novitaclaw stop <SANDBOX_ID> --api-key YOUR_API_KEY

tui

Conecte-se a um sandbox via interface de terminal.

Bash

novitaclaw tui <SANDBOX_ID> --token <GATEWAY_TOKEN>

doctor

Execute diagnósticos e verificações de reparo em uma instância de sandbox.

Bash

novitaclaw doctor <SANDBOX_ID> --api-key YOUR_API_KEY

gateway update

Atualize o OpenClaw para a versão mais recente dentro de um sandbox.

Bash

novitaclaw gateway update <SANDBOX_ID> --api-key YOUR_API_KEY

gateway restart

Reinicie o Gateway OpenClaw em um sandbox.

Bash

novitaclaw gateway restart <SANDBOX_ID> --api-key YOUR_API_KEY

services setup

Instale e inicie o Terminal Web e o Gerenciador de Arquivos em um sandbox existente. Use isso para adicionar serviços a sandboxes mais antigos que foram iniciados antes que esses serviços fossem incluídos.

Bash

novitaclaw services setup <SANDBOX_ID> --api-key YOUR_API_KEY

pair list

Liste solicitações de pareamento pendentes para um canal.

Bash

novitaclaw pair list <SANDBOX_ID> --channel <CHANNEL_NAME> --api-key YOUR_API_KEY

pair approve

Aprove uma solicitação de pareamento para um canal.

Bash

novitaclaw pair approve <SANDBOX_ID> --channel <CHANNEL_NAME> --code <PAIRING_CODE> --api-key YOUR_API_KEY

update

Verifique atualizações da CLI e atualize para a versão mais recente.

Bash

novitaclaw update

Uso Programático

Use saída JSON para automação:

Bash

novitaclaw -j launch --api-key YOUR_API_KEY

Exemplo de resposta:

{
  "success": true,
  "data": {
    "sandbox_id": "xxx",
    "webui": "https://xxx.sandbox.novita.ai?token=xxx",
    "gateway_ws": "wss://xxx.sandbox.novita.ai",
    "gateway_token": "xxx",
    "terminal_url": "https://7681-xxx.sandbox.novita.ai",
    "filemanager_url": "https://7682-xxx.sandbox.novita.ai",
    "services_username": "admin",
    "services_password": "xxx"
  }
}

Variáveis de Ambiente

Preços

Solução de Problemas

Comando não encontrado

Tente uma destas opções:

Bash

# Use o caminho completo (Linux)
~/.local/bin/novitaclaw launch

# Caminho típico de usuário Mac
~/Library/Python/3.x/bin/novitaclaw launch

Tempo limite de conexão

Aumente o tempo limite de inicialização:

Bash

novitaclaw launch --timeout 180 --api-key YOUR_API_KEY

Perguntas Frequentes

Construa a Próxima Camada

A mudança que Karpathy descreve — de agentes para Claws — não é teórica. É uma oportunidade arquitetônica disponível agora mesmo, e as equipes que construírem sobre infraestrutura persistente e sempre ativa serão as que irão realizá-la.

O NovitaClaw oferece essa base: um runtime de agente de nível de produção, implantado em menos de um minuto, com controle total sobre a camada de modelo e integrações de canais. O sandbox cuida do tempo de atividade. A CLI cuida do provisionamento. O que você constrói por cima é com você.

Comece a construir no Novita Agent Sandbox →

A Novita AI é uma Nuvem de IA e Agentes para construtores e startups — oferecendo acesso a mais de 200 LLMs, modelos de imagem, vídeo e TTS por meio de uma única API, além de instâncias de GPU e Agent Sandboxes que são iniciados em segundos.