Skip to main content

OpenClaw

Utilisez les modèles d'Alibaba Cloud Model Studio dans OpenClaw.

Démarrage rapide

  1. 1

    Installer le plugin Qwen

    openclaw plugins install @openclaw/qwen-provider
    
    Si le plugin ne peut pas être installé, consultez Configurer avec un fichier de configuration.
  2. 2

    Obtenir une clé API

    • Token Plan
    • Paiement à l'utilisation
    • Coding Plan
    Obtenez une clé API Token Plan selon votre édition :
  3. 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
    openclaw onboard --auth-choice qwen-token-plan-cn
    
  4. 4

    Vérifier

    Exécutez les commandes suivantes pour vérifier la liste des modèles et effectuer un appel de test :
    openclaw models list --provider qwen-token-plan
    openclaw agent --model qwen-token-plan/qwen3.8-max --message "Reply with: ok"
    

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. 1

    Ouvrir ou créer le fichier de configuration

    ~/.openclaw/openclaw.jsonMettez à jour uniquement les champs concernés dans models, agents et gateway. Ne remplacez pas l'intégralité du fichier.
  2. 2

    Écrire la configuration

    • Token Plan Édition personnelle
    • Token Plan Édition équipe
    • Paiement à l'utilisation
    • Coding Plan
    Remplacez YOUR_API_KEY par votre clé API Token Plan Édition personnelle.
    {
      "models": {
        "mode": "merge",
        "providers": {
          "bailian-token-plan": {
            "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
            "apiKey": "YOUR_API_KEY",
            "api": "anthropic-messages",
            "models": [
              {
                "id": "auto",
                "name": "auto",
                "reasoning": false,
                "input": [
                  "text"
                ],
                "contextWindow": 1000000,
                "maxTokens": 393216,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "qwen4-max-preview",
                "name": "qwen4-max-preview",
                "reasoning": true,
                "input": [
                  "text",
                  "image"
                ],
                "contextWindow": 1000000,
                "maxTokens": 131072,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "qwen4-max",
                "name": "qwen4-max",
                "reasoning": true,
                "input": [
                  "text",
                  "image"
                ],
                "contextWindow": 1000000,
                "maxTokens": 262144,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "qwen3.8-max",
                "name": "qwen3.8-max",
                "reasoning": true,
                "input": [
                  "text",
                  "image"
                ],
                "contextWindow": 1000000,
                "maxTokens": 131072,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "qwen3.8-flash",
                "name": "qwen3.8-flash",
                "reasoning": true,
                "input": [
                  "text",
                  "image"
                ],
                "contextWindow": 1000000,
                "maxTokens": 131072,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "qwen3.7-max",
                "name": "qwen3.7-max",
                "reasoning": true,
                "input": [
                  "text"
                ],
                "contextWindow": 1000000,
                "maxTokens": 65536,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "qwen3.7-plus",
                "name": "qwen3.7-plus",
                "reasoning": true,
                "input": [
                  "text",
                  "image"
                ],
                "contextWindow": 1000000,
                "maxTokens": 65536,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "qwen3.6-flash",
                "name": "qwen3.6-flash",
                "reasoning": true,
                "input": [
                  "text",
                  "image"
                ],
                "contextWindow": 1000000,
                "maxTokens": 65536,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "deepseek-v4.1-flash",
                "name": "deepseek-v4.1-flash",
                "reasoning": true,
                "input": [
                  "text",
                  "image"
                ],
                "contextWindow": 1000000,
                "maxTokens": 65536,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "deepseek-v4.1-flash-1017",
                "name": "deepseek-v4.1-flash-1017",
                "reasoning": true,
                "input": [
                  "text",
                  "image"
                ],
                "contextWindow": 1000000,
                "maxTokens": 65536,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "deepseek-v4-pro",
                "name": "deepseek-v4-pro",
                "reasoning": true,
                "input": [
                  "text"
                ],
                "contextWindow": 1000000,
                "maxTokens": 65536,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "deepseek-v4-pro-0813",
                "name": "deepseek-v4-pro-0813",
                "reasoning": true,
                "input": [
                  "text"
                ],
                "contextWindow": 1000000,
                "maxTokens": 65536,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "deepseek-v4-flash-0731",
                "name": "deepseek-v4-flash-0731",
                "reasoning": true,
                "input": [
                  "text"
                ],
                "contextWindow": 1000000,
                "maxTokens": 65536,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "glm-5.3",
                "name": "glm-5.3",
                "reasoning": true,
                "input": [
                  "text"
                ],
                "contextWindow": 202752,
                "maxTokens": 16384,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "glm-5.2",
                "name": "glm-5.2",
                "reasoning": true,
                "input": [
                  "text"
                ],
                "contextWindow": 202752,
                "maxTokens": 16384,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              }
            ]
          }
        }
      },
      "agents": {
        "defaults": {
          "model": {
            "primary": "bailian-token-plan/auto"
          }
        }
      },
      "gateway": {
        "mode": "local",
        "auth": {
          "mode": "none"
        }
      }
    }
    
    Lors de l'utilisation de qwen4-max-preview, utilisez params.cacheRetention pour définir short, long ou none ; long utilise un TTL de 1 heure.
    Lors de l'utilisation de qwen4-max, définissez params.cacheRetention sur short, long ou none. long correspond à 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
Si vous déployez OpenClaw avec Simple Application Server ou Elastic Desktop Service, le plugin DingTalk est généralement préinstallé et peut être configuré dans l'interface graphique.
  1. 1

    Créer une application DingTalk et obtenir les identifiants

    1. 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.
    2. 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.
    3. 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.
    4. Sur la page Identifiants et informations de base, obtenez le Client ID et le Client Secret.
    5. Sur la page Gestion des versions et publication, créez une version, définissez la plage de visibilité, enregistrez, puis publiez.
  2. 2

    Installer le plugin de canal DingTalk

    openclaw plugins install @soimy/dingtalk
    openclaw plugins list
    
    La sortie doit inclure le plugin dingtalk avec le statut loaded.
  3. 3

    Configurer le canal DingTalk

    Ajoutez les configurations suivantes à ~/.openclaw/openclaw.json. Remplacez YOUR_DINGTALK_APPKEY et YOUR_DINGTALK_APPSECRET par les identifiants de l'étape 1. N'écrasez pas les configurations existantes telles que models et agents.
    {
      "channels": {
        "dingtalk": {
          "enabled": true,
          "clientId": "YOUR_DINGTALK_APPKEY",
          "clientSecret": "YOUR_DINGTALK_APPSECRET",
          "robotCode": "YOUR_DINGTALK_APPKEY",
          "dmPolicy": "open",
          "groupPolicy": "open",
          "messageType": "markdown"
        }
      },
      "plugins": {
        "allow": ["dingtalk"],
        "entries": {
          "dingtalk": {
            "enabled": true
          }
        }
      }
    }
    
    La définition de dmPolicy et groupPolicy sur open convient aux tests ou à un usage personnel. Dans un environnement de production, définissez-les sur allowlist et ajoutez le champ allowFrom :
    "dmPolicy": "allowlist",
    "groupPolicy": "allowlist",
    "allowFrom": ["your-employee-id", "group-id"]
    
  4. 4

    Vérifier

    openclaw gateway restart
    openclaw status
    
    Dans la section Channels, DingTalk doit être ON avec le statut OK - configured. Envoyez un message au bot dans une conversation de groupe DingTalk pour tester la connexion.

Lark

  1. 1

    Créer une application Lark

    1. 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.
    2. Sur la page Identifiants et informations de base, copiez l'App ID (au format cli_xxx) et l'App Secret.
    3. 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.
    {
      "scopes": {
        "tenant": [
          "aily:file:read",
          "aily:file:write",
          "application:application.app_message_stats.overview:readonly",
          "application:application:self_manage",
          "application:bot.menu:write",
          "cardkit:card:write",
          "contact:user.employee_id:readonly",
          "corehr:file:download",
          "docs:document.content:read",
          "event:ip_list",
          "im:chat",
          "im:chat.access_event.bot_p2p_chat:read",
          "im:chat.members:bot_access",
          "im:message",
          "im:message.group_at_msg:readonly",
          "im:message.group_msg",
          "im:message.p2p_msg:readonly",
          "im:message:readonly",
          "im:message:send_as_bot",
          "im:resource",
          "sheets:spreadsheet",
          "wiki:wiki:readonly"
        ],
        "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
      }
    }
    
    1. Sur la page Ajouter des capacités à l'application, sélectionnez l'onglet Ajouter par capacité, recherchez la carte Robot, puis cliquez sur Configurer.
    2. 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.
    3. 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. 2

    Configurer le bot Lark

    Exécutez openclaw channels add, sélectionnez Feishu, puis saisissez l'App ID et l'App Secret. Redémarrez ensuite la passerelle :
    openclaw gateway restart
    
    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. 3

    Vérifier

    openclaw status
    
    Dans la section Channels, Lark doit être ON avec le statut OK. 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 :

FAQ

La configuration du paiement à l'usage reste la même : utilisez la clé API générale Model Studio et l'URL de base. Après l'achat d'un plan d'économie, il prend effet automatiquement et l'utilisation éligible est déduite automatiquement. Consultez Plans d'économie.
Saisissez 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.
Causes possibles :
  1. 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.
  2. OpenClaw utilise une configuration incorrecte ou obsolète provenant de son cache de configuration. Supprimez l'élément de configuration providers de ~/.openclaw/agents/main/agent/models.json et redémarrez OpenClaw.
  3. invalid_iam_token indique 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.
  • 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.
Après le redémarrage de la passerelle, les sessions existantes peuvent ne pas fonctionner correctement. Démarrez une nouvelle session.
Message d'erreur :
http://127.0.0.1:18791/15:05:56 [ws] closed before connect conn=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx remote=127.0.0.1 fwd=n/a origin=n/a host=127.0.0.1:18789 ua=n/a code=1008 reason=device identity required
Cause :Un client s'est connecté à la passerelle sans fournir d'identité d'appareil. Les causes courantes incluent :
  • 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.
Solution :Exécutez les commandes suivantes pour approuver l'appareil actuel et générer une nouvelle URL d'accès au navigateur :
openclaw devices approve --latest
openclaw dashboard --no-open
Si le problème persiste, effacez les enregistrements d'appareils anormaux et réessayez :
openclaw devices clear --pending --yes
openclaw dashboard --no-open
Exécutez openclaw devices list pour confirmer que l'appareil apparaît dans la liste Paired.
Cause : OpenClaw dispose d'un mécanisme de heartbeat intégré. Tant que la passerelle est en cours d'exécution, elle appelle automatiquement le modèle configuré à intervalle fixe (toutes les 30 minutes par défaut) pour vérifier les tâches en attente. Chaque heartbeat consomme un petit nombre de jetons.Comment vérifier : Consultez les fichiers journaux de session (.jsonl) dans ~/.openclaw/agents/main/sessions/. Les appels heartbeat sont marqués par [OpenClaw heartbeat poll].Solutions :
  • Arrêtez la passerelle : exécutez openclaw gateway stop lorsque vous ne l'utilisez pas. Cela arrête immédiatement le heartbeat.
  • Augmentez l'intervalle de heartbeat : définissez agents.defaults.heartbeat.every dans ~/.openclaw/openclaw.json. Par exemple, "2h" définit l'intervalle sur toutes les 2 heures.