Commandoverzicht

Volledig overzicht van alle NovitaClaw CLI-commando’s.

`launch`

Maak een nieuwe sandbox-instantie aan.

Bash

novitaclaw launch [OPTIONS]

Optie	Beschrijving
`--api-key`	Novita API-sleutel
`--gateway-token`	Aangepast gateway-token (optioneel, standaard automatisch gegenereerd)
`--timeout`	Time-out voor aanmaken in seconden (standaard: `60`)
`--type`	Sandbox-type: `persistent` (standaard) of `on-demand`
`--idle-timeout`	Inactiviteitstime-out in seconden voor on-demandmodus (standaard: `300`, bereik: 60–86400)

`list`

Geef actieve sandbox-instanties weer.

Bash

novitaclaw list --api-key YOUR_API_KEY

Optie	Beschrijving
`--api-key`	Novita API-sleutel
`--quiet`, `-q`	Alleen sandbox-ID’s afdrukken, één per regel (handig voor scripting)

`status`

Controleer de status van een sandbox-instantie. Toont webhook-URL’s voor alle geconfigureerde kanalen.

Bash

novitaclaw status <SANDBOX_ID> --api-key YOUR_API_KEY

Optie	Beschrijving
`--api-key`	Novita API-sleutel
`--json`	Uitvoer in JSON-indeling (handig voor het extraheren van webhook-URL’s)

`stop`

Beëindig een sandbox-instantie.

Bash

novitaclaw stop <SANDBOX_ID> --api-key YOUR_API_KEY

Optie	Beschrijving
`--api-key`	Novita API-sleutel
`--yes`, `-y`	Bevestigingsprompt overslaan

`pause`

Pauzeer een sandbox-instantie. Geen facturering tijdens het pauzeren.

Bash

novitaclaw pause <SANDBOX_ID> --api-key YOUR_API_KEY

`resume`

Hervat een gepauzeerde sandbox-instantie (~1s om te herstellen).

Bash

novitaclaw resume <SANDBOX_ID> --api-key YOUR_API_KEY

`config set`

Werk de runtimeconfiguratie van de sandbox bij.

Bash

# Update idle timeout (60–86400 seconds)
novitaclaw config set <SANDBOX_ID> idle-timeout 600

# Update sandbox lifetime timeout (300–2592000 seconds)
novitaclaw config set <SANDBOX_ID> timeout 3600

`tui`

Maak verbinding met een sandbox via de terminal-UI.

Bash

novitaclaw tui <SANDBOX_ID> --token <GATEWAY_TOKEN>

`doctor`

Voer diagnostiek en herstelcontroles uit op een sandbox-instantie.

Bash

novitaclaw doctor <SANDBOX_ID> --api-key YOUR_API_KEY

Optie	Beschrijving
`--api-key`	Novita API-sleutel
`--deep`	Systeemservices scannen op extra gateway-installaties
`--fix`	Aanbevolen reparaties toepassen (alias voor `--repair`)
`--force`	Agressieve reparaties toepassen (overschrijft aangepaste serviceconfiguratie)
`--generate-gateway-token`	Een gateway-token genereren en configureren
`--no-workspace-suggestions`	Suggesties van het geheugensysteem voor de werkruimte uitschakelen
`--repair`	Aanbevolen reparaties toepassen zonder prompt
`--yes`	Standaardwaarden accepteren zonder prompt

`gateway update`

Werk OpenClaw bij naar de nieuwste versie binnen een sandbox.

Bash

novitaclaw gateway update <SANDBOX_ID> --api-key YOUR_API_KEY

Optie	Beschrijving
`--api-key`	Novita API-sleutel
`--restart`	Gateway opnieuw starten na update

`gateway restart`

Start de OpenClaw Gateway opnieuw in een sandbox.

Bash

novitaclaw gateway restart <SANDBOX_ID> --api-key YOUR_API_KEY

`services setup`

Installeer en start Web Terminal en File Manager op een bestaande sandbox. Gebruik dit om services toe te voegen aan oudere sandboxes die zijn gestart voordat deze services waren inbegrepen.

Bash

novitaclaw services setup <SANDBOX_ID> --api-key YOUR_API_KEY

`pair list`

Geef openstaande koppelingsverzoeken voor een kanaal weer.

Bash

novitaclaw pair list <SANDBOX_ID> --channel <CHANNEL_NAME> --api-key YOUR_API_KEY

`pair approve`

Keur een koppelingsverzoek voor een kanaal goed.

Bash

novitaclaw pair approve <SANDBOX_ID> --channel <CHANNEL_NAME> --code <PAIRING_CODE> --api-key YOUR_API_KEY

`pair feishu`

Configureer Feishu (Lark) als berichtenkanaal.

Bash

novitaclaw pair feishu <SANDBOX_ID> \
  --app-id cli_xxx \
  --app-secret secret_xxx \
  --mode webhook \
  --verification-token tok_xxx \
  --encrypt-key key_xxx

Optie	Beschrijving
`--app-id`	Feishu-app-ID
`--app-secret`	Feishu-appgeheim
`--mode`	`event` (standaard) of `webhook`
`--verification-token`	Webhook-verificatietoken (alleen webhookmodus)
`--encrypt-key`	Webhook-versleutelingssleutel (alleen webhookmodus)
`--webhook-host`	Webhook-bindadres (standaard: `0.0.0.0`)
`--webhook-port`	Webhook-luisterpoort (standaard: `3000`)
`--webhook-path`	Webhook-URL-pad (standaard: `/feishu/events`)

`pair telegram`

Configureer Telegram als berichtenkanaal.

Bash

# Polling mode (default)
novitaclaw pair telegram <SANDBOX_ID> \
  --bot-token <BOT_TOKEN>

# Webhook mode
novitaclaw pair telegram <SANDBOX_ID> \
  --bot-token <BOT_TOKEN> \
  --mode webhook \
  --webhook-url https://example.com/webhook/telegram \
  --webhook-secret <SECRET>

Optie	Beschrijving
`--bot-token`	Telegram-bottoken van BotFather
`--mode`	`polling` (standaard) of `webhook`
`--webhook-url`	Openbare webhook-URL (alleen webhookmodus)
`--webhook-secret`	Webhook-geheim (alleen webhookmodus)
`--webhook-host`	Webhook-bindadres (standaard: `0.0.0.0`)
`--webhook-port`	Webhook-luisterpoort (standaard: `8787`)
`--webhook-path`	Webhook-URL-pad (standaard: `/webhook/telegram`)
`--dm-policy`	DM-beleid (standaard: `pairing`)

`pair slack`

Configureer Slack als berichtenkanaal.

Bash

# Socket mode (default)
novitaclaw pair slack <SANDBOX_ID> \
  --bot-token xoxb-... \
  --app-token xapp-...

# HTTP mode
novitaclaw pair slack <SANDBOX_ID> \
  --bot-token xoxb-... \
  --mode http \
  --signing-secret <SECRET>

Optie	Beschrijving
`--bot-token`	Slack-bottoken (`xoxb-...`)
`--app-token`	Slack-app-token (`xapp-...`, alleen socketmodus)
`--mode`	`socket` (standaard) of `http`
`--signing-secret`	Slack-ondertekeningsgeheim (alleen HTTP-modus)
`--webhook-host`	Webhook-bindadres (standaard: `0.0.0.0`)
`--webhook-port`	Webhook-luisterpoort (standaard: `8788`)
`--webhook-path`	Webhook-URL-pad (standaard: `/webhook/slack`)

`update`

Controleer op CLI-updates en upgrade naar de nieuwste versie.

Bash

novitaclaw update

Programmatisch gebruik

Gebruik JSON-uitvoer voor automatisering:

Bash

novitaclaw -j launch --api-key YOUR_API_KEY

Voorbeeldrespons:

{
  "success": true,
  "data": {
    "sandbox_id": "xxx",
    "webui": "https://xxx.sandbox.novita.ai?token=xxx",
    "gateway_ws": "wss://xxx.sandbox.novita.ai",
    "gateway_token": "xxx",
    "terminal_url": "https://7681-xxx.sandbox.novita.ai",
    "filemanager_url": "https://7682-xxx.sandbox.novita.ai",
    "services_username": "admin",
    "services_password": "xxx"
  }
}

Omgevingsvariabelen

Variabele	Beschrijving
`NOVITA_API_KEY`	API-sleutel; maakt de `--api-key`-vlag overbodig
`OPENCLAW_GATEWAY_TOKEN`	Vooraf ingesteld gateway-token

Probleemoplossing

Commando niet gevonden

Probeer een van deze opties:

Bash

# Use full path (Linux)
~/.local/bin/novitaclaw launch

# Typical macOS user path
~/Library/Python/3.x/bin/novitaclaw launch

Verbindingstime-out

Verhoog de starttime-out:

Bash

novitaclaw launch --timeout 180 --api-key YOUR_API_KEY

Veelgestelde vragen

Probleem	Waarom het gebeurt	Wat te doen
”Commando niet gevonden” / “Niet herkend”	Python PATH is niet geconfigureerd tijdens de installatie	Installeer Python opnieuw en vink “Add to PATH” aan, of voeg de bin-map handmatig toe
”Permission Denied”	Onvoldoende rechten	Windows: voer Terminal uit als Administrator. Mac/Linux: prefix met `sudo`
”Invalid API Key”	Sleutel onjuist gekopieerd	Controleer op extra spaties rond de `sk_`-tekenreeks, of genereer een nieuwe sleutel
Sandbox stopt niet	Vereist bevestiging om per ongeluk verwijderen te voorkomen	Typ `y` wanneer daarom wordt gevraagd, of gebruik `--yes` om bevestiging over te slaan
Mac: `pip`-commando niet gevonden	macOS gebruikt standaard `pip3`	Gebruik `pip3 install novitaclaw` in plaats van `pip`

Get started

Model APIs

Agent Sandbox

GPUs

Observability

Resources

`launch`

`list`

`status`

`stop`

`pause`

`resume`

`config set`

`tui`

`doctor`

`gateway update`

`gateway restart`

`services setup`

`pair list`

`pair approve`

`pair feishu`

`pair telegram`

`pair slack`

`update`

Programmatisch gebruik

Omgevingsvariabelen

Probleemoplossing

Commando niet gevonden

Verbindingstime-out

Veelgestelde vragen

​launch

​list

​status

​stop

​pause

​resume

​config set

​tui

​doctor

​gateway update

​gateway restart

​services setup

​pair list

​pair approve

​pair feishu

​pair telegram

​pair slack

​update

​Programmatisch gebruik

​Omgevingsvariabelen

​Probleemoplossing

​Commando niet gevonden

​Verbindingstime-out

​Veelgestelde vragen

`launch`

`list`

`status`

`stop`

`pause`

`resume`

`config set`

`tui`

`doctor`

`gateway update`

`gateway restart`

`services setup`

`pair list`

`pair approve`

`pair feishu`

`pair telegram`

`pair slack`

`update`

Programmatisch gebruik

Omgevingsvariabelen

Probleemoplossing

Commando niet gevonden

Verbindingstime-out

Veelgestelde vragen