Passer au contenu principal
OpenClaw est un agent IA personnel, open source et auto-hébergé que vous pouvez utiliser via WhatsApp, Telegram, Discord et d’autres plateformes de messagerie, avec prise en charge des outils MCP. Il sélectionne son modèle dans une configuration providers — ajoutez un fournisseur personnalisé compatible OpenAI pointant vers https://api.tokios.com/v1 en utilisant votre clé API sk-tok-…, et l’agent OpenClaw fonctionnera sur un modèle installé sur votre propre matériel.

Prérequis

Connecteur appairé

Installez et appairez tokios-connector à côté du modèle que vous souhaitez rendre accessible à OpenClaw.

Modèle enregistré

Enregistrez un déploiement (nom public) pour ce modèle.

Clé API créée

Générez une clé sk-tok-…, en la limitant éventuellement à ce déploiement.

Backends pris en charge

Vérifiez que votre backend local (Ollama, llama.cpp, vLLM, LM Studio) est en cours d’exécution.

Ajoutez Tokios en tant que fournisseur de modèles.

1

Ouvrez la configuration d’OpenClaw.

Modifiez cette configuration, où les fournisseurs de modèles sont répertoriés sous models.providers. Le chemin du fichier varie selon votre installation ; consultez les paramètres d’OpenClaw pour en savoir plus.
2

Créez un nouveau fournisseur Tokios.

Saisissez les informations du fournisseur en attribuant api à openai-completions, en indiquant Tokios dans baseUrl, et en listant votre déploiement sous models :
La valeur de id figurant sous models correspond au nom de déploiement public indiqué dans l’onglet Models, et non à l’ID de modèle local de votre backend.
3

Définissez ce modèle comme modèle par défaut de l’agent.

Indiquez dans les paramètres de l’agent que le modèle par défaut doit provenir du fournisseur nouvellement ajouté, en utilisant la forme <provider>/<model-id>.
4

Saisissez votre clé API.

Définissez TOKIOS_API_KEY dans votre environnement en tant que valeur de votre clé API sk-tok-… au lieu de la coller dans le fichier de configuration, puis redémarrez OpenClaw afin qu’il recharge le connecteur.
Remplacez gemma-tunnel par le nom de déploiement que vous avez enregistré, et attribuez à TOKIOS_API_KEY votre propre clé sk-tok-…. Il est impératif de ne jamais inscrire de clé réelle dans le fichier de configuration. OpenClaw permet également d’utiliser les services d’Anthropic ; pour ce faire, définissez api: "anthropic-messages" avec baseUrl: "https://api.tokios.com" (sans mentionner /v1).

Votre assistant, votre modèle

OpenClaw est l’agent auquel vous envoyez des messages depuis votre téléphone ; Tokios fournit à tout modèle que vous exécutez un point de terminaison stable et authentifié. Le connecteur associé à ce modèle communique avec Tokios, et OpenClaw appelle https://api.tokios.com/v1 en utilisant votre clé API — ainsi votre assistant personnel fonctionne sur un modèle que vous hébergez, sans besoin de port entrant ni de VPN.

Résolution de problèmes

La clé API transmise par OpenClaw est absente, mal formatée ou a été révoquée. Vérifiez que TOKIOS_API_KEY contient bien la clé sk-tok-… complète sans espaces supplémentaires, puis consultez son statut dans l’onglet Keys.
L’ID de modèle ne correspond à aucun déploiement enregistré, ou bien baseUrl ne possède pas /v1. Assurez-vous que l’ID indiqué dans models correspond au nom public figurant dans l’onglet Models, et que baseUrl vaut https://api.tokios.com/v1.
Le connecteur destiné à ce déploiement est hors ligne ou a atteint sa limite de concurrence. Rendez-vous dans l’onglet Connectors : le connecteur doit afficher l’état Online, et la machine l’exécutant doit rester opérationnelle et joignable.

Prochaines étapes

Clients compatibles

Consultez les instructions relatives à l’URL de base et à la configuration de la clé API pour d’autres clients compatibles avec OpenAI et Anthropic.

Clés API

Créez, définissez la portée et renouvelez les clés API sk-tok-… pour vos collègues et agents.