Configuration du provider

Apportez votre propre clé API#

SpineOS fonctionne en BYOK (Bring Your Own Key) : votre agent utilise votre propre clé API ou votre propre compte IA, et SpineOS ne facture aucune marge sur l'utilisation des modèles. Le chemin de ses requêtes dépend de l'agent :

• OpenClaw : directement de votre bureau à votre fournisseur, avec la clé API collée ou le compte ChatGPT connecté.
• Claude Code : directement de votre bureau à Anthropic, avec votre identifiant Claude ou votre clé API Anthropic.
• Hermes Agent : directement de votre bureau à votre fournisseur, avec la clé API collée.
• Codex : directement de votre bureau à OpenAI avec une clé API OpenAI, ou en mode "ChatGPT — connexion sur votre bureau". En mode "ChatGPT — via SpineOS", ses requêtes passent par SpineOS, qui dialogue avec ChatGPT à votre place et garde votre identifiant ChatGPT de notre côté.
• Grok : directement de votre bureau à xAI, avec le compte auquel vous vous y connectez.

Providers supportés#

Anthropic#

Le provider des modèles Claude. Performant en raisonnement, code et tâches à long contexte.

Format de clé API : sk-ant-api03-...

Obtenir votre clé : console.anthropic.com -- allez dans API Keys et créez une nouvelle clé.

OpenAI#

Le provider des modèles GPT. Bon en tâches générales, function calling et sorties structurées.

Format de clé API : sk-...

Obtenir votre clé : platform.openai.com -- allez dans API Keys dans les paramètres de votre compte.

OpenRouter#

Un gateway unifié vers plus de 200 modèles de multiples providers. Pratique si vous voulez accéder à de nombreux modèles avec une seule clé.

Format de clé API : sk-or-v1-...

Obtenir votre clé : openrouter.ai -- créez un compte et générez une clé API.

Configurer votre provider#

Lors de la création du bureau#

1. Cliquez sur "Nouveau bureau" dans le tableau de bord.
2. Dans la section de configuration du provider, sélectionnez votre provider.
3. Entrez votre clé API.
4. Choisissez un modèle (ou utilisez le modèle par défaut du provider).
5. Créez votre bureau.

Sur un bureau existant#

Une clé API de fournisseur est donnée à un bureau à sa création, et aucun réglage ne la change ensuite. Ce que vous pouvez changer dépend de l'agent :

• OpenClaw : sur un bureau qui fonctionne avec un compte ChatGPT, le bouton "Compte ChatGPT" au-dessus du chat ouvre "Compte ChatGPT pour ce bureau", où vous choisissez un autre compte connecté dans les Paramètres, sous ChatGPT. Un bureau OpenClaw créé avec une clé API garde cette clé : créez un nouveau bureau pour utiliser un autre fournisseur ou une autre clé.
• Claude Code : si ce bureau est à vous, le bouton Claude de sa barre d'outils ouvre "Identifiant Claude pour ce bureau", où vous choisissez un autre identifiant Claude connecté dans les Paramètres, sous Claude. Le changement s'applique tout de suite, ou après un redémarrage quand la page affiche "Redémarrez ce bureau pour appliquer le nouvel identifiant".
• Hermes Agent : créez un nouveau bureau pour utiliser un autre fournisseur ou une autre clé API.
• Codex : sur un bureau qui fonctionne avec un compte ChatGPT, le bouton "Compte ChatGPT" au-dessus du chat ouvre "Compte ChatGPT pour ce bureau", où vous choisissez un autre compte connecté dans les Paramètres, sous ChatGPT. Un bureau Codex créé avec une clé API OpenAI garde cette clé.
• Grok : il n'y a pas de clé à changer. Grok se connecte avec votre compte xAI directement sur votre bureau.

Le modèle n'est pas figé : quand la zone de saisie du chat propose un menu de modèles, choisissez-en un autre.

Sécurité des clés#

Votre clé API est chiffrée au repos dans la base de données SpineOS. Elle est injectée dans la VM au démarrage lors de l'initialisation. La clé n'est plus affichée dans l'interface du dashboard après la saisie.

L'équipe SpineOS ne peut pas voir votre clé API. Si vous la perdez, vous devrez en générer une nouvelle depuis la console de votre provider.

Vérifier votre configuration#

Après le démarrage du bureau, vérifiez la configuration du provider en envoyant un message test dans le panneau chat. Si l'agent répond, votre provider est correctement configuré. La zone de saisie du chat affiche le modèle de votre bureau, et une réponse affiche le modèle qui l'a écrite.

Problèmes courants#

Conseils#

• Si vous hésitez sur le provider, Claude d'Anthropic gère bien la plupart des tâches d'agent.
• OpenRouter est pratique pour expérimenter puisque vous pouvez changer de modèle sans changer de clé.
• Gardez votre clé API confidentielle. Si vous pensez qu'elle a été compromise, faites-la tourner immédiatement dans la console de votre provider.