OpenClaw

OpenClaw est un assistant d’IA open source sur appareil personnel. Son Gateway centralise modèles, sessions, outils et canaux de messagerie ; il propose un TUI et une Control UI dans le navigateur. Ajoutez AGTCloud comme Custom Provider pour appeler les modèles accessibles à votre API Key via Chat Completions.

Ce tutoriel couvre seulement l’installation locale, l’intégration du modèle, le démarrage du Gateway et la validation de base. Les canaux de messagerie, Gateway distants, plugins ClawHub, Skills, MCP, tâches planifiées et fonctions multiagents ne sont pas détaillés.

Prérequis

Avant de commencer, vérifiez que vous avez :

• Préparé un appareil macOS, Linux, WSL2 ou Windows pris en charge par OpenClaw ;
• Créé une API Key AGTCloud dans API Keys ;
• Copié dans le catalogue de modèles un ID accessible à la clé et compatible Chat Completions ;
• Préparé un répertoire de test sans identifiants de production ni sources sensibles.

MODEL_ID doit être remplacé. Pour tester les outils, choisissez un modèle accessible à l’API Key et explicitement compatible avec les appels d’outils.

Installer OpenClaw

L’installateur officiel prépare si nécessaire un runtime Node.js pris en charge. Si vous gérez déjà Node.js, vous pouvez installer via npm.

curl -fsSL https://openclaw.ai/install.sh | bash

Vérifiez la version et l’environnement après installation :

openclaw --version
openclaw doctor

Si l’installateur ouvre automatiquement l’assistant, vous pouvez quitter la configuration du modèle et exécuter openclaw onboard --install-daemon après avoir configuré le Provider AGTCloud ci-dessous. L’assistant pourra ainsi conserver le modèle par défaut déjà validé.

Conserver l’API Key en sécurité

OpenClaw lit ~/.openclaw/.env comme fichier de repli global des variables. Créez-le, puis renseignez l’API Key :

~/.openclaw/.env

Contenu :

AGTCLOUD_API_KEY=your-api-key

Ce fichier contient de véritables identifiants : ne le soumettez pas au dépôt, ne le téléversez pas dans un stockage partagé et ne l’envoyez pas en pièce jointe de dépannage.

Ajouter un Custom Provider AGTCloud

OpenClaw conserve les Custom Provider dans models.providers. Les commandes incrémentales ci-dessous fusionnent le Provider agtcloud sans écraser openclaw.json.

openclaw config set models.providers.agtcloud \
  '{"baseUrl":"https://api.agtcloud.cn/v1","apiKey":"${AGTCLOUD_API_KEY}","api":"openai-completions","auth":"api-key","authHeader":true,"models":[{"id":"MODEL_ID","name":"MODEL_ID","input":["text"]}]}' \
  --strict-json \
  --merge

Principaux champs :

Le tutoriel déclare seulement une entrée textuelle, sans limites de contexte ou de sortie, prix, raisonnement ou capacités d’image non confirmés. Ajoutez des métadonnées selon la documentation officielle uniquement lorsque vous connaissez les capacités réelles du modèle.

Définir le modèle et vérifier la configuration

Définissez le modèle déclaré comme modèle par défaut :

openclaw models set agtcloud/MODEL_ID

Vérifiez successivement le fichier, les modèles du Provider et le modèle par défaut :

openclaw config validate
openclaw models list --provider agtcloud
openclaw models status

Si config validate signale un champ invalide, corrigez-le avant de démarrer le Gateway. Si agtcloud/MODEL_ID est absent de la liste, vérifiez son ajout à models.providers.agtcloud.models.

Pour effectuer une véritable sonde de connexion, exécutez :

openclaw models status --probe

Terminer l’assistant local et démarrer le Gateway

Après validation du Provider, lancez l’assistant local et installez le daemon Gateway :

openclaw onboard --install-daemon

Si l’assistant demande la configuration du modèle, conservez-la. Vous pouvez ignorer provisoirement les canaux de messagerie, Web Search, Skills et les extensions. Au début, limitez l’écoute du Gateway à la machine locale et conservez l’authentification.

Redémarrez ensuite le Gateway et vérifiez-le :

openclaw gateway restart
openclaw gateway status

En cas d’échec, exécutez d’abord openclaw config validate et openclaw doctor, sans ouvrir l’écoute sur Internet ni désactiver l’authentification pour contourner le problème.

Démarrer et valider la connexion

Ouvrir Control UI ou le TUI

Ouvrez Control UI dans le navigateur :

openclaw dashboard

Ou connectez-vous au Gateway local dans le terminal :

openclaw tui

Valider une réponse textuelle de base

Saisissez d’abord :

Répondez uniquement : connexion AGTCloud réussie. N’appelez aucun outil.

Le texte demandé confirme la connexion de base du Gateway, du Provider AGTCloud, de l’API Key et de l’ID du modèle.

Facultatif : valider les outils en lecture seule

Après stabilisation de la conversation, saisissez dans un projet de test sûr :

Veuillez lire README.md et résumer l’objectif du projet en trois points. Ne modifiez aucun fichier et n’exécutez aucune autre commande.

Examinez chaque action et autorisez seulement la lecture du fichier cible. Si la conversation fonctionne mais pas cette étape, le modèle ou l’endpoint compatible ne prend généralement pas complètement en charge la structure d’outils requise.

Ajouter ou changer de modèle

La référence OpenClaw suit provider/model. Pour AGTCloud :

agtcloud/MODEL_ID

Un Custom Provider ne garantit pas la récupération automatique de tous les résultats /v1/models d’AGTCloud. Pour ajouter un modèle, fusionnez son objet dans models.providers.agtcloud.models, puis changez de modèle avec :

openclaw models set agtcloud/MODEL_ID
openclaw gateway restart

Après modification, vérifiez que le modèle est accessible à l’API Key et compatible avec le protocole, sinon une erreur de modèle absent ou interdit peut survenir.

Questions fréquentes

En cas de problème non identifié, consignez la version, l’heure, l’API Base URL, le Provider, l’ID du modèle, le code HTTP et l’erreur expurgée, puis consultez Erreurs et dépannage. Ne fournissez pas de .env, de sauvegarde complète ni d’API Key.

Conseils de sécurité

• OpenClaw est conçu pour un opérateur unique et fiable : n’exposez pas un Gateway non protégé sur Internet ;
• Utilisez d’abord un répertoire isolé et examinez les autorisations de fichiers, commandes, réseau et outils ;
• Ne conservez pas d’API Key dans les dépôts, captures d’écran, exports de session, journaux ou configurations partagées ;
• Avant d’ajouter des canaux, utilisateurs ou automatisations, lisez la documentation officielle de sécurité et de sandbox.

Étapes suivantes

• API Key et authentification
• Chat Completions API Reference
• Erreurs et dépannage
• Documentation officielle OpenClaw