Configuration du provider

Configurez Anthropic, OpenAI ou OpenRouter comme provider IA avec votre propre cle API.

3 min de lecture

Apportez votre propre cle API

Le Bureau fonctionne en BYOK (Bring Your Own Key). Vous fournissez votre propre cle API d'Anthropic, OpenAI ou OpenRouter, et votre agent l'utilise directement. Le Bureau ne fait pas transiter votre trafic API et ne facture aucune marge sur l'utilisation des modeles.

Providers supportes

Anthropic

Le provider des modeles Claude. Performant en raisonnement, code et taches a long contexte.

Format de cle API : sk-ant-api03-...

Obtenir votre cle : console.anthropic.com -- allez dans API Keys et creez une nouvelle cle.

OpenAI

Le provider des modeles GPT. Bon en taches generales, function calling et sorties structurees.

Format de cle API : sk-...

Obtenir votre cle : platform.openai.com -- allez dans API Keys dans les parametres de votre compte.

OpenRouter

Un gateway unifie vers plus de 200 modeles de multiples providers. Pratique si vous voulez acceder a de nombreux modeles avec une seule cle.

Format de cle API : sk-or-v1-...

Obtenir votre cle : openrouter.ai -- creez un compte et generez une cle API.

Configurer votre provider

Lors de la creation du bureau

  1. Cliquez sur New Desktop dans le dashboard.
  2. Dans la section de configuration du provider, selectionnez votre provider.
  3. Entrez votre cle API.
  4. Choisissez un modele (ou utilisez le modele par defaut du provider).
  5. Configurez optionnellement un modele de fallback.
  6. Creez le bureau.

Sur un bureau existant

  1. Ouvrez les parametres de votre bureau.
  2. Allez dans la section de configuration du provider.
  3. Mettez a jour le provider, la cle API ou le modele.
  4. Redemarrez le bureau pour appliquer les changements.

Securite des cles

Votre cle API est chiffree au repos dans la base de donnees Le Bureau. Elle est injectee dans la VM au demarrage via cloud-init et stockee dans le fichier de configuration OpenClaw. La cle n'est plus affichee dans l'interface du dashboard apres la saisie.

L'equipe Le Bureau ne peut pas voir votre cle API. Si vous la perdez, vous devrez en generer une nouvelle depuis la console de votre provider.

Verifier votre configuration

Apres le demarrage du bureau, vous pouvez verifier la configuration du provider depuis le terminal :

cat ~/.openclaw/openclaw.json | jq '.provider'

Cela affiche le provider et le modele configures. La cle API est presente dans le fichier mais ne doit pas etre partagee.

Problemes courants

ProblemeCauseSolution
Agent ne repond pasCle API invalide ou expireeGenerez une nouvelle cle depuis votre provider
"No provider configured"Bureau cree sans configuration providerMettez a jour les parametres et redemarrez
Erreurs de rate limitTrop de requetes vers le providerAjoutez un modele de fallback ou attendez la reinitialisation des limites
Modele introuvableErreur de frappe ou modele obsoleteVerifiez la liste des modeles du provider et mettez a jour

Conseils

  • Si vous hesitez sur le provider, Claude d'Anthropic gere bien la plupart des taches d'agent.
  • OpenRouter est pratique pour experimenter puisque vous pouvez changer de modele sans changer de cle.
  • Configurez un modele de fallback pour eviter les interruptions lors des rate limits.
  • Gardez votre cle API confidentielle. Si vous pensez qu'elle a ete compromise, faites-la tourner immediatement dans la console de votre provider.