> ## 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 Deploy a persistent OpenClaw agent on [Novita Agent Sandbox](https://novita.ai/sandbox) with one command, then manage it from CLI, Web UI, or automation scripts. No session cap — your instance runs 24/7 for as long as you need it. ## What's New in v1.6.0 * **Gateway Config Export / Import** — Back up, restore, and migrate your OpenClaw configuration across sandboxes. Export to stdout or file, import with automatic JSON validation and Gateway restart. Supports cross-sandbox migration workflows. ```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 ``` * **ClawHub Skill Install** — Install OpenClaw extension skills from ClawHub directly into a sandbox. Skills are available immediately with no Gateway restart required. ```bash Bash icon="terminal" theme={"system"} novitaclaw skill install sonoscli ``` ### Previous Releases * **Telegram Channel (CLI)** — Polling and Webhook modes for connecting your agent to Telegram. [Setup guide](/guides/novitaclaw-configuration#telegram) * **Slack Channel** — Socket and HTTP modes for connecting your agent to Slack. [Setup guide](/guides/novitaclaw-configuration#slack) * **Install Script Improvements** — Install directory changed to `~/.novitaclaw-cli`, improved `update` command with PEP 668 support and symlink recovery * **On-Demand Mode** — Sandbox auto-pauses after idle, resumes on access. Zero billing while paused. [Learn more](/guides/novitaclaw-configuration#on-demand-mode) * **Feishu Channel** — Connect your agent to Feishu (Lark) via Webhook or Event mode. [Setup guide](/guides/novitaclaw-configuration#feishu) * **Web Terminal** — Browser-based terminal access to your sandbox, no SSH required * **File Manager** — Browse and manage workspace files directly from the browser * **systemd Service Management** — Gateway, Web Terminal, and File Manager are fully managed by systemd with automatic restart on failure * **Crash Auto-Recovery** — Automatic diagnostics, repair, and service restoration on repeated crashes * **Config Auto-Backup** — Every config write creates an automatic backup; crash recovery restores from the latest known-good backup To use the new features, please upgrade your 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 ``` ## Getting Started ### Prerequisites * Python installed * A Novita API key (create/manage keys in [Key Management](https://novita.ai/docs/guides/quickstart#2-manage-api-key)) **Windows** [Download the Python installer](https://www.python.org/downloads/) and run it. **Check "Add Python to PATH"** before clicking Install Now — skipping this is the most common reason beginners hit errors later. **macOS** Open Terminal and run: ```bash Bash icon="terminal" theme={"system"} python3 --version ``` If you see Python 3.10 or higher, you're good. If Terminal prompts you to install Command Line Developer Tools, click Install and wait a few minutes. **Linux (Ubuntu / Debian)** ```bash Bash icon="terminal" theme={"system"} sudo apt update && sudo apt install python3 python3-pip -y ``` ### Step 1: Install NovitaClaw ```bash macOS / Linux theme={"system"} sudo pip3 install novitaclaw ``` ```bash Windows PowerShell theme={"system"} pip install novitaclaw ``` After installation, verify by running `novitaclaw --help`. If you see a list of commands, you're all set. **Mac users:** If you get `zsh: command not found: novitaclaw` after installation, run: ```bash Bash icon="terminal" theme={"system"} echo 'export PATH="'$(python3 -m site --user-base)'/bin:$PATH"' >> ~/.zshrc source ~/.zshrc ``` ### Step 2: Set your API key ```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" ``` ### Step 3: Launch your instance ```bash Bash icon="terminal" theme={"system"} novitaclaw launch ``` On success, the CLI returns: * **Web UI URL** — Chat with your agent * **Gateway WebSocket URL & Token** — For programmatic access * **Web Terminal URL** — Terminal access to the sandbox in your browser * **File Manager URL** — Browse and manage workspace files * **Login credentials** — Username and password for Web Terminal & File Manager NovitaClaw launch result Open the returned **Web UI URL** and go to the `Chat` tab to start using your agent. ### Web Terminal The Web Terminal provides browser-based terminal access to your sandbox environment. Open the **Web Terminal URL** returned by the launch command and log in with the provided credentials. This gives you a full shell session — install packages, inspect logs, or debug your agent directly. ### File Manager The File Manager lets you browse, upload, download, and manage files in the sandbox workspace through a web interface. Open the **File Manager URL** and log in with the same credentials. Use it to view agent workspace files, edit configurations, or transfer files without needing CLI access. For existing sandboxes launched before these services were available, you can add them retroactively: ```bash Bash icon="terminal" theme={"system"} novitaclaw services setup --api-key YOUR_API_KEY ``` ## Pricing | What you use | What you pay | | ------------------ | ---------------------------------------------------- | | Sandbox runtime | [Sandbox rates](https://novita.ai/pricing?sandbox=1) | | Novita-hosted LLMs | [Model rates](https://novita.ai/pricing) | | Third-party LLMs | Sandbox runtime only |