> ## 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. # NovitaClaw Déployez un agent OpenClaw persistant sur [Novita Agent Sandbox](https://novita.ai/sandbox) avec une seule commande, puis gérez-le depuis la CLI, l’interface Web ou des scripts d’automatisation. Aucune limite de session — votre instance fonctionne 24/7 aussi longtemps que vous en avez besoin. ## Nouveautés de la v1.6.0 * **Export / Import de la configuration Gateway** — Sauvegardez, restaurez et migrez votre configuration OpenClaw entre sandboxes. Exportez vers stdout ou vers un fichier, importez avec validation JSON automatique et redémarrage de Gateway. Prend en charge les workflows de migration entre sandboxes. ```bash Bash icon="terminal" theme={"system"} # Export config novitaclaw gateway config export -o config.json # Import into another sandbox novitaclaw gateway config import config.json ``` * **Installation de skills ClawHub** — Installez des skills d’extension OpenClaw depuis ClawHub directement dans une sandbox. Les skills sont disponibles immédiatement, sans redémarrage de Gateway. ```bash Bash icon="terminal" theme={"system"} novitaclaw skill install sonoscli ``` ### Versions précédentes * **Canal Telegram (CLI)** — Modes Polling et Webhook pour connecter votre agent à Telegram. [Guide de configuration](/docs/fr/guides/novitaclaw-configuration#telegram) * **Canal Slack** — Modes Socket et HTTP pour connecter votre agent à Slack. [Guide de configuration](/docs/fr/guides/novitaclaw-configuration#slack) * **Améliorations du script d’installation** — Le répertoire d’installation a été changé en `~/.novitaclaw-cli`, commande `update` améliorée avec prise en charge de PEP 668 et récupération des liens symboliques * **Mode à la demande** — La sandbox se met automatiquement en pause après une période d’inactivité, puis reprend lors de l’accès. Aucune facturation pendant la pause. [En savoir plus](/docs/fr/guides/novitaclaw-configuration#on-demand-mode) * **Canal Feishu** — Connectez votre agent à Feishu (Lark) via le mode Webhook ou Event. [Guide de configuration](/docs/fr/guides/novitaclaw-configuration#feishu) * **Terminal Web** — Accès au terminal de votre sandbox depuis le navigateur, sans SSH requis * **Gestionnaire de fichiers** — Parcourez et gérez les fichiers de l’espace de travail directement depuis le navigateur * **Gestion des services systemd** — Gateway, Web Terminal et File Manager sont entièrement gérés par systemd avec redémarrage automatique en cas d’échec * **Récupération automatique après crash** — Diagnostics, réparation et restauration de service automatiques en cas de crashs répétés * **Sauvegarde automatique de la configuration** — Chaque écriture de configuration crée une sauvegarde automatique ; la récupération après crash restaure la dernière sauvegarde connue comme valide Pour utiliser les nouvelles fonctionnalités, veuillez mettre à niveau votre CLI : ```bash macOS / Linux theme={"system"} curl -fsSL https://novitaclaw.novita.ai/install.sh | bash ``` ```bash Windows (PowerShell) theme={"system"} irm https://novitaclaw.novita.ai/install.ps1 | iex ``` ## Premiers pas ### Prérequis * Python installé * Une clé API Novita (créez/manage des clés dans [Key Management](https://novita.ai/docs/guides/quickstart#2-manage-api-key)) **Windows** [Téléchargez l’installateur Python](https://www.python.org/downloads/) et exécutez-le. **Cochez "Add Python to PATH"** avant de cliquer sur Install Now — ne pas le faire est la raison la plus fréquente pour laquelle les débutants rencontrent des erreurs par la suite. **macOS** Ouvrez Terminal et exécutez : ```bash Bash icon="terminal" theme={"system"} python3 --version ``` Si vous voyez Python 3.10 ou une version supérieure, tout est prêt. Si Terminal vous invite à installer Command Line Developer Tools, cliquez sur Install et attendez quelques minutes. **Linux (Ubuntu / Debian)** ```bash Bash icon="terminal" theme={"system"} sudo apt update && sudo apt install python3 python3-pip -y ``` ### Étape 1 : installer NovitaClaw ```bash macOS / Linux theme={"system"} sudo pip3 install novitaclaw ``` ```bash Windows PowerShell theme={"system"} pip install novitaclaw ``` Après l’installation, vérifiez en exécutant `novitaclaw --help`. Si vous voyez une liste de commandes, tout est prêt. **Utilisateurs Mac :** Si vous obtenez `zsh: command not found: novitaclaw` après l’installation, exécutez : ```bash Bash icon="terminal" theme={"system"} echo 'export PATH="'$(python3 -m site --user-base)'/bin:$PATH"' >> ~/.zshrc source ~/.zshrc ``` ### Étape 2 : définir votre clé API ```bash macOS / Linux theme={"system"} export NOVITA_API_KEY=sk_your_api_key ``` ```powershell Windows PowerShell theme={"system"} $env:NOVITA_API_KEY = "sk_your_api_key" ``` ### Étape 3 : lancer votre instance ```bash Bash icon="terminal" theme={"system"} novitaclaw launch ``` En cas de succès, la CLI renvoie : * **URL de l’interface Web** — Discutez avec votre agent * **URL WebSocket et jeton Gateway** — Pour l’accès programmatique * **URL du Terminal Web** — Accès au terminal de la sandbox dans votre navigateur * **URL du Gestionnaire de fichiers** — Parcourez et gérez les fichiers de l’espace de travail * **Identifiants de connexion** — Nom d’utilisateur et mot de passe pour Web Terminal et File Manager Résultat du lancement de NovitaClaw Ouvrez l’**URL de l’interface Web** renvoyée et accédez à l’onglet `Chat` pour commencer à utiliser votre agent. ### Terminal Web Le Terminal Web fournit un accès au terminal de votre environnement sandbox directement depuis le navigateur. Ouvrez l’**URL du Terminal Web** renvoyée par la commande de lancement et connectez-vous avec les identifiants fournis. Vous obtenez ainsi une session shell complète — installez des packages, inspectez les logs ou déboguez votre agent directement. ### Gestionnaire de fichiers Le Gestionnaire de fichiers vous permet de parcourir, téléverser, télécharger et gérer les fichiers dans l’espace de travail de la sandbox via une interface Web. Ouvrez l’**URL du Gestionnaire de fichiers** et connectez-vous avec les mêmes identifiants. Utilisez-le pour consulter les fichiers de l’espace de travail de l’agent, modifier des configurations ou transférer des fichiers sans avoir besoin d’un accès CLI. Pour les sandboxes existantes lancées avant que ces services ne soient disponibles, vous pouvez les ajouter rétroactivement : ```bash Bash icon="terminal" theme={"system"} novitaclaw services setup --api-key YOUR_API_KEY ``` ## Tarification | Ce que vous utilisez | Ce que vous payez | | ------------------------------- | ----------------------------------------------------------- | | Durée d’exécution de la sandbox | [Tarifs des sandboxes](https://novita.ai/pricing?sandbox=1) | | LLMs hébergés par Novita | [Tarifs des modèles](https://novita.ai/pricing) | | LLMs tiers | Durée d’exécution de la sandbox uniquement |