> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Tencent Cloud (TokenHub)

Installez le plugin fournisseur officiel Tencent Cloud pour accéder à Tencent Hy3 preview via le endpoint TokenHub (`tencent-tokenhub`) au moyen d’une API compatible OpenAI.

| Propriété                            | Valeur                                                    |
| ------------------------------------ | --------------------------------------------------------- |
| ID du fournisseur                    | `tencent-tokenhub`                                        |
| Package                              | `@openclaw/tencent-provider`                              |
| Variable d’env d’auth                | `TOKENHUB_API_KEY`                                        |
| Indicateur de configuration initiale | `--auth-choice tokenhub-api-key`                          |
| Indicateur CLI direct                | `--tokenhub-api-key <key>`                                |
| API                                  | compatible OpenAI (`openai-completions`)                  |
| URL de base par défaut               | `https://tokenhub.tencentmaas.com/v1`                     |
| URL de base globale                  | `https://tokenhub-intl.tencentmaas.com/v1` (remplacement) |
| Modèle par défaut                    | `tencent-tokenhub/hy3-preview`                            |

## Démarrage rapide

<Steps>
  <Step title="Installer le plugin">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw plugins install @openclaw/tencent-provider
    ```
  </Step>

  <Step title="Créer une clé API TokenHub">
    Créez une clé API dans Tencent Cloud TokenHub. Si vous choisissez une portée d’accès limitée pour la clé, incluez **Hy3 preview** dans les modèles autorisés.
  </Step>

  <Step title="Exécuter la configuration initiale">
    <CodeGroup>
      ```bash Configuration initiale theme={"theme":{"light":"min-light","dark":"min-dark"}}
      openclaw onboard --auth-choice tokenhub-api-key
      ```

      ```bash Indicateur direct theme={"theme":{"light":"min-light","dark":"min-dark"}}
      openclaw onboard --non-interactive \
        --auth-choice tokenhub-api-key \
        --tokenhub-api-key "$TOKENHUB_API_KEY"
      ```

      ```bash Env uniquement theme={"theme":{"light":"min-light","dark":"min-dark"}}
      export TOKENHUB_API_KEY=...
      ```
    </CodeGroup>
  </Step>

  <Step title="Vérifier le modèle">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw models list --provider tencent-tokenhub
    ```
  </Step>
</Steps>

## Configuration non interactive

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice tokenhub-api-key \
  --tokenhub-api-key "$TOKENHUB_API_KEY" \
  --skip-health \
  --accept-risk
```

## Catalogue intégré

| Réf. du modèle                 | Nom                    | Entrée | Contexte | Sortie max. | Notes                            |
| ------------------------------ | ---------------------- | ------ | -------- | ----------- | -------------------------------- |
| `tencent-tokenhub/hy3-preview` | Hy3 preview (TokenHub) | text   | 256 000  | 64 000      | Par défaut ; raisonnement activé |

Hy3 preview est le grand modèle de langage MoE de Tencent Hunyuan pour le raisonnement, le suivi d’instructions en contexte long, le code et les workflows d’agents. Les exemples compatibles OpenAI de Tencent utilisent `hy3-preview` comme ID de modèle et prennent en charge les appels d’outils standard de chat-completions ainsi que `reasoning_effort`.

<Tip>
  L’ID du modèle est `hy3-preview`. Ne le confondez pas avec les modèles `HY-3D-*` de Tencent, qui sont des API de génération 3D et ne sont pas le modèle de chat OpenClaw configuré par ce fournisseur.
</Tip>

## Tarification par paliers

Le catalogue du fournisseur inclut des métadonnées de coût par paliers qui évoluent selon la longueur de la fenêtre d’entrée, afin que les estimations de coût soient renseignées sans remplacements manuels.

| Plage de jetons d’entrée | Tarif d’entrée | Tarif de sortie | Lecture du cache |
| ------------------------ | -------------- | --------------- | ---------------- |
| 0 - 16 000               | 0.176          | 0.587           | 0.059            |
| 16 000 - 32 000          | 0.235          | 0.939           | 0.088            |
| 32 000+                  | 0.293          | 1.173           | 0.117            |

Les tarifs sont indiqués par million de jetons en USD, tels qu’annoncés par Tencent. Remplacez la tarification sous `models.providers.tencent-tokenhub` uniquement lorsque vous avez besoin d’une surface différente.

## Configuration avancée

<AccordionGroup>
  <Accordion title="Remplacement du endpoint">
    OpenClaw utilise par défaut le endpoint Tencent Cloud `https://tokenhub.tencentmaas.com/v1`. Tencent documente aussi un endpoint TokenHub international :

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw config set models.providers.tencent-tokenhub.baseUrl "https://tokenhub-intl.tencentmaas.com/v1"
    ```

    Remplacez le endpoint uniquement lorsque votre compte ou votre région TokenHub l’exige.
  </Accordion>

  <Accordion title="Disponibilité de l’environnement pour le daemon">
    Si le Gateway s’exécute comme service géré (launchd, systemd, Docker), `TOKENHUB_API_KEY` doit être visible par ce processus. Définissez-la dans `~/.openclaw/.env` ou via `env.shellEnv` afin que les environnements launchd, systemd ou Docker exec puissent la lire.

    <Warning>
      Les clés exportées uniquement dans un shell interactif ne sont pas visibles par les processus Gateway gérés. Utilisez le fichier env ou le seam de configuration pour une disponibilité persistante.
    </Warning>
  </Accordion>
</AccordionGroup>

## Connexe

<CardGroup cols={2}>
  <Card title="Fournisseurs de modèles" href="/fr/concepts/model-providers" icon="layers">
    Choisir les fournisseurs, les références de modèles et le comportement de basculement.
  </Card>

  <Card title="Référence de configuration" href="/fr/gateway/configuration" icon="gear">
    Schéma de configuration complet, y compris les paramètres des fournisseurs.
  </Card>

  <Card title="Tencent TokenHub" href="https://cloud.tencent.com/product/tokenhub" icon="arrow-up-right-from-square">
    Page produit TokenHub de Tencent Cloud.
  </Card>

  <Card title="Fiche du modèle Hy3 preview" href="https://huggingface.co/tencent/Hy3-preview" icon="square-poll-horizontal">
    Détails et benchmarks de Tencent Hunyuan Hy3 preview.
  </Card>
</CardGroup>