メインコンテンツへスキップ
Tencent Hy3 に OpenAI 互換 API でアクセスするため、2 つのエンドポイント — TokenHub (tencent-tokenhub) と TokenPlan (tencent-tokenplan) — を通じて公式 Tencent Cloud プロバイダー Plugin をインストールします。
プロパティ
プロバイダー IDtencent-tokenhub, tencent-tokenplan
パッケージ@openclaw/tencent-provider
TokenHub 認証環境変数TOKENHUB_API_KEY
TokenPlan 認証環境変数TOKENPLAN_API_KEY
TokenHub オンボーディングフラグ--auth-choice tokenhub-api-key
TokenPlan オンボーディングフラグ--auth-choice tokenplan-api-key
TokenHub 直接 CLI フラグ--tokenhub-api-key <key>
TokenPlan 直接 CLI フラグ--tokenplan-api-key <key>
APIOpenAI 互換 (openai-completions)
TokenHub ベース URLhttps://tokenhub.tencentmaas.com/v1
TokenHub グローバルベース URLhttps://tokenhub-intl.tencentmaas.com/v1 (オーバーライド)
TokenPlan ベース URLhttps://api.lkeap.cloud.tencent.com/plan/v3
デフォルトモデルtencent-tokenhub/hy3

クイックスタート

1

Tencent API キーを作成する

Tencent Cloud TokenHub と TokenPlan の API キーを作成します。キーに制限付きアクセス範囲を選択する場合は、許可するモデルに hy3 (TokenHub で使用する予定がある場合は hy3 preview も) を含めてください。
2

オンボーディングを実行する

openclaw onboard --auth-choice tokenhub-api-key
openclaw onboard --non-interactive \
  --auth-choice tokenhub-api-key \
  --tokenhub-api-key "$TOKENHUB_API_KEY"
openclaw onboard --auth-choice tokenplan-api-key
openclaw onboard --non-interactive \
  --auth-choice tokenplan-api-key \
  --tokenplan-api-key "$TOKENPLAN_API_KEY"
export TOKENHUB_API_KEY=...
export TOKENPLAN_API_KEY=...
3

モデルを検証する

openclaw models list --provider tencent-tokenhub
openclaw models list --provider tencent-tokenplan

非対話セットアップ

# TokenHub
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice tokenhub-api-key \
  --tokenhub-api-key "$TOKENHUB_API_KEY" \
  --skip-health \
  --accept-risk

# TokenPlan
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice tokenplan-api-key \
  --tokenplan-api-key "$TOKENPLAN_API_KEY" \
  --skip-health \
  --accept-risk
--accept-risk--non-interactive と併せて必要です。

組み込みカタログ

モデル参照名前入力コンテキスト最大出力注記
tencent-tokenhub/hy3-previewhy3 preview (TokenHub)text256,00064,000推論対応
tencent-tokenhub/hy3hy3 (TokenHub)text256,00064,000推論対応
tencent-tokenplan/hy3hy3 (TokenPlan)text256,00064,000推論対応
hy3 は Tencent Hunyuan の大規模 MoE 言語モデルで、推論、長いコンテキストでの指示追従、コード、エージェントワークフロー向けです。Tencent の OpenAI 互換の例では、モデル ID として hy3 を使用し、標準のチャット補完ツール呼び出しと reasoning_effort をサポートしています。
モデル ID は hy3 です。Tencent の HY-3D-* モデルと混同しないでください。これらは 3D 生成 API であり、このプロバイダーで設定される OpenClaw チャットモデルではありません。

高度な設定

OpenClaw の組み込みカタログは Tencent Cloud の https://tokenhub.tencentmaas.com/v1 エンドポイントを使用します。TokenHub アカウントまたはリージョンで別のエンドポイントが必要な場合にのみオーバーライドしてください。
openclaw config set models.providers.tencent-tokenhub.baseUrl "https://your-endpoint/v1"
Gateway がマネージドサービス (launchd、systemd、Docker) として実行される場合、TOKENHUB_API_KEYTOKENPLAN_API_KEY はそのプロセスから見える必要があります。launchd、systemd、または Docker exec 環境が読み取れるように、~/.openclaw/.env または env.shellEnv 経由で設定してください。
対話型シェルでのみエクスポートされたキーは、マネージド Gateway プロセスからは見えません。永続的な可用性のために env ファイルまたは設定シームを使用してください。

関連

モデルプロバイダー

プロバイダー、モデル参照、フェイルオーバー動作の選択。

設定リファレンス

プロバイダー設定を含む完全な設定スキーマ。

Tencent TokenHub

Tencent Cloud の TokenHub 製品ページ。

Hy3 preview モデルカード

Tencent Hunyuan Hy3 preview の詳細とベンチマーク。