Tencent Cloud Provider
기준일: 2026-07-26
난이도: 중급
공식 기준: Tencent Cloud (TokenHub / TokenPlan)
개요
이 페이지는 OpenClaw Tencent Cloud provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.
공식 요약: Tencent Cloud TokenHub and TokenPlan setup for hy3
model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.
빠른 참조
| Property | Value |
|---|---|
| Provider ids | tencent-tokenhub, tencent-tokenplan |
| Package | @openclaw/tencent-provider |
| TokenHub auth env var | TOKENHUB_API_KEY |
| TokenPlan auth env var | TOKENPLAN_API_KEY |
| TokenHub onboarding flag | --auth-choice tokenhub-api-key |
| TokenPlan onboarding flag | --auth-choice tokenplan-api-key |
| TokenHub direct CLI flag | --tokenhub-api-key <key> |
| TokenPlan direct CLI flag | --tokenplan-api-key <key> |
| API | OpenAI-compatible (openai-completions) |
| TokenHub base URL | https://tokenhub.tencentmaas.com/v1 |
| TokenHub global base URL | https://tokenhub-intl.tencentmaas.com/v1 (override) |
| TokenPlan base URL | https://api.lkeap.cloud.tencent.com/plan/v3 |
| Default model | tencent-tokenhub/hy3 |
공식 문서 기반 상세
아래는 공식 providers/tencent 문서를 Mintlify 컴포넌트만 정리하고 공통 제목을 한국어로 맞춘 내용입니다. 설정 키, env, model ref, CLI 플래그는 원문 그대로 유지합니다.
Install the official Tencent Cloud provider plugin to access Tencent Hy3 through two endpoints — TokenHub (tencent-tokenhub) and TokenPlan (tencent-tokenplan) — using an OpenAI-compatible API.
| Property | Value |
|---|---|
| Provider ids | tencent-tokenhub, tencent-tokenplan |
| Package | @openclaw/tencent-provider |
| TokenHub auth env var | TOKENHUB_API_KEY |
| TokenPlan auth env var | TOKENPLAN_API_KEY |
| TokenHub onboarding flag | --auth-choice tokenhub-api-key |
| TokenPlan onboarding flag | --auth-choice tokenplan-api-key |
| TokenHub direct CLI flag | --tokenhub-api-key <key> |
| TokenPlan direct CLI flag | --tokenplan-api-key <key> |
| API | OpenAI-compatible (openai-completions) |
| TokenHub base URL | https://tokenhub.tencentmaas.com/v1 |
| TokenHub global base URL | https://tokenhub-intl.tencentmaas.com/v1 (override) |
| TokenPlan base URL | https://api.lkeap.cloud.tencent.com/plan/v3 |
| Default model | tencent-tokenhub/hy3 |
빠른 시작
Create a Tencent API key
Create an API key for Tencent Cloud TokenHub and TokenPlan. If you choose a limited access scope for the key, include **hy3** (and **hy3 preview** if you plan to use it on TokenHub) in the allowed models.
Run onboarding
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=...
Verify the model
```bash
openclaw models list --provider tencent-tokenhub
openclaw models list --provider tencent-tokenplan
```
Non-interactive setup
# 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-riskis required alongside--non-interactive.
Built-in catalog
| Model ref | Name | Input | Context | Max output | Notes |
|---|---|---|---|---|---|
tencent-tokenhub/hy3-preview |
hy3 preview (TokenHub) | text | 256,000 | 64,000 | reasoning-enabled |
tencent-tokenhub/hy3 |
hy3 (TokenHub) | text | 256,000 | 64,000 | reasoning-enabled |
tencent-tokenplan/hy3 |
hy3 (TokenPlan) | text | 256,000 | 64,000 | reasoning-enabled |
hy3 is Tencent Hunyuan's large MoE language model for reasoning, long-context instruction following, code, and agent workflows. Tencent's OpenAI-compatible examples use hy3 as the model id and support standard chat-completions tool calling plus reasoning_effort.
The model id is
hy3. Do not confuse it with Tencent'sHY-3D-*models, which are 3D generation APIs and are not the OpenClaw chat model configured by this provider.
고급 설정
Endpoint override
OpenClaw's built-in catalog uses Tencent Cloud's `https://tokenhub.tencentmaas.com/v1` endpoint. Override it only if your TokenHub account or region requires a different one:
```bash
openclaw config set models.providers.tencent-tokenhub.baseUrl "https://your-endpoint/v1"
```
Environment availability for the daemon
If the Gateway runs as a managed service (launchd, systemd, Docker), `TOKENHUB_API_KEY` and `TOKENPLAN_API_KEY` must be visible to that process. Set them in `~/.openclaw/.env` or via `env.shellEnv` so launchd, systemd, or Docker exec environments can read them.
Keys exported only in an interactive shell are not visible to managed gateway processes. Use the env file or config seam for persistent availability.
관련 문서
Choosing providers, model refs, and failover behavior.
Full config schema including provider settings.
Tencent Cloud's TokenHub product page.
Tencent Hunyuan Hy3 preview details and benchmarks.
검증 체크리스트
-
openclaw models list --provider tencent로 모델이 보이는지 확인 - 기본 model alias를
agents.defaults.model.primary에 설정했는지 확인 - API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
- failover 시 데이터가 다른 provider로 이동할 수 있는지 검토