Imagine um assistente de IA que não fica parado esperando por comandos. Ao contrário, ele envia lembretes antes que você esqueça, gerencia sua caixa de entrada e faz o check-in automático para seus voos. Esse é o OpenClaw (antigo Clawdbot), um projeto de código aberto que conquistou mais de 107 mil estrelas no GitHub.
O problema? Configurar um agente de IA auto-hospedado geralmente significa lidar com servidores, dependências e arquivos de configuração. É aí que entra a Novita Sandbox. Com modelos pré-configurados e ambientes isolados, você pode colocar o OpenClaw para funcionar em minutos, em vez de horas.
Este guia aborda tudo, desde a configuração inicial até a implantação, seja você automatizando fluxos de trabalho, mantendo seus dados privados ou apenas curioso sobre o que os agentes de IA podem fazer.
O que é o OpenClaw?
OpenClaw é um assistente de IA de código aberto que roda no seu próprio hardware e realmente toma iniciativa. Ele se conecta ao WhatsApp, Telegram, Discord, Signal e Slack, permitindo que ele:
- Enviar lembretes inteligentes
- Gerenciar tarefas de e-mail e calendário
- Controlar dispositivos de casa inteligente
- Reservar voos e fazer check-in automaticamente
- Executar scripts personalizados
- Entender conteúdo de vídeo
- Iniciar conversas em diferentes plataformas
Como ele roda no seu Mac Mini, VPS ou na Sandbox da Novita, você tem controle total sobre seus dados.
Instalar o SDK/CLI da Novita
# Install Novita SDK
pip install novita-sandbox
# Install Novita CLI
npm i -g novita-sandbox-cli
Lançar a Sandbox
CLI
# Log in
novita-sandbox-cli auth login
# Create a sandbox using the clawdbot template
# Note: The sandbox will be destroyed upon exit
novita-sandbox-cli sandbox create clawdbot
SDK (Recomendado)
Obter a CHAVE DE API
Faça login no Console da Novita, clique no seu avatar para acessar as Chaves de API.
Clique para criar uma Chave de API e copie-a
Criar a Sandbox
Um script SDK simples sandbox_novita.py para as demonstrações seguintes.
#!/usr/bin/env python3
"""
Novita Sandbox SDK Simple Example
Usage:
python sandbox_demo.py create [--template base] [--timeout 300]
python sandbox_demo.py list
python sandbox_demo.py set-timeout <SANDBOX_ID> <SECONDS>
python sandbox_demo.py get-url <SANDBOX_ID> <PORT>
Environment Variables:
NOVITA_API_KEY=sk_xxx
NOVITA_DOMAIN=sandbox.novita.ai
"""
import os
import sys
from dotenv import load_dotenv
load_dotenv()
from novita_sandbox.core import Sandbox
API_KEY = os.getenv("NOVITA_API_KEY", "")
DOMAIN = os.getenv("NOVITA_DOMAIN", "sandbox.novita.ai")
def check_config():
if not API_KEY:
print("Error: NOVITA_API_KEY not set")
sys.exit(1)
def cmd_create(args):
"""Create sandbox"""
check_config()
template = "base"
timeout = 300
i = 0
while i < len(args):
if args[i] == "--template" and i + 1 < len(args):
template = args[i + 1]
i += 2
elif args[i] == "--timeout" and i + 1 < len(args):
timeout = int(args[i + 1])
i += 2
else:
i += 1
sandbox = Sandbox.create(
template=template,
timeout=timeout,
api_key=API_KEY,
domain=DOMAIN,
)
print(f"Created: {sandbox.sandbox_id}")
def cmd_list():
"""List sandboxes"""
check_config()
paginator = Sandbox.list(api_key=API_KEY, domain=DOMAIN)
sandboxes = []
while paginator.has_next:
sandboxes.extend(paginator.next_items())
if not sandboxes:
print("(no sandboxes)")
return
for sbx in sandboxes:
print(f"{sbx.sandbox_id} | {sbx.template_id} | {sbx.started_at} | {sbx.end_at}")
def cmd_set_timeout(sandbox_id, seconds):
"""Set timeout"""
check_config()
Sandbox.set_timeout(sandbox_id, int(seconds), api_key=API_KEY, domain=DOMAIN)
print(f"Set {sandbox_id} timeout to {seconds}s")
def cmd_get_url(sandbox_id, port):
"""Get URL"""
check_config()
sandbox = Sandbox.connect(sandbox_id, api_key=API_KEY, domain=DOMAIN)
host = sandbox.get_host(int(port))
print(f"https://{host}")
def print_help():
print(__doc__)
def main():
if len(sys.argv) < 2:
print_help()
return
cmd = sys.argv[1]
args = sys.argv[2:]
if cmd == "create":
cmd_create(args)
elif cmd == "list":
cmd_list()
elif cmd == "set-timeout":
if len(args) < 2:
print("Usage: set-timeout <SANDBOX_ID> <SECONDS>")
sys.exit(1)
cmd_set_timeout(args[0], args[1])
elif cmd == "get-url":
if len(args) < 2:
print("Usage: get-url <SANDBOX_ID> <PORT>")
sys.exit(1)
cmd_get_url(args[0], args[1])
else:
print_help()
if __name__ == "__main__":
main()
# NOVITA_API_KEY: Fill in your own API Key
# template: Specify clawdbot
# timeout: Sandbox lifecycle in seconds (s). Note: Max 3600, contact us for an extension
NOVITA_API_KEY=sk_xxx python3 sandbox_novita.py create --template clawdbot --timeout 300
Salve o ID da sandbox retornado; ele será usado para fazer login na sandbox.
Iniciar o Clawdbolt
Fazer login na sandbox
Faça login na sandbox com novita-sandbox-cli.
novita-sandbox-cli sandbox connect <sandbox_id>
Inicializar o Clawdbolt
Inicialize o Clawdbot com o comando abaixo:
clawdbolt onboard
Depois de executar o clawdbot onboard, complete a configuração subsequente usando o teclado.
Operações principais: use as teclas de seta para navegar pelas opções, pressione Enter para selecionar e confirmar.
1. Concordar com os Riscos
Os riscos serão indicados aqui — afinal, é comum que a IA exclua arquivos acidentalmente. Mas fique tranquilo: nossa Sandbox oferece isolamento seguro :)
Selecione Yes.
2. Selecionar o Modo de Integração
Selecione QuickStart。
3. Configurar o Modelo
Você será solicitado a selecionar o provedor de modelo e o modelo padrão a ser usado, além de preencher sua Chave de API.
4. Configurar o Canal
Você será solicitado a configurar o método de interação do Clawdbot, como Bot do Telegram, WhatsApp, Bot do Discord, etc.
Aqui eu seleciono o Telegram.
5. Obter o Token do Bot do Telegram
Depois de selecionar o Telegram, insira o token do bot (instruções de obtenção fornecidas).
1、Procure por @BotFather no Telegram
2、 Digite /newbot para criar um novo bot
6. Habilidades e Hooks
Pule isso por enquanto.
Observação: use a barra de espaço para selecionar e Enter para confirmar.
Iniciar o Clawdbot
Execute o comando abaixo para iniciar o Clawdbot.
clawdbot gateway run --port 18789
Parear e usar o Bot do Telegram
O bot do Telegram solicitará o pareamento; use o Código de pareamento destacado para concluí-lo.
Abra outro terminal e faça login na sandbox:
novita-sandbox-cli sandbox connect <sandbox_id>
Pareie o bot do Telegram:
clawdbot pairing approve telegram <Pairing code>
Depois de pareado com sucesso, você já pode começar a usá-lo oficialmente.
Testar a Demonstração
Eu pedi para ele criar uma página web artística com um prompt e implantá-la publicamente na sandbox.
- Converse diretamente com o bot para implantar o site.
- Acessar o site
Obtenha o link de acesso com o script SDK, basta passar o ID da sandbox e a porta.
NOVITA_API_KEY=sk_xxx python3 sandbox_novita.py get-url <sandbox_id> <port>
Em seguida, insira o link de acesso que você acabou de obter no navegador:
Conclusão
A Sandbox da Novita elimina os problemas comuns de implantação. Você obtém uma instância funcional do OpenClaw sem precisar mexer em configurações de servidor ou se preocupar com riscos de segurança. O bot pode lidar com tudo, desde lembretes básicos até a criação de aplicações web, tudo isso mantendo seus dados sob seu controle.
Quer experimentar? Acesse a Novita AI e coloque sua instância para funcionar.
A 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
