---
read_when:
    - Налагодження автентифікації моделі або завершення строку дії OAuth
    - Документування автентифікації або зберігання облікових даних
summary: 'Автентифікація моделі: OAuth, ключі API, повторне використання Claude CLI та setup-token Anthropic'
title: Автентифікація
x-i18n:
    generated_at: "2026-04-23T14:49:08Z"
    model: gpt-5.4
    provider: openai
    source_hash: 37a7c20872b915d1d079f0578c933e43cbdb97eca1c60d8c4e6e5137ca83f8b2
    source_path: gateway/authentication.md
    workflow: 15
---

# Автентифікація (постачальники моделей)

<Note>
Ця сторінка охоплює автентифікацію **постачальника моделей** (ключі API, OAuth, повторне використання Claude CLI та setup-token Anthropic). Для автентифікації **підключення Gateway** (токен, пароль, trusted-proxy) див. [Configuration](/uk/gateway/configuration) і [Trusted Proxy Auth](/uk/gateway/trusted-proxy-auth).
</Note>

OpenClaw підтримує OAuth і ключі API для постачальників моделей. Для постійно активних хостів Gateway ключі API зазвичай є найпередбачуванішим варіантом. Потоки підписки/OAuth також підтримуються, коли вони відповідають моделі облікового запису вашого постачальника.

Див. [/concepts/oauth](/uk/concepts/oauth) для повного потоку OAuth і структури зберігання.
Для автентифікації на основі SecretRef (постачальники `env`/`file`/`exec`) див. [Secrets Management](/uk/gateway/secrets).
Для правил допустимості облікових даних/кодів причин, які використовуються `models status --probe`, див.
[Семантика облікових даних автентифікації](/uk/auth-credential-semantics).

## Рекомендоване налаштування (ключ API, будь-який постачальник)

Якщо ви запускаєте довготривалий Gateway, почніть із ключа API для вибраного
постачальника.
Зокрема для Anthropic автентифікація за ключем API усе ще є найпередбачуванішим серверним налаштуванням, але OpenClaw також підтримує повторне використання локального входу Claude CLI.

1. Створіть ключ API у консолі вашого постачальника.
2. Розмістіть його на **хості Gateway** (машині, на якій працює `openclaw gateway`).

```bash
export <PROVIDER>_API_KEY="..."
openclaw models status
```

3. Якщо Gateway працює під systemd/launchd, краще розмістити ключ у
   `~/.openclaw/.env`, щоб демон міг його прочитати:

```bash
cat >> ~/.openclaw/.env <<'EOF'
<PROVIDER>_API_KEY=...
EOF
```

Потім перезапустіть демон (або перезапустіть процес Gateway) і перевірте знову:

```bash
openclaw models status
openclaw doctor
```

Якщо ви не хочете самостійно керувати змінними середовища, онбординг може зберігати
ключі API для використання демоном: `openclaw onboard`.

Див. [Help](/uk/help), щоб дізнатися подробиці про успадкування env (`env.shellEnv`,
`~/.openclaw/.env`, systemd/launchd).

## Anthropic: Claude CLI і сумісність токенів

Автентифікація Anthropic setup-token усе ще доступна в OpenClaw як підтримуваний
шлях токена. Відтоді співробітники Anthropic повідомили нам, що використання Claude CLI у стилі OpenClaw знову дозволене, тому OpenClaw вважає повторне використання Claude CLI та використання `claude -p` санкціонованими для цієї інтеграції, якщо Anthropic не опублікує нову політику. Коли на хості доступне повторне використання Claude CLI, це тепер є бажаним шляхом.

Для довготривалих хостів Gateway ключ API Anthropic усе ще є найпередбачуванішим
налаштуванням. Якщо ви хочете повторно використати наявний вхід Claude на тому ж хості, використайте шлях Anthropic Claude CLI в onboarding/configure.

Рекомендоване налаштування хоста для повторного використання Claude CLI:

```bash
# Run on the gateway host
claude auth login
claude auth status --text
openclaw models auth login --provider anthropic --method cli --set-default
```

Це двоетапне налаштування:

1. Увійдіть у сам Claude Code в Anthropic на хості Gateway.
2. Повідомте OpenClaw, щоб він перемкнув вибір моделі Anthropic на локальний бекенд `claude-cli`
   і зберіг відповідний профіль автентифікації OpenClaw.

Якщо `claude` відсутній у `PATH`, або спочатку встановіть Claude Code, або задайте
`agents.defaults.cliBackends.claude-cli.command` на фактичний шлях до бінарного файла.

Ручне введення токена (будь-який постачальник; записує `auth-profiles.json` і оновлює config):

```bash
openclaw models auth paste-token --provider openrouter
```

Також підтримуються посилання на профілі автентифікації для статичних облікових даних:

- облікові дані `api_key` можуть використовувати `keyRef: { source, provider, id }`
- облікові дані `token` можуть використовувати `tokenRef: { source, provider, id }`
- Профілі в режимі OAuth не підтримують облікові дані SecretRef; якщо `auth.profiles.<id>.mode` задано як `"oauth"`, введення `keyRef`/`tokenRef` на основі SecretRef для цього профілю відхиляється.

Перевірка, зручна для автоматизації (вихід `1`, якщо строк дії минув/відсутнє, `2`, якщо строк дії скоро мине):

```bash
openclaw models status --check
```

Живі перевірки автентифікації:

```bash
openclaw models status --probe
```

Примітки:

- Рядки probe можуть надходити з профілів автентифікації, облікових даних env або `models.json`.
- Якщо явний `auth.order.<provider>` пропускає збережений профіль, probe повідомляє
  `excluded_by_auth_order` для цього профілю замість спроби його використати.
- Якщо автентифікація існує, але OpenClaw не може визначити придатний кандидат моделі для probe для
  цього постачальника, probe повідомляє `status: no_model`.
- Періоди очікування через обмеження швидкості можуть бути прив’язані до конкретної моделі. Профіль, який перебуває в періоді очікування для однієї
  моделі, усе ще може бути придатним для спорідненої моделі у того самого постачальника.

Необов’язкові операційні скрипти (systemd/Termux) задокументовані тут:
[Скрипти моніторингу автентифікації](/uk/help/scripts#auth-monitoring-scripts)

## Примітка щодо Anthropic

Бекенд Anthropic `claude-cli` знову підтримується.

- Співробітники Anthropic повідомили нам, що цей шлях інтеграції OpenClaw знову дозволений.
- Тому OpenClaw вважає повторне використання Claude CLI та використання `claude -p` санкціонованими
  для запусків через Anthropic, якщо Anthropic не опублікує нову політику.
- Ключі API Anthropic залишаються найпередбачуванішим вибором для довготривалих хостів Gateway
  і явного контролю серверного білінгу.

## Перевірка стану автентифікації моделі

```bash
openclaw models status
openclaw doctor
```

## Поведінка ротації ключів API (Gateway)

Деякі постачальники підтримують повторну спробу запиту з альтернативними ключами, коли виклик API
натрапляє на обмеження швидкості постачальника.

- Порядок пріоритету:
  - `OPENCLAW_LIVE_<PROVIDER>_KEY` (один override)
  - `<PROVIDER>_API_KEYS`
  - `<PROVIDER>_API_KEY`
  - `<PROVIDER>_API_KEY_*`
- Постачальники Google також включають `GOOGLE_API_KEY` як додатковий резервний варіант.
- Той самий список ключів дедуплікується перед використанням.
- OpenClaw повторює спробу з наступним ключем лише для помилок обмеження швидкості (наприклад,
  `429`, `rate_limit`, `quota`, `resource exhausted`, `Too many concurrent
requests`, `ThrottlingException`, `concurrency limit reached`, або
  `workers_ai ... quota limit exceeded`).
- Для помилок, не пов’язаних з обмеженням швидкості, повторні спроби з альтернативними ключами не виконуються.
- Якщо всі ключі не спрацюють, повертається фінальна помилка з останньої спроби.

## Керування тим, які облікові дані використовуються

### Для сеансу (команда чату)

Використовуйте `/model <alias-or-id>@<profileId>`, щоб закріпити конкретні облікові дані постачальника для поточного сеансу (приклади ідентифікаторів профілю: `anthropic:default`, `anthropic:work`).

Використовуйте `/model` (або `/model list`) для компактного вибору; використовуйте `/model status` для повного перегляду (кандидати + наступний профіль автентифікації, а також деталі endpoint постачальника, якщо налаштовано).

### Для агента (override CLI)

Задайте явний override порядку профілів автентифікації для агента (зберігається в `auth-state.json` цього агента):

```bash
openclaw models auth order get --provider anthropic
openclaw models auth order set --provider anthropic anthropic:default
openclaw models auth order clear --provider anthropic
```

Використовуйте `--agent <id>`, щоб націлитися на конкретного агента; не вказуйте його, щоб використати налаштованого агента за замовчуванням.
Під час налагодження проблем із порядком `openclaw models status --probe` показує пропущені
збережені профілі як `excluded_by_auth_order` замість того, щоб мовчки їх пропускати.
Під час налагодження проблем із періодом очікування пам’ятайте, що періоди очікування через обмеження швидкості можуть бути прив’язані
до одного ідентифікатора моделі, а не до всього профілю постачальника.

## Усунення несправностей

### "Облікові дані не знайдено"

Якщо профіль Anthropic відсутній, налаштуйте ключ API Anthropic на
**хості Gateway** або налаштуйте шлях Anthropic setup-token, а потім перевірте знову:

```bash
openclaw models status
```

### Строк дії токена завершується/завершився

Запустіть `openclaw models status`, щоб підтвердити, для якого профілю завершується строк дії. Якщо профіль токена
Anthropic відсутній або строк його дії завершився, оновіть це налаштування через
setup-token або перейдіть на ключ API Anthropic.
