Vue d’ensemble de l’intégration

OpenClaw propose une intégration initiale via le terminal et l’application macOS. Toutes deux commencent par établir l’inférence : elles détectent les accès existants à l’IA, exigent une complétion réelle, puis lancent Crestodian afin de configurer le reste de l’installation. Si un Gateway accessible et configuré dont l’agent par défaut dispose déjà d’un modèle configuré est détecté, l’intégration initiale est ignorée et l’interface utilisateur normale de l’agent s’ouvre. Le parcours dans le terminal propose également l’assistant classique complet pour une configuration détaillée.

Quel parcours dois-je utiliser ?

La plupart des utilisateurs devraient commencer par l’intégration initiale via la CLI : elle fonctionne partout et offre le plus de contrôle.

Ce que configure l’intégration initiale

La phase guidée d’inférence établit uniquement :

1. Fournisseur de modèle et authentification — accès détecté ou clé API vérifiée
2. Inférence vérifiée — une véritable complétion avec le modèle effectif de l’agent par défaut

Une fois cette complétion réussie, Crestodian peut configurer l’espace de travail, le Gateway, le service Gateway, les canaux, les agents, les plugins et d’autres fonctionnalités facultatives.

L’assistant classique de la CLI peut également configurer :

1. Canaux (facultatif) — canaux de discussion intégrés et fournis, tels que Discord, Feishu, Google Chat, iMessage, Mattermost, Microsoft Teams, Telegram, WhatsApp, entre autres
2. Contrôles avancés du Gateway — mode distant, paramètres réseau et choix du démon

Intégration initiale via la CLI

Exécutez dans n’importe quel terminal :

openclaw onboard

Le parcours guidé détecte les accès existants à l’IA, teste en conditions réelles les options dans l’ordre, passe à la suivante en cas d’échec et propose la saisie manuelle masquée d’une clé. Il n’enregistre le modèle et les identifiants qu’après une complétion réussie, puis lance Crestodian pour configurer l’espace de travail, le Gateway, les canaux, les agents, les plugins et d’autres fonctionnalités facultatives. Il n’existe ni Crestodian avant l’inférence, ni parcours permettant d’ignorer l’IA, ni basculement vers l’assistant classique au sein du parcours. Quittez, puis exécutez openclaw onboard --classic si vous préférez utiliser l’assistant classique.

Une fois l’inférence réussie, Crestodian peut confier la configuration des canaux à un assistant de terminal avec saisie masquée. Il n’ouvre pas la configuration guidée ou classique du fournisseur ; quittez Crestodian et exécutez openclaw onboard pour modifier le fournisseur de modèle ou son authentification.

Utilisez openclaw onboard --classic pour une configuration détaillée du modèle et de l’authentification, des canaux, des Skills, du Gateway distant ou de l’importation. L’ajout de --install-daemon sélectionne également le parcours classique et installe le service en arrière-plan en une seule étape. Utilisez openclaw crestodian pour une configuration conversationnelle hors inférence et les réparations. openclaw onboard --modern est un alias de compatibilité qui utilise la même étape obligatoire d’inférence en conditions réelles.

Référence complète : Intégration initiale (CLI) Documentation de la commande CLI : openclaw onboard

Intégration initiale via l’application macOS

Ouvrez l’application OpenClaw. Si son Gateway local ou distant configuré est accessible et que l’agent par défaut dispose déjà d’un modèle configuré, l’application ignore l’intégration initiale et Crestodian, puis ouvre immédiatement l’interface utilisateur normale de l’agent.

Pour un Gateway nouveau ou incomplet, le parcours de premier lancement détecte les accès existants à l’IA (Claude Code, Codex ou clés API), teste en conditions réelles la meilleure option et ne l’enregistre qu’après une réponse réelle ; il se rabat automatiquement sur l’option suivante et propose une étape vérifiée de saisie manuelle de la clé API si rien n’est trouvé. Les identifiants sensibles utilisent une saisie masquée. Une fois l’inférence réussie, Crestodian démarre et aide à configurer le reste.

Gemini CLI reste disponible pour les agents ordinaires après la configuration, mais n’est pas proposé pour cette étape obligatoire d’inférence, car il ne permet pas d’imposer la sonde sans outil.

Référence complète : Intégration initiale (application macOS)

Fournisseurs personnalisés ou non répertoriés

Si votre fournisseur n’est pas répertorié, exécutez openclaw onboard --classic, choisissez Fournisseur personnalisé, puis saisissez :

• Compatibilité du point de terminaison : compatible avec OpenAI (/chat/completions), compatible avec OpenAI Responses (/responses), compatible avec Anthropic (/messages) ou inconnue (teste les trois et effectue une détection automatique)
• URL de base et clé API (la clé API est facultative si le point de terminaison n’en exige pas)
• Identifiant du modèle et alias facultatif du modèle

Plusieurs points de terminaison personnalisés peuvent coexister : chacun reçoit son propre identifiant de point de terminaison.

Pages connexes

• Bien démarrer
• Référence de configuration de la CLI