Zeroclaw accède aux API Gemini & Claude à bas prix de Defapi.

Ce tutoriel vous guidera sur la manière d'accéder à divers grands modèles de langage dans Zeroclaw via la plateforme Defapi. En utilisant Defapi, vous pouvez bénéficier d'une expérience totalement compatible avec les interfaces officielles à un coût extrêmement compétitif.

Introduction

Zeroclaw est un environnement d'exécution pour agents IA autonomes basé sur Rust, prenant en charge les interactions avec les utilisateurs via des canaux tels que Telegram, Discord et Slack. Defapi, quant à lui, est une plateforme offrant des API de modèles à un excellent rapport qualité-prix (environ la moitié du prix officiel), supportant un accès mondial stable et une compatibilité totale avec les protocoles API des principaux fournisseurs de modèles (tels que v1/chat/completions, v1/messages, v1beta/models/, etc.).

Opérations spécifiques

L'intégration des modèles via Defapi est très simple. Voici les étapes de configuration spécifiques.

1. Obtenir une API Key

Tout d'abord, visitez le site officiel de Defapi et inscrivez-vous. Obtenez votre API Key dédiée sur la page du modèle dont vous avez besoin (par exemple, les modèles Claude ou Gemini).
Exemple : Page Defapi Claude ou Page Defapi Gemini.

2. Configurer les variables d'environnement

Dans votre terminal ou votre environnement système, configurez la variable d'environnement correspondante avec votre API Key :

Pour le modèle Claude :

export ANTHROPIC_API_KEY="dk-xxxxxxxxxxxxxxxx"

Pour le modèle Gemini :

export GEMINI_API_KEY="dk-xxxxxxxxxxxxxxxx"

3. Modifier le fichier de configuration

Éditez le fichier de configuration principal de Zeroclaw (généralement situé dans ~/.zeroclaw/config.toml) et ajustez la configuration selon le modèle choisi.

Utilisation du modèle Claude (exemple avec Claude Sonnet 4.5) :

default_provider = "anthropic-custom:https://api.defapi.org"
api_key = "dk-xxxxxxxxxxxxxxxx"
default_model = "anthropic/claude-sonnet-4.5"
default_temperature = 0.7

Utilisation du modèle Gemini (exemple avec Gemini 3 Flash) :

default_provider = "custom:https://api.defapi.org"
api_key = "dk-xxxxxxxxxxxxxxxx"
default_model = "gemini-3-flash"
default_temperature = 0.7

Conseil : L'interface de Defapi est parfaitement compatible avec l'interface officielle v1/messages d'Anthropic et l'interface v1beta/models/*:generateContent de Google. Vous pouvez basculer de manière transparente sans modifier le code sous-jacent.

Vérifier si Zeroclaw fonctionne normalement

Une fois la configuration terminée, vous pouvez vérifier si Zeroclaw est correctement connecté à Defapi via les méthodes suivantes.

Méthode 1 : Test par message direct

Lancez Zeroclaw dans le terminal et envoyez un message de test :

zeroclaw agent -m "Hello, can you hear me?"

Si le modèle renvoie une réponse normalement et rapidement, la configuration est réussie.

Méthode 2 : Utiliser les commandes de diagnostic

Zeroclaw dispose de commandes de diagnostic intégrées pour vérifier l'état de fonctionnement :

# Vérifier l'état du système
zeroclaw status

# Exécuter un diagnostic système
zeroclaw doctor

# Lister tous les fournisseurs et modèles disponibles
zeroclaw providers

Méthode 3 : Test de configuration des canaux

Vous pouvez configurer des canaux sociaux (comme Telegram) pour des tests d'interaction réels :

[channels_config.telegram]
bot_token = "123456:your-telegram-token"
allowed_users = ["*"]

5 cas d'utilisation courants

En combinant les avantages de faible coût de Defapi, Zeroclaw peut être largement appliqué dans les scénarios suivants :

Cas 1 : Assistant de revue de code

Examinez automatiquement les bases de code pour identifier les erreurs potentielles, les failles de sécurité et proposer des suggestions d'optimisation.

[agents.code_reviewer]
provider = "anthropic-custom:https://api.defapi.org"
model = "anthropic/claude-sonnet-4.5"
system_prompt = "You are an expert code reviewer. Review the code for bugs, security issues, and best practices."
agentic = false
max_iterations = 1

Cas 2 : Robot de service client intelligent

Fournissez une assistance Q&A rapide et des réponses amicales aux utilisateurs 24h/24 et 7j/7.

[agents.support]
provider = "anthropic-custom:https://api.defapi.org"
model = "anthropic/claude-haiku-4.5"
system_prompt = "You are a helpful customer support agent. Be concise and friendly."
max_iterations = 3

Cas 3 : Assistant de recherche automatisé

Capable de parcourir le web de manière autonome et de synthétiser les résultats, idéal pour les recherches approfondies et la collecte d'informations.

[agents.researcher]
provider = "custom:https://api.defapi.org"
model = "gemini-3-flash"
system_prompt = "You are a research assistant. Search the web and summarize findings."
agentic = true
max_depth = 2
allowed_tools = ["web_search", "http_request", "file_read"]
max_iterations = 8

Cas 4 : Analyste de données

Connectez des fichiers locaux et des outils Shell pour aider à analyser les données et fournir des informations pertinentes.

[agents.analyst]
provider = "anthropic-custom:https://api.defapi.org"
model = "anthropic/claude-sonnet-4.5"
system_prompt = "You are a data analyst. Analyze the provided data and provide insights."
agentic = true
allowed_tools = ["shell", "file_read"]

Cas 5 : Génération de contenu multimodal

Combinez plusieurs sources d'entrée (images, documents) pour générer rapidement des textes marketing créatifs ou du contenu multimédia.

[agents.content_creator]
provider = "custom:https://api.defapi.org"
model = "gemini-3-flash"
system_prompt = "You are a creative content creator. Generate engaging content based on user requests."
agentic = true
allowed_tools = ["web_search", "file_read"]
max_iterations = 3