Utilisez les modèles d'Alibaba Cloud Model Studio dans OpenClaw.
Démarrage rapide
- 1
Installer le plugin Qwen
Si le plugin ne peut pas être installé, consultez Configurer avec un fichier de configuration. - 2
Obtenir une clé API
- Token Plan
- Paiement à l'utilisation
- Coding Plan
Obtenez une clé API Token Plan selon votre édition :- Token Plan Personal Edition : Créer ou afficher la clé API
- Token Plan Team Edition : Attribuer un siège et obtenir la clé API
- 3
Configurer le modèle
Exécutez la commande correspondant à votre plan de facturation et saisissez la clé API lorsque vous y êtes invité.- Token Plan
- Paiement à l'utilisation
- Coding Plan
- 4
Vérifier
Exécutez les commandes suivantes pour vérifier la liste des modèles et effectuer un appel de test :
Configurer avec un fichier de configuration
Utilisez cette méthode si le plugin Qwen ne peut pas être installé ou si vous préférez gérer la configuration manuellement.
- 1
Ouvrir ou créer le fichier de configuration
~/.openclaw/openclaw.jsonMettez à jour uniquement les champs concernés dansmodels,agentsetgateway. Ne remplacez pas l'intégralité du fichier. - 2
Écrire la configuration
- Token Plan Édition personnelle
- Token Plan Édition équipe
- Paiement à l'utilisation
- Coding Plan
RemplacezYOUR_API_KEYpar votre clé API Token Plan Édition personnelle.Lors de l'utilisation de qwen4-max-preview, utilisezparams.cacheRetentionpour définirshort,longounone;longutilise un TTL de 1 heure.Lors de l'utilisation de qwen4-max, définissezparams.cacheRetentionsurshort,longounone.longcorrespond à un TTL d'une heure. qwen4-max dispose d'un contexte de 1 M de tokens. La sortie maximale est de 131 072 tokens en mode sans réflexion et de 262 144 tokens pour la réflexion et la réponse finale combinées. Les valeurs par défaut sont reasoning_effort=high et thinking_budget=131072.
gateway.auth.mode: none convient uniquement à une utilisation locale sur une seule machine. Pour partager ou accéder à distance, exécutez openclaw doctor --generate-gateway-token pour générer un jeton, puis redémarrez la passerelle.Connecter les canaux de messagerie
- DingTalk
- WeChat
- QQ
- 1
Créer une application DingTalk et obtenir les identifiants
- Connectez-vous à la plateforme ouverte DingTalk, sélectionnez une organisation pour laquelle vous disposez des autorisations de développeur, ou créez une organisation, puis obtenez les autorisations de développeur.
- Dans la barre de menus supérieure, sélectionnez Développement d'applications, cliquez sur Créer une application, saisissez un nom et une description d'application, puis cliquez sur Enregistrer.
- Sur la page Ajouter des capacités à l'application, ajoutez un Bot. Activez Configuration du bot, renseignez les champs obligatoires, conservez le mode Stream par défaut pour le mode de réception des messages, puis cliquez sur Publier.
- Sur la page Identifiants et informations de base, obtenez le Client ID et le Client Secret.
- Sur la page Gestion des versions et publication, créez une version, définissez la plage de visibilité, enregistrez, puis publiez.
- 2
Installer le plugin de canal DingTalk
La sortie doit inclure le plugindingtalkavec le statutloaded. - 3
Configurer le canal DingTalk
Ajoutez les configurations suivantes à~/.openclaw/openclaw.json. RemplacezYOUR_DINGTALK_APPKEYetYOUR_DINGTALK_APPSECRETpar les identifiants de l'étape 1. N'écrasez pas les configurations existantes telles quemodelsetagents.La définition dedmPolicyetgroupPolicysuropenconvient aux tests ou à un usage personnel. Dans un environnement de production, définissez-les surallowlistet ajoutez le champallowFrom: - 4
Vérifier
Dans la section Channels, DingTalk doit êtreONavec le statutOK - configured. Envoyez un message au bot dans une conversation de groupe DingTalk pour tester la connexion.
Lark
- 1
Créer une application Lark
- Accédez à la plateforme ouverte Lark, cliquez sur Créer une application d'entreprise personnalisée, saisissez un nom et une description d'application, sélectionnez une icône, puis cliquez sur Créer.
- Sur la page Identifiants et informations de base, copiez l'App ID (au format
cli_xxx) et l'App Secret. - Sur la page Gestion des autorisations, cliquez sur Importer/exporter des autorisations par lot, collez le JSON suivant, cliquez sur Suivant, confirmer les nouvelles autorisations, puis cliquez sur Demander l'activation.
- Sur la page Ajouter des capacités à l'application, sélectionnez l'onglet Ajouter par capacité, recherchez la carte Robot, puis cliquez sur Configurer.
- Sous Événements et rappels, dans l'onglet Configuration des événements, définissez Méthode d'abonnement sur Utiliser une connexion de longue durée pour recevoir les événements et enregistrez. Ajoutez ensuite l'événement
im.message.receive_v1. - Sur la page Gestion des versions et publication, créez une version, saisissez le numéro de version et la description de la mise à jour, enregistrez, puis soumettez pour examen et publication.
- 2
Configurer le bot Lark
Exécutezopenclaw channels add, sélectionnez Feishu, puis saisissez l'App ID et l'App Secret. Redémarrez ensuite la passerelle :Ajoutez le bot à une conversation de groupe Lark, ou envoyez un message au bot. Le bot répond par un message contenant un code d'appairage. Copiez la dernière ligne et envoyez-la dans la conversation OpenClaw pour terminer l'appairage. - 3
Vérifier
Dans la section Channels, Lark doit êtreONavec le statutOK. Envoyez un message dans Lark pour tester la connexion.
Codes d'erreur
Si vous rencontrez des erreurs lors de la configuration, consultez la documentation FAQ de votre plan de facturation :
- Token Plan : FAQ Édition personnelle · FAQ Édition équipe
- Paiement à l'usage : Codes d’erreur
- Coding Plan : FAQ Coding Plan
FAQ
Comment utiliser un plan d'économie avec le paiement à l'usage ?
Comment utiliser un plan d'économie avec le paiement à l'usage ?
Comment puis-je afficher les modèles configurés ?
Comment puis-je afficher les modèles configurés ?
openclaw tui dans le terminal pour démarrer la ligne de commande du terminal OpenClaw, puis saisissez /model pour afficher la liste des modèles. Appuyez sur Entrée pour sélectionner un modèle et sur Échap pour quitter la liste.Pourquoi les erreurs HTTP 401: Incorrect API key provided., No API key found for provider xxx, ou HTTP 401: invalid_iam_token se produisent-elles ?
Pourquoi les erreurs HTTP 401: Incorrect API key provided., No API key found for provider xxx, ou HTTP 401: invalid_iam_token se produisent-elles ?
- La clé API n'est pas valide, a expiré, est vide, est mal formatée ou correspond à un mauvais point de terminaison. Assurez-vous que la clé API correspond à votre mode de paiement, qu'elle est copiée intégralement sans espaces supplémentaires et que votre abonnement est actif.
- OpenClaw utilise une configuration incorrecte ou obsolète provenant de son cache de configuration. Supprimez l'élément de configuration
providersde~/.openclaw/agents/main/agent/models.jsonet redémarrez OpenClaw. invalid_iam_tokenindique que la clé API n'a pas réussi l'authentification IAM. Les scénarios courants incluent : la clé API a été révoquée ou désactivée ; la région de la clé API ne correspond pas à la région de l'URL de base (par exemple, la clé API a été créée à Singapour, mais l'URL de base pointe vers une autre région) ; ou un identifiant temporaire STS a expiré. Vérifiez que la clé API et l'URL de base appartiennent à la même région et que le statut de la clé API est actif.
J'ai déjà configuré d'autres canaux, comme DingTalk. Comment puis-je ajouter des modèles pour un nouveau plan en toute sécurité ?
J'ai déjà configuré d'autres canaux, comme DingTalk. Comment puis-je ajouter des modèles pour un nouveau plan en toute sécurité ?
- N'utilisez pas de fonction de remplacement global. Elle écrase les configurations personnalisées. Modifiez uniquement les sections concernées.
- Si OpenClaw répond normalement, saisissez directement les commandes dans une conversation OpenClaw pour fusionner la configuration.
- Si aucun modèle n'est configuré dans OpenClaw ou si OpenClaw ne répond pas, modifiez manuellement
~/.openclaw/openclaw.json. Modifiez uniquement les champs concernés et laissez la configuration existante inchangée.
Que faire si je reçois une erreur device identity required ?
Que faire si je reçois une erreur device identity required ?
- C'est la première fois que vous accédez à l'URL dans un navigateur et l'appairage de l'appareil n'est pas terminé.
- Le cache du navigateur a été vidé, entraînant la perte de la clé de l'appareil.
- Après la réinstallation ou la mise à niveau d'OpenClaw, le fichier de clé du répertoire
~/.openclaw/identity/est manquant.
openclaw devices list pour confirmer que l'appareil apparaît dans la liste Paired.Une consommation de jetons se produit même lorsque OpenClaw n'est pas activement utilisé
Une consommation de jetons se produit même lorsque OpenClaw n'est pas activement utilisé
~/.openclaw/agents/main/sessions/. Les appels heartbeat sont marqués par [OpenClaw heartbeat poll].Solutions :- Arrêtez la passerelle : exécutez
openclaw gateway stoplorsque vous ne l'utilisez pas. Cela arrête immédiatement le heartbeat. - Augmentez l'intervalle de heartbeat : définissez
agents.defaults.heartbeat.everydans~/.openclaw/openclaw.json. Par exemple,"2h"définit l'intervalle sur toutes les 2 heures.