> ## 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)

Installieren Sie das offizielle Tencent Cloud Provider-Plugin, um über den TokenHub-Endpunkt (`tencent-tokenhub`) mit einer OpenAI-kompatiblen API auf Tencent Hy3 preview zuzugreifen.

| Eigenschaft        | Wert                                                        |
| ------------------ | ----------------------------------------------------------- |
| Provider-ID        | `tencent-tokenhub`                                          |
| Paket              | `@openclaw/tencent-provider`                                |
| Auth-Env-Var       | `TOKENHUB_API_KEY`                                          |
| Onboarding-Flag    | `--auth-choice tokenhub-api-key`                            |
| Direktes CLI-Flag  | `--tokenhub-api-key <key>`                                  |
| API                | OpenAI-kompatibel (`openai-completions`)                    |
| Standard-Basis-URL | `https://tokenhub.tencentmaas.com/v1`                       |
| Globale Basis-URL  | `https://tokenhub-intl.tencentmaas.com/v1` (Überschreibung) |
| Standardmodell     | `tencent-tokenhub/hy3-preview`                              |

## Schnellstart

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

  <Step title="TokenHub-API-Schlüssel erstellen">
    Erstellen Sie einen API-Schlüssel in Tencent Cloud TokenHub. Wenn Sie für den Schlüssel einen eingeschränkten Zugriffsbereich wählen, nehmen Sie **Hy3 preview** in die erlaubten Modelle auf.
  </Step>

  <Step title="Onboarding ausführen">
    <CodeGroup>
      ```bash Onboarding theme={"theme":{"light":"min-light","dark":"min-dark"}}
      openclaw onboard --auth-choice tokenhub-api-key
      ```

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

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

  <Step title="Modell überprüfen">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw models list --provider tencent-tokenhub
    ```
  </Step>
</Steps>

## Nicht interaktive Einrichtung

```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
```

## Integrierter Katalog

| Modell-Ref                     | Name                   | Eingabe | Kontext | Maximale Ausgabe | Hinweise                  |
| ------------------------------ | ---------------------- | ------- | ------- | ---------------- | ------------------------- |
| `tencent-tokenhub/hy3-preview` | Hy3 preview (TokenHub) | text    | 256,000 | 64,000           | Standard; reasoning-fähig |

Hy3 preview ist Tencent Hunyuan's großes MoE-Sprachmodell für Reasoning, Befolgen von Anweisungen mit langem Kontext, Code und Agent-Workflows. Tencents OpenAI-kompatible Beispiele verwenden `hy3-preview` als Modell-ID und unterstützen standardmäßiges Tool Calling für Chat Completions sowie `reasoning_effort`.

<Tip>
  Die Modell-ID lautet `hy3-preview`. Verwechseln Sie sie nicht mit Tencents `HY-3D-*`-Modellen; das sind APIs für 3D-Generierung und nicht das von diesem Provider konfigurierte OpenClaw-Chatmodell.
</Tip>

## Gestaffelte Preise

Der Provider-Katalog enthält gestaffelte Kostenmetadaten, die mit der Länge des Eingabefensters skalieren, sodass Kostenschätzungen ohne manuelle Überschreibungen ausgefüllt werden.

| Eingabe-Tokenbereich | Eingaberate | Ausgaberate | Cache-Lesezugriff |
| -------------------- | ----------- | ----------- | ----------------- |
| 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             |

Die Raten gelten pro Million Token in USD, wie von Tencent angegeben. Überschreiben Sie die Preise unter `models.providers.tencent-tokenhub` nur, wenn Sie eine andere Oberfläche benötigen.

## Erweiterte Konfiguration

<AccordionGroup>
  <Accordion title="Endpunkt überschreiben">
    OpenClaw verwendet standardmäßig Tencents Cloud-Endpunkt `https://tokenhub.tencentmaas.com/v1`. Tencent dokumentiert außerdem einen internationalen TokenHub-Endpunkt:

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

    Überschreiben Sie den Endpunkt nur, wenn Ihr TokenHub-Konto oder Ihre Region dies erfordert.
  </Accordion>

  <Accordion title="Umgebungsverfügbarkeit für den Daemon">
    Wenn der Gateway als verwalteter Dienst ausgeführt wird (launchd, systemd, Docker), muss `TOKENHUB_API_KEY` für diesen Prozess sichtbar sein. Legen Sie ihn in `~/.openclaw/.env` oder über `env.shellEnv` fest, damit launchd-, systemd- oder Docker-exec-Umgebungen ihn lesen können.

    <Warning>
      Schlüssel, die nur in einer interaktiven Shell exportiert werden, sind für verwaltete Gateway-Prozesse nicht sichtbar. Verwenden Sie die Env-Datei oder die Konfigurationsnahtstelle für dauerhafte Verfügbarkeit.
    </Warning>
  </Accordion>
</AccordionGroup>

## Verwandte Themen

<CardGroup cols={2}>
  <Card title="Modell-Provider" href="/de/concepts/model-providers" icon="layers">
    Provider, Modell-Refs und Failover-Verhalten auswählen.
  </Card>

  <Card title="Konfigurationsreferenz" href="/de/gateway/configuration" icon="gear">
    Vollständiges Konfigurationsschema einschließlich Provider-Einstellungen.
  </Card>

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

  <Card title="Hy3 preview-Modellkarte" href="https://huggingface.co/tencent/Hy3-preview" icon="square-poll-horizontal">
    Details und Benchmarks zu Tencent Hunyuan Hy3 preview.
  </Card>
</CardGroup>