# NovitaClaw - Documentation

> For the complete documentation index, see [llms.txt](/llms.txt). Markdown is available with `Accept: text/markdown` and `.md` URL variants.

Source: /docs/guides/novitaclaw

# 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)

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

```
# 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

```
novitaclaw skill install sonoscli
```

###

[​](#previous-releases)

Previous Releases

- Telegram Channel (CLI) — Polling and Webhook modes for connecting your agent to Telegram. [Setup guide](/docs/guides/novitaclaw-configuration#telegram)

- Slack Channel — Socket and HTTP modes for connecting your agent to Slack. [Setup guide](/docs/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](/docs/guides/novitaclaw-configuration#on-demand-mode)

- Feishu Channel — Connect your agent to Feishu (Lark) via Webhook or Event mode. [Setup guide](/docs/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:

macOS / Linux

```
curl -fsSL https://novitaclaw.novita.ai/install.sh | bash
```

Windows (PowerShell)

```
irm https://novitaclaw.novita.ai/install.ps1 | iex
```

##

[​](#getting-started)

Getting Started

###

[​](#prerequisites)

Prerequisites

- Python installed

- A Novita API key (create/manage keys in [Key Management](https://novita.ai/docs/guides/quickstart#2-manage-api-key))

How to install Python

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.macOSOpen Terminal and run:

Bash

```
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

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

###

[​](#step-1-install-novitaclaw)

Step 1: Install NovitaClaw

macOS / Linux

Windows PowerShell

```
sudo pip3 install novitaclaw
```

```
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

```
echo 'export PATH="'$(python3 -m site --user-base)'/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
```

###

[​](#step-2-set-your-api-key)

Step 2: Set your API key

macOS / Linux

Windows PowerShell

```
export NOVITA_API_KEY=sk_your_api_key
```

```
$env:NOVITA_API_KEY = "sk_your_api_key"
```

###

[​](#step-3-launch-your-instance)

Step 3: Launch your instance

Bash

```
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](https://mintcdn.com/novitaai/ydHruENOsMtbfOFu/guides/images/openclaw-cli/launch-result.png?fit=max&auto=format&n=ydHruENOsMtbfOFu&q=85&s=2ecf75c461fa4b83cba6f949233bc5f2)

Open the returned Web UI URL and go to the `Chat` tab to start using your agent.

###

[​](#web-terminal)

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)

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

```
novitaclaw services setup --api-key YOUR_API_KEY
```

##

[​](#pricing)

Pricing

What you useWhat you paySandbox runtime[Sandbox rates](https://novita.ai/pricing?sandbox=1)Novita-hosted LLMs[Model rates](https://novita.ai/pricing)Third-party LLMsSandbox runtime only

Last modified on April 10, 2026