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

Установите официальный плагин провайдера Tencent Cloud, чтобы получить доступ к Tencent Hy3 через две конечные точки — TokenHub (`tencent-tokenhub`) и TokenPlan (`tencent-tokenplan`) — с помощью API, совместимого с OpenAI.

| Свойство | Значение |
| - | - |
| Идентификаторы провайдеров | `tencent-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` |
| Прямой флаг CLI для TokenHub | `--tokenhub-api-key <key>` |
| Прямой флаг CLI для TokenPlan | `--tokenplan-api-key <key>` |
| API | Совместимый с OpenAI (`openai-completions`) |
| Базовый URL TokenHub | `https://tokenhub.tencentmaas.com/v1` |
| Глобальный базовый URL TokenHub | `https://tokenhub-intl.tencentmaas.com/v1` (переопределение) |
| Базовый URL TokenPlan | `https://api.lkeap.cloud.tencent.com/plan/v3` |
| Модель по умолчанию | `tencent-tokenhub/hy3` |

## Быстрый старт

**1. Создайте ключ API Tencent**

Создайте ключ API для Tencent Cloud TokenHub и TokenPlan. Если вы выберете для ключа ограниченную область доступа, добавьте **hy3** (и **hy3 preview**, если планируете использовать эту модель в TokenHub) в список разрешённых моделей.

**2. Запустите первоначальную настройку**

```bash Первоначальная настройка TokenHub theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice tokenhub-api-key
```

```bash Прямой флаг TokenHub theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --non-interactive \
  --auth-choice tokenhub-api-key \
  --tokenhub-api-key "$TOKENHUB_API_KEY"
```

```bash Первоначальная настройка TokenPlan theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice tokenplan-api-key
```

```bash Прямой флаг TokenPlan theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --non-interactive \
  --auth-choice tokenplan-api-key \
  --tokenplan-api-key "$TOKENPLAN_API_KEY"
```

```bash Только переменные окружения theme={"theme":{"light":"min-light","dark":"min-dark"}}
export TOKENHUB_API_KEY=...
export TOKENPLAN_API_KEY=...
```

**3. Проверьте модель**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models list --provider tencent-tokenhub
openclaw models list --provider tencent-tokenplan
```

## Неинтерактивная настройка

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# 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
```

> [!NOTE]
>
> `--accept-risk` обязателен вместе с `--non-interactive`.

## Встроенный каталог

| Ссылка на модель | Название | Входные данные | Контекст | Максимальный вывод | Примечания |
| - | - | - | - | - | - |
| `tencent-tokenhub/hy3-preview` | hy3 preview (TokenHub) | текст | 256,000 | 64,000 | поддерживает рассуждения |
| `tencent-tokenhub/hy3` | hy3 (TokenHub) | текст | 256,000 | 64,000 | поддерживает рассуждения |
| `tencent-tokenplan/hy3` | hy3 (TokenPlan) | текст | 256,000 | 64,000 | поддерживает рассуждения |

hy3 — это большая языковая MoE-модель Tencent Hunyuan для рассуждений, выполнения инструкций с длинным контекстом, работы с кодом и агентных рабочих процессов. В примерах Tencent для API, совместимого с OpenAI, идентификатор модели указан как `hy3`; также поддерживаются стандартный вызов инструментов через Chat Completions и `reasoning_effort`.

> [!TIP]
>
> Идентификатор модели — `hy3`. Не путайте её с моделями Tencent `HY-3D-*`: это API для генерации 3D-контента, а не чат-модель OpenClaw, настраиваемая этим провайдером.

## Расширенная конфигурация

> [accordion] Переопределение конечной точки
>
> Во встроенном каталоге OpenClaw используется конечная точка Tencent Cloud `https://tokenhub.tencentmaas.com/v1`. Переопределяйте её только в том случае, если для вашей учётной записи или региона TokenHub требуется другая конечная точка:
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw config set models.providers.tencent-tokenhub.baseUrl "https://your-endpoint/v1"
> ```

> [accordion] Доступность переменных окружения для фоновой службы
>
> Если Gateway работает как управляемая служба (launchd, systemd, Docker), `TOKENHUB_API_KEY` и `TOKENPLAN_API_KEY` должны быть доступны этому процессу. Задайте их в `~/.openclaw/.env` или через `env.shellEnv`, чтобы окружения выполнения launchd, systemd или Docker могли их прочитать.
>
> > [!WARNING]
> >
> > Ключи, экспортированные только в интерактивной оболочке, недоступны управляемым процессам Gateway. Для постоянной доступности используйте файл переменных окружения или механизм конфигурации.

## Связанные материалы

> [card] [Провайдеры моделей](https://docs2.openclaw.ai/ru/concepts/model-providers.md)
>
> Выбор провайдеров, ссылок на модели и поведения при переключении после сбоя.

> [card] [Справочник по конфигурации](https://docs2.openclaw.ai/ru/gateway/configuration-reference.md)
>
> Полная схема конфигурации, включая настройки провайдеров.

> [card] [Tencent TokenHub](https://cloud.tencent.com/product/tokenhub)
>
> Страница продукта TokenHub от Tencent Cloud.

> [card] [Карточка предварительной версии модели Hy3](https://huggingface.co/tencent/Hy3-preview)
>
> Подробные сведения и результаты тестирования предварительной версии Tencent Hunyuan Hy3.