Intégration de l'API Claude dans OpenClaw

Documentation maintenue par 1ZheAI. Sources et corrections.

Vous avez trouvé une erreur ? Contactez l’assistance en indiquant l’adresse de la page et une description. N’envoyez pas de clés API ni d’identifiants de compte.

Utilisez la fonctionnalité de fournisseur personnalisé d’OpenClaw pour vous connecter à 1折AI. Commencez par créer une clé API et confirmez les modèles actuellement disponibles ; les ID de modèle ci-dessous sont des exemples, veuillez les ajuster en fonction des permissions de votre clé.

Date de vérification de la configuration officielle : 2026-10-15. La configuration suivante est basée sur la documentation officielle ; la vérification de bout en bout sur ce site n’est pas encore terminée ; veuillez d’abord effectuer une courte question-réponse et une vérification d’appel d’outil avant de l’utiliser pour des tâches longues. Les modèles OpenAI / GPT sont en ligne, la liste des modèles et les prix sont disponibles dans la description des modèles.

Sur la base du fournisseur personnalisé et de l’exemple de configuration, fusionnez dans ~/.openclaw/openclaw.json :

json

{
  "agents": {
    "defaults": {
      "model": { "primary": "onezhe/claude-sonnet-4-6" },
      "models": { "onezhe/claude-sonnet-4-6": { "alias": "1折AI Claude" } }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "onezhe": {
        "baseUrl": "https://1zheai.com",
        "apiKey": "${ONEZHE_API_KEY}",
        "api": "anthropic-messages",
        "models": [
          { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }
        ]
      }
    }
  }
}

Assurez-vous que le processus exécutant réellement la Gateway peut lire ONEZHE_API_KEY ; les variables d’environnement dans le terminal ne sont pas nécessairement transmises à un service d’arrière-plan existant. La documentation officielle Synthetic indique explicitement que le client Anthropic ajoute automatiquement /v1, donc ici nous n’incluons pas /v1 et ne remplissons pas le /v1/messages complet.

Lors du passage à Chat Completions, remplacez par paires par baseUrl: "https://1zheai.com/v1" et api: "openai-completions". Bien que le nom contienne completions, cet adaptateur correspond à /v1/chat/completions ; ne sélectionnez pas par erreur openai-responses. La liste blanche des modèles existante doit conserver les autres entrées et ajouter le nouveau modèle. L’exemple n’invente pas de coûts ou de paramètres de contexte ; si la version actuellement installée nécessite des métadonnées supplémentaires pour la validation, vérifiez d’abord les capacités réelles du modèle avant de les ajouter.

Vérification de l’intégration et dépannage

1. Enregistrez et rechargez la configuration, confirmez que le fournisseur sélectionné est onezhe ou le modèle personnalisé que vous avez ajouté.
2. Envoyez une question courte, confirmez qu’elle peut être retournée ; puis essayez une petite tâche annulable, confirmez séparément l’appel d’outil et la conversation multi-tours.
3. Ouvrez les journaux d’appels, vérifiez l’heure de la requête, le modèle, le statut et l’utilisation. Une réponse textuelle réussie ne signifie pas que toutes les capacités des Agents sont compatibles.
4. En cas de 404, vérifiez que l’adresse et le protocole de cet article sont assortis ; en cas de 401, vérifiez l’origine de la clé et si le processus a lu les variables d’environnement ; en cas de 429, consultez les informations de limitation de débit avant de réessayer. Pour plus de cas, voir les codes d’erreur et le dépannage.

Les clés ne sont stockées que dans l’environnement local ou le stockage d’identifiants de l’outil ; ne les soumettez pas à un dépôt de code, à des captures d’écran ou à des journaux publics. Les services d’arrière-plan peuvent ne pas hériter des variables d’environnement du terminal ; les modèles auxiliaires, la recherche et d’autres outils peuvent également avoir des paramètres de fournisseur indépendants qui doivent être vérifiés séparément.

Coûts et autres méthodes d’intégration

Consultez les prix en temps réel de l’API Claude et les règles de facturation. Pour d’autres clients, retournez au catalogue d’intégration des outils ; pour écrire votre propre programme, utilisez le SDK et le guide de développement.