Providers
Tencent Cloud (TokenHub)
Tencent Cloud는 OpenClaw에 번들 제공자 Plugin으로 포함됩니다. OpenAI 호환 API를 사용해 TokenHub 엔드포인트(tencent-tokenhub)를 통해 Tencent Hy3 preview에 접근할 수 있습니다.
| 속성 | 값 |
|---|---|
| 제공자 id | tencent-tokenhub |
| Plugin | 번들, enabledByDefault: true |
| 인증 env var | TOKENHUB_API_KEY |
| 온보딩 플래그 | --auth-choice tokenhub-api-key |
| 직접 CLI 플래그 | --tokenhub-api-key <key> |
| API | OpenAI 호환(openai-completions) |
| 기본 base URL | https://tokenhub.tencentmaas.com/v1 |
| 전역 base URL | https://tokenhub-intl.tencentmaas.com/v1 (재정의) |
| 기본 모델 | tencent-tokenhub/hy3-preview |
빠른 시작
TokenHub API 키 생성
Tencent Cloud TokenHub에서 API 키를 생성합니다. 키에 제한된 접근 범위를 선택하는 경우, 허용된 모델에 Hy3 preview를 포함하세요.
온보딩 실행
openclaw onboard --auth-choice tokenhub-api-key
openclaw onboard --non-interactive \
--auth-choice tokenhub-api-key \
--tokenhub-api-key "$TOKENHUB_API_KEY"
export TOKENHUB_API_KEY=...
모델 확인
openclaw models list --provider tencent-tokenhub
비대화형 설정
openclaw onboard --non-interactive \
--mode local \
--auth-choice tokenhub-api-key \
--tokenhub-api-key "$TOKENHUB_API_KEY" \
--skip-health \
--accept-risk
내장 카탈로그
| 모델 ref | 이름 | 입력 | 컨텍스트 | 최대 출력 | 참고 |
|---|---|---|---|---|---|
tencent-tokenhub/hy3-preview |
Hy3 preview (TokenHub) | 텍스트 | 256,000 | 64,000 | 기본값; 추론 활성화됨 |
Hy3 preview는 추론, 긴 컨텍스트 지시 따르기, 코드, 에이전트 워크플로를 위한 Tencent Hunyuan의 대형 MoE 언어 모델입니다. Tencent의 OpenAI 호환 예시는 hy3-preview를 모델 id로 사용하며, 표준 채팅 완성 도구 호출과 reasoning_effort를 지원합니다.
계층형 가격
번들 카탈로그에는 입력 창 길이에 따라 확장되는 계층형 비용 메타데이터가 포함되어 있어, 수동 재정의 없이 비용 추정값이 채워집니다.
| 입력 토큰 범위 | 입력 요율 | 출력 요율 | 캐시 읽기 |
|---|---|---|---|
| 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 |
요율은 Tencent가 공시한 USD 기준 백만 토큰당 가격입니다. 다른 표면이 필요한 경우에만 models.providers.tencent-tokenhub 아래에서 가격을 재정의하세요.
고급 구성
엔드포인트 재정의
OpenClaw는 기본적으로 Tencent Cloud의 https://tokenhub.tencentmaas.com/v1 엔드포인트를 사용합니다. Tencent는 국제 TokenHub 엔드포인트도 문서화합니다.
openclaw config set models.providers.tencent-tokenhub.baseUrl "https://tokenhub-intl.tencentmaas.com/v1"
TokenHub 계정이나 리전에서 요구하는 경우에만 엔드포인트를 재정의하세요.
데몬의 환경 사용 가능성
Gateway가 관리형 서비스(launchd, systemd, Docker)로 실행되는 경우, TOKENHUB_API_KEY가 해당 프로세스에 보여야 합니다. launchd, systemd 또는 Docker exec 환경이 읽을 수 있도록 ~/.openclaw/.env 또는 env.shellEnv를 통해 설정하세요.