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

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

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

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

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

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

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

1. Створіть API-ключ у консолі свого постачальника.
2. Розмістіть його на **хості шлюзу** (машині, на якій виконується `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, тепер це пріоритетний шлях.

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

Ручне введення токена (будь-який постачальник; записує в `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`.
- Кулдауни rate-limit можуть бути прив’язані до конкретної моделі. Профіль, який перебуває в кулдауні для однієї
  моделі, усе ще може бути придатним для спорідненої моделі того самого постачальника.

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

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

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

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

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

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

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

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

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

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

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

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

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

### Для агента (перевизначення CLI)

Установіть явне перевизначення порядку профілів автентифікації для агента (зберігається в `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` замість того, щоб мовчки їх пропускати.
Коли ви налагоджуєте проблеми з кулдауном, пам’ятайте, що кулдауни rate-limit можуть бути прив’язані
до одного ідентифікатора моделі, а не до всього профілю постачальника.

## Усунення неполадок

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

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

```bash
openclaw models status
```

### Токен скоро спливає/прострочений

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