Tutoriel sur l'intégration de l'API Gemini dans Clawdbot (Moltbot/OpenClaw)

Tutoriel complet sur l'intégration de Gemini 3 Flash dans Clawdbot (Moltbot/OpenClaw) via le proxy defapi.org

Clawdbot offre nativement le support le plus complet pour le tool use d'Anthropic Claude. Cependant, la série Gemini (particulièrement le Gemini 3 Flash, rapide et doté d'un contexte ultra-long) excelle dans la recherche, les réponses rapides et les tâches multimodales. L'intégration directe de l'API officielle Google Gemini dans Clawdbot nécessite généralement une couche de conversion de format complexe (comme litellm ou un relay personnalisé). defapi.org propose une solution quasiment sans modification : il encapsule Gemini dans une interface compatible avec le style Anthropic/OpenAI, avec une excellente transmission pour le tool calling.

Point fort majeur : En utilisant Gemini 3 Flash via defapi.org, le coût réel est environ 50 % moins cher que l'API officielle de Google (basé sur des tests communautaires et des comparaisons de tarifs de 2026 : Gemini 3 Flash officiel Entrée ≈ 0,50 $ – 1,00 $ / 1M tokens, Sortie 3,00 $ + ; le proxy defapi offre généralement une réduction de 40 à 60 %, ce qui permet d'économiser plus de la moitié du budget en cas d'utilisation intensive, idéal pour les scénarios d'agent comme Clawdbot avec des tool calls fréquents).

Voici les étapes d'intégration les plus récentes et stables pour 2026.

1. Prérequis

• Clawdbot installé (version utilisée pour ce test : 2026.1.24-3 (885167d)). Pour un nouveau serveur, utilisez les commandes suivantes pour une installation rapide :

  # Installer fnm et Node.js 24
  curl -o- https://fnm.vercel.app/install | bash
  source ~/.bashrc
  fnm install 24
  
  # Installer clawdbot
  npm install -g clawdbot
  

• Un compte defapi.org ( https://defapi.org ), avec du crédit (supporte Alipay/WeChat/Carte de crédit).
• Clé API : Obtenez votre clé API defapi dans le tableau de bord (format commençant par dk-).

2. Pourquoi choisir defapi plutôt que l'officiel ou d'autres proxys ?

Projet	defapi.org (gemini-3-flash)	Google Officiel Gemini API	Autres proxys (OpenRouter / LiteLLM)
Difficulté d'accès	Très faible (3 lignes de config)	Élevée (couche de conversion)	Moyenne (choisir le bon modèle)
Compatibilité Tool calling	Excellente (support function/tool role)	Nécessite une adaptation	Dépend du proxy
Longueur de contexte	1M tokens (support natif)	1M tokens	Généralement supporté
Multimodal (Image/Texte)	Supporté (Clawdbot peut upload)	Supporté	Support partiel
Coût (vs Officiel)	Environ 50 % moins cher	Prix de base	20–40 % moins cher
Latence	Légèrement supérieure, mais acceptable	Minimale	Moyenne

En résumé : Pour les utilisateurs de Clawdbot sensibles au budget et souhaitant utiliser Gemini 3 Flash rapidement, defapi est l'option la plus pertinente actuellement.

3. Étapes de configuration détaillées

La dernière version de Clawdbot (2026.1.24-3 (885167d)) recommande l'utilisation d'un fichier de configuration au format JSON.

1. Créer le fichier de configuration

   Créez ou modifiez ~/.clawdbot/clawdbot.json dans votre répertoire utilisateur :

   mkdir -p ~/.clawdbot
   vi ~/.clawdbot/clawdbot.json
   

2. Écrire le contenu de la configuration

   Insérez le contenu suivant dans clawdbot.json. Assurez-vous de remplacer apiKey par votre véritable clé defapi :

   {
       "gateway": {
           "mode": "local",
           "bind": "loopback",
           "port": 18789
       },
       "agents": {
           "defaults": {
               "model": {
                   "primary": "gemini/gemini-3-flash"
               },
               "elevatedDefault": "full",
               "workspace": "/myworkspace",
               "compaction": {
                   "mode": "safeguard"
               },
               "maxConcurrent": 4,
               "subagents": {
                   "maxConcurrent": 8
               }
           }
       },
       "models": {
           "mode": "merge",
           "providers": {
               "gemini": {
                   "baseUrl": "https://api.defapi.org/v1",
                   "apiKey": "Votre clé API defapi commençant par dk-*",
                   "api": "openai-completions",
                   "models": [
                       {
                           "id": "gemini-3-flash",
                           "name": "gemini-3-flash"
                       }
                   ]
               }
           }
       },
       "channels": {
           "telegram": {
               "botToken": "Votre TG Token (optionnel)"
           }
       },
       "plugins": {
           "entries": {
               "telegram": {
                   "enabled": true
               }
           }
       }
   }
   

   Explications des points clés :

   • baseUrl : Doit être https://api.defapi.org/v1.
   • api : Utilisez openai-completions, l'interface Gemini de defapi est parfaitement compatible avec le format OpenAI.
   • primary model : Le format de référence est provider/model_id, soit gemini/gemini-3-flash.

3. Tester le fonctionnement

   clawdbot agent --message "hi" --agent main
   

   Sortie attendue :

   root@iZ6wefjkouvkogu7drkjvfZ:~# clawdbot agent --message "hi" --agent main
   
   🦞 Clawdbot 2026.1.24-3 (885167d) — Pairing codes exist because even bots believe in consent—and good security hygiene.
   
   │
   ◇
   Gateway agent failed; falling back to embedded: Error: gateway closed (1006 abnormal closure (no close frame)): no close reason
   Gateway target: ws://127.0.0.1:18789
   Source: local loopback
   Config: /root/.clawdbot/clawdbot.json
   Bind: loopback
   Hey. I just came online.
   
   Who am I? Who are you?
   
   The `BOOTSTRAP.md` file tells me this is a fresh workspace, which means we get to figure this out from scratch. I've got plenty of tools and potential, but I'm missing a name, a vibe, and a sense of who I'm helping.
   
   What should we call me? And what's your name?