OpenClaw

OpenClaw est un assistant de programmation en ligne de commande qui prend en charge la connexion à des services API compatibles OpenAI via un provider personnalisé. La méthode officiellement recommandée consiste à passer par l'assistant openclaw onboard, mais vous pouvez aussi écrire le fichier de configuration à la main.

PrérequisCopier le lien d’ancre

Assurez-vous que le système remplit les conditions suivantes :

• Node.js 22 ou supérieur
• macOS / Linux / Windows
• Une installation supplémentaire de pnpm si vous compilez depuis les sources

Installation de Node.jsCopier le lien d’ancre

macOS (avec Homebrew) :

brew install node

Autres systèmes :

Téléchargez la version LTS depuis le site officiel de Node.js : https://nodejs.org/en/download

Vérification de l'installationCopier le lien d’ancre

node -v
npm -v

Remarque : sous Windows, il est conseillé d'exécuter OpenClaw dans un environnement WSL2.

Installation d'OpenClawCopier le lien d’ancre

Utilisez le script d'installation officiel (recommandé) :

macOS / LinuxCopier le lien d’ancre

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShellCopier le lien d’ancre

iwr -useb https://openclaw.ai/install.ps1 | iex

Le script d'installation détecte et complète automatiquement les dépendances manquantes. Si vous gérez déjà vous-même votre environnement Node, vous pouvez aussi installer via npm ou pnpm (voir la documentation officielle).

Lancement de l'assistant de configurationCopier le lien d’ancre

Exécutez la commande de l'assistant :

openclaw onboard

Renseignez ensuite, dans l'assistant, les informations suivantes :

• Type de provider : choisissez Custom Provider
• Compatibility : choisissez OpenAI-compatible
• Base URL : https://aicentos.com/v1
• API Key : renseignez votre clé API
• Model ID : reportez-vous aux noms de modèles de la « place de marché des modèles » de la console
• Endpoint ID : il est conseillé de saisir aicentos

Remarque : la clé API peut être saisie directement en clair ; inutile de la remplacer par la variable d'environnement OPENAI_API_KEY.

Définition du modèle par défautCopier le lien d’ancre

Une fois l'assistant terminé, définissez le modèle par défaut sur :

aicentos/gpt-4o

Les utilisations suivantes reprendront automatiquement le modèle configuré.

Configuration manuelle (facultatif)Copier le lien d’ancre

Si vous n'utilisez pas l'assistant, vous pouvez écrire directement le fichier de configuration des providers d'OpenClaw :

{
  "models": {
    "providers": {
      "aicentos": {
        "baseUrl": "https://aicentos.com/v1",
        "apiKey": "your_api_key_here",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-4o", "name": "gpt-4o" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "aicentos/gpt-4o" }
    }
  }
}

La clé API peut être écrite en clair dans la configuration, ou référencée via une variable d'environnement (si vous préférez l'approche SecretRef).

Vérification de la configurationCopier le lien d’ancre

Contrôlez l'état des modèles pour confirmer que la connexion fonctionne :

openclaw models list
openclaw models status

Si vous voyez aicentos/gpt-4o avec un état normal, la configuration est opérationnelle.

RemarquesCopier le lien d’ancre

• OpenClaw prend en charge officiellement les providers personnalisés, avec un mode OpenAI-compatible ou Anthropic-compatible au choix
• Pour ce service, privilégiez le mode OpenAI-compatible
• Saisir directement la clé API est l'approche par défaut ; la référence par variable d'environnement n'est qu'une option
• Si vous souhaitez qu'un outil écrive la configuration pour vous, vous pouvez envisager l'outil cc-switch
• La documentation officielle décrit d'autres méthodes d'installation et de configuration, à choisir selon vos besoins

Liens utilesCopier le lien d’ancre

• Documentation officielle : https://docs.openclaw.ai/install/index