🚀 Connecter OpenClaw / Clawdbot au modèle personnalisé CodingPlanX

Ce tutoriel vous guidera dans l'installation de Clawdbot (OpenClaw) et la configuration du proxy d'API personnalisé, vous permettant d'appeler de manière flexible des modèles tels que GPT-4o, Claude 3.5 et Gemini.

---

🛠️ Étape 1 : Préparation de l'environnement et initialisation de base

Avant de commencer, assurez-vous que l'environnement Node.js est installé sur votre système.

1. Installer Clawdbot globalement

Ouvrez le terminal (CMD ou PowerShell) et exécutez la commande suivante :

npm i -g clawdbot

2. Exécuter le guide d'initialisation

Exécutez le programme de configuration pour terminer les réglages de base. Veuillez suivre les instructions à l'écran :

clawdbot onboard

> [!IMPORTANT] > Avis aux utilisateurs Windows : Dans l'environnement natif, si le système indique que openclaw n'est pas une commande interne, veillez à utiliser uniformément la commande clawdbot.

---

⚙️ Étape 2 : Modifier le fichier de configuration principal clawdbot.json

Cette étape définit l'adresse de l'API du proxy et le mappage des modèles en modifiant le fichier de configuration principal.

Chemin du fichier : C:\Users\VotreNomDUtilisateur\.clawdbot\clawdbot.json (Remarque : Le chemin du tutoriel original était Administrator, veuillez le modifier en fonction de votre nom d'utilisateur réel)

Modifiez les sections agents, auth et models du fichier en vous référant au contenu suivant :

{
  "agents": {
    "defaults": {
      "workspace": "C:\\Users\\Administrator\\clawd",
      "models": {
        "api-proxy-gpt/gpt-4o": { "alias": "GPT-4o" },
        "api-proxy-claude/claude-sonnet-4-5-20250929": { "alias": "Claude Sonnet 4.5" },
        "api-proxy-google/gemini-3-pro-preview": { "alias": "Gemini 3 Pro" }
      },
      "model": {
        "primary": "api-proxy-claude/claude-sonnet-4-5-20250929"
      }
    }
  },
  "auth": {
    "profiles": {
      "api-proxy-gpt:default": { "provider": "api-proxy-gpt", "mode": "api_key" },
      "api-proxy-claude:default": { "provider": "api-proxy-claude", "mode": "api_key" },
      "api-proxy-google:default": { "provider": "api-proxy-google", "mode": "api_key" }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "api-proxy-gpt": {
        "baseUrl": "https://api.codingplanx.ai/v1",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-4o", "name": "GPT-4o", "contextWindow": 128000, "maxTokens": 8192 }
        ]
      },
      "api-proxy-claude": {
        "baseUrl": "https://api.codingplanx.ai",
        "api": "anthropic-messages",
        "models": [
          { "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5", "contextWindow": 200000, "maxTokens": 8192 }
        ]
      },
      "api-proxy-google": {
        "baseUrl": "https://api.codingplanx.ai/v1beta",
        "api": "google-generative-ai",
        "models": [
          { "id": "gemini-3-pro-preview", "name": "Gemini 3 Pro", "contextWindow": 2000000, "maxTokens": 8192 }
        ]
      }
    }
  }
}

---

🔑 Étape 3 : Configurer le fichier d'authentification auth-profiles.json

Dans cette étape, vous devez saisir la vraie clé API obtenue depuis le proxy.

Chemin du fichier : C:\Users\VotreNomDUtilisateur\.clawdbot\agents\main\agent\auth-profiles.json

Veuillez modifier le champ key avec votre propre clé API :

{
  "version": 1,
  "profiles": {
    "api-proxy-gpt:default": {
      "type": "api_key",
      "provider": "api-proxy-gpt",
      "key": "sk-VotreVraieCléGPT"
    },
    "api-proxy-claude:default": {
      "type": "api_key",
      "provider": "api-proxy-claude",
      "key": "sk-VotreVraieCléClaude"
    },
    "api-proxy-google:default": {
      "type": "api_key",
      "provider": "api-proxy-google",
      "key": "sk-VotreVraieCléGoogle"
    }
  },
  "lastGood": {
    "api-proxy-gpt": "api-proxy-gpt:default",
    "api-proxy-claude": "api-proxy-claude:default",
    "api-proxy-google": "api-proxy-google:default"
  }
}

---

🚦 Étape 4 : Vérifier et démarrer le service

Une fois la configuration terminée, vérifiez et exécutez via le processus suivant.

1. Exécuter la vérification de l'état de santé

Vérifiez si la syntaxe de configuration et la connectivité sont normales :

clawdbot doctor

2. Démarrer le service Gateway

Exécutez le service de passerelle pour activer l'Agent IA :

clawdbot gateway

3. Accéder à la console Web

1. Ouvrez votre navigateur et accédez à : http://127.0.0.1:18789/
2. Identifiants de connexion : Utilisez le Token affiché à la fin de l'exécution de clawdbot onboard à la première étape pour vous connecter.
3. Maintenant, vous pouvez commencer à configurer et à utiliser votre Agent IA !

---

💡 Astuce : Si vous changez de fournisseur de proxy, il vous suffit de modifier le baseUrl correspondant dans clawdbot.json et de mettre à jour la key dans auth-profiles.json.