> ## Documentation Index > Fetch the complete documentation index at: https://novita.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # NovitaClaw Implante um agente OpenClaw persistente no [Novita Agent Sandbox](https://novita.ai/sandbox) com um comando e, em seguida, gerencie-o pela CLI, Web UI ou scripts de automação. Sem limite de sessão — sua instância roda 24/7 pelo tempo que você precisar. ## Novidades na v1.6.0 * **Exportação / Importação de Configuração do Gateway** — Faça backup, restaure e migre sua configuração do OpenClaw entre sandboxes. Exporte para stdout ou para arquivo, importe com validação JSON automática e reinicialização do Gateway. Compatível com fluxos de migração entre sandboxes. ```bash Bash icon="terminal" theme={"system"} # Export config novitaclaw gateway config export -o config.json # Import into another sandbox novitaclaw gateway config import config.json ``` * **Instalação de Skills do ClawHub** — Instale skills de extensão do OpenClaw a partir do ClawHub diretamente em um sandbox. As skills ficam disponíveis imediatamente, sem necessidade de reiniciar o Gateway. ```bash Bash icon="terminal" theme={"system"} novitaclaw skill install sonoscli ``` ### Versões anteriores * **Canal Telegram (CLI)** — Modos Polling e Webhook para conectar seu agente ao Telegram. [Guia de configuração](/docs/pt-BR/guides/novitaclaw-configuration#telegram) * **Canal Slack** — Modos Socket e HTTP para conectar seu agente ao Slack. [Guia de configuração](/docs/pt-BR/guides/novitaclaw-configuration#slack) * **Melhorias no script de instalação** — O diretório de instalação foi alterado para `~/.novitaclaw-cli`, comando `update` aprimorado com suporte a PEP 668 e recuperação de symlink * **Modo sob demanda** — O sandbox pausa automaticamente após ficar ocioso e retoma ao ser acessado. Sem cobrança enquanto estiver pausado. [Saiba mais](/docs/pt-BR/guides/novitaclaw-configuration#on-demand-mode) * **Canal Feishu** — Conecte seu agente ao Feishu (Lark) via modo Webhook ou Event. [Guia de configuração](/docs/pt-BR/guides/novitaclaw-configuration#feishu) * **Web Terminal** — Acesso ao terminal do sandbox pelo navegador, sem necessidade de SSH * **File Manager** — Explore e gerencie arquivos do workspace diretamente pelo navegador * **Gerenciamento de serviços systemd** — Gateway, Web Terminal e File Manager são totalmente gerenciados pelo systemd, com reinicialização automática em caso de falha * **Recuperação automática de falhas** — Diagnósticos, reparos e restauração de serviços automáticos em caso de falhas repetidas * **Backup automático de configuração** — Cada gravação de configuração cria um backup automático; a recuperação de falhas restaura a partir do backup válido mais recente Para usar os novos recursos, atualize sua CLI: ```bash macOS / Linux theme={"system"} curl -fsSL https://novitaclaw.novita.ai/install.sh | bash ``` ```bash Windows (PowerShell) theme={"system"} irm https://novitaclaw.novita.ai/install.ps1 | iex ``` ## Primeiros passos ### Pré-requisitos * Python instalado * Uma chave de API da Novita (crie/manage chaves em [Key Management](https://novita.ai/docs/guides/quickstart#2-manage-api-key)) **Windows** [Baixe o instalador do Python](https://www.python.org/downloads/) e execute-o. **Marque "Add Python to PATH"** antes de clicar em Install Now — ignorar isso é o motivo mais comum para iniciantes encontrarem erros depois. **macOS** Abra o Terminal e execute: ```bash Bash icon="terminal" theme={"system"} python3 --version ``` Se você vir Python 3.10 ou superior, está tudo certo. Se o Terminal solicitar a instalação das Command Line Developer Tools, clique em Install e aguarde alguns minutos. **Linux (Ubuntu / Debian)** ```bash Bash icon="terminal" theme={"system"} sudo apt update && sudo apt install python3 python3-pip -y ``` ### Etapa 1: Instale o NovitaClaw ```bash macOS / Linux theme={"system"} sudo pip3 install novitaclaw ``` ```bash Windows PowerShell theme={"system"} pip install novitaclaw ``` Após a instalação, verifique executando `novitaclaw --help`. Se você vir uma lista de comandos, está tudo pronto. **Usuários de Mac:** Se você receber `zsh: command not found: novitaclaw` após a instalação, execute: ```bash Bash icon="terminal" theme={"system"} echo 'export PATH="'$(python3 -m site --user-base)'/bin:$PATH"' >> ~/.zshrc source ~/.zshrc ``` ### Etapa 2: Defina sua chave de API ```bash macOS / Linux theme={"system"} export NOVITA_API_KEY=sk_your_api_key ``` ```powershell Windows PowerShell theme={"system"} $env:NOVITA_API_KEY = "sk_your_api_key" ``` ### Etapa 3: Inicie sua instância ```bash Bash icon="terminal" theme={"system"} novitaclaw launch ``` Em caso de sucesso, a CLI retorna: * **URL da Web UI** — Converse com seu agente * **URL e token do WebSocket do Gateway** — Para acesso programático * **URL do Web Terminal** — Acesso ao terminal do sandbox no seu navegador * **URL do File Manager** — Explore e gerencie arquivos do workspace * **Credenciais de login** — Nome de usuário e senha para o Web Terminal e o File Manager Resultado do lançamento do NovitaClaw Abra a **URL da Web UI** retornada e acesse a aba `Chat` para começar a usar seu agente. ### Web Terminal O Web Terminal fornece acesso ao terminal do seu ambiente de sandbox pelo navegador. Abra a **URL do Web Terminal** retornada pelo comando de inicialização e faça login com as credenciais fornecidas. Isso oferece uma sessão shell completa — instale pacotes, inspecione logs ou depure seu agente diretamente. ### File Manager O File Manager permite explorar, enviar, baixar e gerenciar arquivos no workspace do sandbox por meio de uma interface web. Abra a **URL do File Manager** e faça login com as mesmas credenciais. Use-o para visualizar arquivos do workspace do agente, editar configurações ou transferir arquivos sem precisar de acesso pela CLI. Para sandboxes existentes iniciados antes de esses serviços estarem disponíveis, você pode adicioná-los retroativamente: ```bash Bash icon="terminal" theme={"system"} novitaclaw services setup --api-key YOUR_API_KEY ``` ## Preços | O que você usa | O que você paga | | --------------------------- | --------------------------------------------------------- | | Runtime do sandbox | [Tarifas do sandbox](https://novita.ai/pricing?sandbox=1) | | LLMs hospedados pela Novita | [Tarifas dos modelos](https://novita.ai/pricing) | | LLMs de terceiros | Apenas runtime do sandbox |