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.

​
Getting Started

​
Prerequisites

  • Python installed
  • A Novita API key (create/manage keys in Key Management)

​
Install and Launch

Bash
pip install novita-openclaw-cli

# Launch with API key
novita-openclaw-cli launch --api-key YOUR_API_KEY

# Or use environment variable
export NOVITA_API_KEY="your-api-key"
novita-openclaw-cli launch
On success, the CLI returns:
  • Web UI URL
  • WebSocket URL
  • Gateway Token
OpenClaw CLI launch result
Open the returned Web UI URL and go to the Chat tab to use your agent.

​
Configuring Models

Each instance starts with two preconfigured Novita-hosted models:
ModelRole
moonshotai/kimi-k2.5Primary
minimax/minimax-m2.5Fallback
Go to Settings -> Config, switch to Raw JSON mode, then update:

​
Step 1: Register a model under provider

{
  "models": {
    "providers": {
      "novita": {
        "models": [
          {
            "id": "model-id",
            "name": "display name",
            "reasoning": true,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

​
Step 2: Set primary and fallback

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "novita/moonshotai/kimi-k2.5",
        "fallbacks": ["novita/minimax/minimax-m2.5"]
      }
    }
  }
}
For available models, see Novita LLM API catalog.
OpenClaw model configuration

​
Connecting Channels

Channels are disabled by default and must be configured.

​
Telegram

  1. Open Telegram and find @BotFather.
  2. Send /newbot and complete setup.
  3. Copy the bot token and send it in the OpenClaw Web UI Chat tab.
  4. In Telegram, open your bot and send /start.
  5. Copy the pairing code and paste it in the Web UI Chat tab.
After pairing, messages to your Telegram bot are routed to your OpenClaw agent. See OpenClaw channels documentation for more integrations.
OpenClaw Telegram connection

​
Command Reference

​
launch

Create a new instance.
Bash
novita-openclaw-cli launch [OPTIONS]
OptionDescription
--api-keyNovita API key
--gateway-tokenCustom gateway token (optional, auto-generated by default)
--timeoutCreation timeout in seconds (default: 60)

​
list

List active instances.
Bash
novita-openclaw-cli list --api-key YOUR_API_KEY

​
status

Check instance status.
Bash
novita-openclaw-cli status <SANDBOX_ID> --api-key YOUR_API_KEY

​
stop

Terminate an instance.
Bash
novita-openclaw-cli stop <SANDBOX_ID> --api-key YOUR_API_KEY

​
tui

Connect via terminal UI.
Bash
novita-openclaw-cli tui <SANDBOX_ID> --token <GATEWAY_TOKEN>

​
Programmatic Usage

Use JSON output for automation:
Bash
novita-openclaw-cli -j launch --api-key YOUR_API_KEY
Example response: 
{
  "success": true,
  "data": {
    "sandbox_id": "xxx",
    "webui": "https://xxx.sandbox.novita.ai?token=xxx",
    "gateway_ws": "wss://xxx.sandbox.novita.ai",
    "gateway_token": "xxx"
  }
}

​
Environment Variables

VariableDescription
NOVITA_API_KEYAPI key, avoids passing --api-key each time
OPENCLAW_GATEWAY_TOKENPreset gateway token

​
Pricing

ItemBilling
Sandbox runtimeSandbox rates
Novita-hosted LLMsModel rates
Third-party LLMsSandbox runtime only

​
Troubleshooting

​
Command not found

Try one of these:
Bash
# Use full path (Linux)
~/.local/bin/novita-openclaw-cli launch

# Typical macOS user path
~/Library/Python/3.x/bin/novita-openclaw-cli launch

​
Connection timeout

Increase launch timeout:
Bash
novita-openclaw-cli launch --timeout 180 --api-key YOUR_API_KEY