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

# Commandoverzicht

Volledig overzicht van alle NovitaClaw CLI-commando's.

## `launch`

Maak een nieuwe sandbox-instantie aan.

```bash Bash icon="terminal" theme={"system"}
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 Bash icon="terminal" theme={"system"}
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 Bash icon="terminal" theme={"system"}
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 Bash icon="terminal" theme={"system"}
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 Bash icon="terminal" theme={"system"}
novitaclaw pause <SANDBOX_ID> --api-key YOUR_API_KEY
```

## `resume`

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

```bash Bash icon="terminal" theme={"system"}
novitaclaw resume <SANDBOX_ID> --api-key YOUR_API_KEY
```

## `config set`

Werk de runtimeconfiguratie van de sandbox bij.

```bash Bash icon="terminal" theme={"system"}
# 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 Bash icon="terminal" theme={"system"}
novitaclaw tui <SANDBOX_ID> --token <GATEWAY_TOKEN>
```

## `doctor`

Voer diagnostiek en herstelcontroles uit op een sandbox-instantie.

```bash Bash icon="terminal" theme={"system"}
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 geheugen­systeem 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 Bash icon="terminal" theme={"system"}
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 Bash icon="terminal" theme={"system"}
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 Bash icon="terminal" theme={"system"}
novitaclaw services setup <SANDBOX_ID> --api-key YOUR_API_KEY
```

## `pair list`

Geef openstaande koppelingsverzoeken voor een kanaal weer.

```bash Bash icon="terminal" theme={"system"}
novitaclaw pair list <SANDBOX_ID> --channel <CHANNEL_NAME> --api-key YOUR_API_KEY
```

## `pair approve`

Keur een koppelingsverzoek voor een kanaal goed.

```bash Bash icon="terminal" theme={"system"}
novitaclaw pair approve <SANDBOX_ID> --channel <CHANNEL_NAME> --code <PAIRING_CODE> --api-key YOUR_API_KEY
```

## `pair feishu`

Configureer Feishu (Lark) als berichtenkanaal.

```bash Bash icon="terminal" theme={"system"}
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 Bash icon="terminal" theme={"system"}
# 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 Bash icon="terminal" theme={"system"}
# 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 Bash icon="terminal" theme={"system"}
novitaclaw update
```

## Programmatisch gebruik

Gebruik JSON-uitvoer voor automatisering:

```bash Bash icon="terminal" theme={"system"}
novitaclaw -j launch --api-key YOUR_API_KEY
```

Voorbeeldrespons:

```json theme={"system"}
{
  "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 Bash icon="terminal" theme={"system"}
# 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 Bash icon="terminal" theme={"system"}
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`                                  |