Skip to main content
Deploy a persistent OpenClaw agent on Novita Agent 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
# Export config
novitaclaw gateway config export <sandbox_id> -o config.json
# Import into another sandbox
novitaclaw gateway config import <target_id> 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 <sandbox_id> sonoscli

​
Previous Releases

  • Telegram Channel (CLI) — Polling and Webhook modes for connecting your agent to Telegram. Setup guide
  • Slack Channel — Socket and HTTP modes for connecting your agent to Slack. Setup guide
  • 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
  • Feishu Channel — Connect your agent to Feishu (Lark) via Webhook or Event mode. Setup guide
  • 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

​
Prerequisites

  • Python installed
  • A Novita API key (create/manage keys in Key Management)
WindowsDownload the Python installer 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

sudo pip3 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

export NOVITA_API_KEY=sk_your_api_key

​
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
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
novitaclaw services setup <SANDBOX_ID> --api-key YOUR_API_KEY

​
Pricing

What you useWhat you pay
Sandbox runtimeSandbox rates
Novita-hosted LLMsModel rates
Third-party LLMsSandbox runtime only