Providers
Anthropic
Anthropic створює сімейство моделей Claude. OpenClaw підтримує два способи автентифікації:
- Ключ API — прямий доступ до Anthropic API з оплатою за використання (моделі
anthropic/*) - Claude CLI — повторне використання наявного входу Claude Code на тому самому хості
Початок роботи
Ключ API
Найкраще для: стандартного доступу до API та білінгу за використанням.
Отримайте свій ключ API
Створіть ключ API у консолі Anthropic.
Запустіть онбординг
openclaw onboard# choose: Anthropic API keyАбо передайте ключ напряму:
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"Перевірте, що модель доступна
openclaw models list --provider anthropicПриклад конфігурації
{ env: { ANTHROPIC_API_KEY: "example-anthropic-key-not-real" }, agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" } } },}Claude CLI
Найкраще для: повторного використання наявного входу Claude CLI без окремого ключа API.
Переконайтеся, що Claude CLI встановлено і вхід виконано
Перевірте за допомогою:
claude --versionЗапустіть онбординг
openclaw onboard# choose: Claude CLIOpenClaw виявляє і повторно використовує наявні облікові дані Claude CLI.
Перевірте, що модель доступна
openclaw models list --provider anthropicПриклад конфігурації
Надавайте перевагу канонічному посиланню на модель Anthropic плюс перевизначенню середовища виконання CLI:
{ agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" }, models: { "anthropic/claude-opus-4-8": { agentRuntime: { id: "claude-cli" }, }, }, }, },}Застарілі посилання на моделі claude-cli/claude-opus-4-7 усе ще працюють для
сумісності, але нова конфігурація має зберігати вибір провайдера/моделі як
anthropic/* і розміщувати бекенд виконання в політиці середовища виконання провайдера/моделі.
Білінг і claude -p
OpenClaw використовує неінтерактивний шлях Claude Code claude -p для запусків Claude CLI.
Anthropic наразі розглядає цей шлях як використання Agent SDK/програмне використання:
- Оновлення підтримки Anthropic від 15 червня 2026 року призупинило раніше оголошений окремий кредитний план Agent SDK.
- Наразі Claude Agent SDK у межах передплатного плану,
claude -pі використання сторонніх застосунків усе ще витрачають ліміти використання передплати, у яку виконано вхід. - Раніше оголошений щомісячний кредит Agent SDK недоступний, поки Anthropic переглядає цей план.
- Входи через Console/ключ API використовують API-білінг з оплатою за фактом використання і не отримують кредит Agent SDK передплати.
Див. статтю про план Agent SDK Anthropic щодо повідомлення про призупинення, а також статті про плани Claude Code для Pro/Max і Team/Enterprise щодо поведінки передплати.
Anthropic може змінювати білінг Claude Code і поведінку обмеження швидкості без
релізу OpenClaw. Перевіряйте claude auth status, /status і
пов’язану документацію Anthropic, коли важлива передбачуваність білінгу.
Типові налаштування мислення (Claude Fable 5, 4.8 і 4.6)
anthropic/claude-fable-5 завжди використовує адаптивне мислення і за замовчуванням має
зусилля high. Оскільки Anthropic не дозволяє вимикати мислення для цієї моделі,
/think off і /think minimal використовують зусилля low. OpenClaw також пропускає власні
значення температури для запитів Fable 5.
Claude Opus 4.8 у OpenClaw за замовчуванням тримає мислення вимкненим. Коли ви явно вмикаєте адаптивне мислення через /think high|xhigh|max, OpenClaw надсилає значення зусилля Opus 4.8 від Anthropic; моделі Claude 4.6 за замовчуванням використовують adaptive.
Перевизначайте для окремого повідомлення через /think:<level> або в параметрах моделі:
{ agents: { defaults: { models: { "anthropic/claude-opus-4-8": { params: { thinking: "high" }, }, }, }, },}Резервний перехід після відмови безпеки (Claude Fable 5)
Навіщо це існує
Класифікатори Fable 5 повертають stop_reason: "refusal" для запитів в обмежених
доменах, а також дають хибнопозитивні спрацювання на близьких до дозволених завданнях
(інструменти безпеки, науки про життя або навіть прохання до моделі відтворити її сирі
міркування). Без резервного переходу хід завершується помилкою, хоча
інша модель Claude із готовністю його обслужила б — власне повідомлення Anthropic про відмову
вказує інтеграторам API налаштувати резервну модель.
Як це працює
- Для кожного прямого запиту з ключем API до
anthropic/claude-fable-5OpenClaw надсилає згоду на серверний резервний перехід Anthropic: beta-заголовокserver-side-fallback-2026-06-01плюсfallbacks: [{"model": "claude-opus-4-8"}]. Claude Opus 4.8 — єдина резервна ціль, яку Anthropic дозволяє для Fable 5. - Резервний перехід запускає лише відхилення класифікатором безпеки. Обмеження швидкості, перевантаження та помилки сервера поводяться точно як раніше і проходять через звичайне перемикання моделі після збою OpenClaw.
- Відновлення відбувається всередині того самого виклику. Відхилення до будь-якого виводу непомітне, крім затримки; уся відповідь надходить від Opus 4.8. У разі відхилення посеред потоку частковий текст зберігається як префікс, з якого продовжує резервна модель, тоді як міркування та виклики інструментів відхиленої моделі відкидаються згідно з правилами відтворення Anthropic (їх не можна повертати назад або виконувати).
- Якщо Claude Opus 4.8 також відхиляє запит, хід показує відмову як помилку, точно як до цієї функції.
Резервний перехід відбувається на рівні Anthropic API, тому claude-opus-4-8 не
потрібно додавати до вашого налаштованого списку моделей або ланцюга резервування — ключ API
з підтримкою Fable завжди може обслуговувати Opus.
Спостережуваність і білінг
- Хід, обслужений резервною моделлю, записує діагностику
provider_fallbackу повідомленні асистента з назвамиfromModelіtoModel, а поле повідомленняresponseModelповідомляєclaude-opus-4-8. - Anthropic виставляє рахунок за кожну спробу: відхилення до виводу безкоштовне, а відновлення тарифікується за ставками Claude Opus 4.8 (зараз це половина ставок Fable 5). Оцінка вартості за хід в OpenClaw оцінює ходи, обслужені резервною моделлю, за ставками Opus, щоб відповідати цьому.
- Відхилення посеред потоку додатково тарифікує вже передану частину Fable на боці Anthropic; ця частина відображається у використанні за спробу в API, але не включається до оцінки вартості за хід в OpenClaw.
Область дії
Застосовується до anthropic/claude-fable-5 з автентифікацією ключем API проти
api.anthropic.com. OAuth (повторне використання передплати Claude CLI), базові URL проксі,
запити Bedrock, Vertex і Foundry не змінені й усе ще показують
відмови як помилки.
Перевірено наживо: безпечний промпт із проханням до Fable 5 відтворити сирий ланцюжок
міркувань відхиляється з category: "reasoning_extraction", коли надсилається без
резервних варіантів, а той самий промпт через OpenClaw повертає звичайну відповідь, обслужену Opus,
із доданою діагностикою provider_fallback.
Див. посібник Anthropic щодо відмов і резервного переходу для базової поведінки.
Кешування промптів
OpenClaw підтримує функцію кешування промптів Anthropic для автентифікації ключем API.
| Значення | Тривалість кешу | Опис |
|---|---|---|
"short" (типово) |
5 хвилин | Застосовується автоматично для автентифікації ключем API |
"long" |
1 година | Розширений кеш |
"none" |
Без кешування | Вимкнути кешування промптів |
{ agents: { defaults: { models: { "anthropic/claude-opus-4-6": { params: { cacheRetention: "long" }, }, }, }, },}Перевизначення кешу для окремого агента
Використовуйте параметри рівня моделі як базові, а потім перевизначайте конкретних агентів через agents.list[].params:
{ agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" }, models: { "anthropic/claude-opus-4-6": { params: { cacheRetention: "long" }, }, }, }, list: [ { id: "research", default: true }, { id: "alerts", params: { cacheRetention: "none" } }, ], },}Порядок об’єднання конфігурації:
agents.defaults.models["provider/model"].paramsagents.list[].params(відповіднийid, перевизначає за ключем)
Це дає змогу одному агенту зберігати довготривалий кеш, тоді як інший агент на тій самій моделі вимикає кешування для пікового трафіку або трафіку з низьким повторним використанням.
Нотатки щодо Bedrock Claude
- Моделі Anthropic Claude на Bedrock (
amazon-bedrock/*anthropic.claude*) приймають наскрізнийcacheRetention, коли його налаштовано. - Не-Anthropic моделі Bedrock примусово отримують
cacheRetention: "none"під час виконання. - Розумні стандартні значення для API-ключа також задають
cacheRetention: "short"для посилань Claude-on-Bedrock, коли явне значення не встановлено.
Розширена конфігурація
Швидкий режим
Спільний перемикач OpenClaw /fast підтримує прямий трафік Anthropic (API-ключ і OAuth до api.anthropic.com).
| Команда | Відповідає |
|---|---|
/fast on |
service_tier: "auto" |
/fast off |
service_tier: "standard_only" |
{ agents: { defaults: { models: { "anthropic/claude-sonnet-4-6": { params: { fastMode: true }, }, }, }, },}Розуміння медіа (зображення та PDF)
Вбудований Plugin Anthropic реєструє розуміння зображень і PDF. OpenClaw автоматично визначає медіаможливості з налаштованої автентифікації Anthropic — додаткова конфігурація не потрібна.
| Властивість | Значення |
|---|---|
| Стандартна модель | claude-opus-4-8 |
| Підтримуване введення | Зображення, PDF-документи |
Коли до розмови прикріплено зображення або PDF, OpenClaw автоматично маршрутизує його через провайдера розуміння медіа Anthropic.
Контекстне вікно 1M
Контекстне вікно Anthropic 1M доступне в GA-сумісних моделях Claude 4.x, як-от Opus 4.8, Opus 4.7, Opus 4.6 і Sonnet 4.6. OpenClaw автоматично задає для цих моделей розмір 1M:
{ agents: { defaults: { models: { "anthropic/claude-opus-4-6": {}, }, }, },}Старіші конфігурації можуть зберігати params.context1m: true, але OpenClaw більше не надсилає
вилучений бета-заголовок context-1m-2025-08-07. Старіші записи конфігурації anthropicBeta
з цим значенням ігноруються під час визначення заголовків запиту, а
непідтримувані старіші моделі Claude залишаються на своєму звичайному контекстному вікні.
params.context1m: true також застосовується до бекенда Claude CLI
(claude-cli/*) для відповідних GA-сумісних моделей Opus і Sonnet, зберігаючи
контекстне вікно під час виконання для цих сеансів CLI, щоб воно відповідало поведінці
прямого API.
Контекст 1M для Claude Opus 4.8
anthropic/claude-opus-4-8 та його варіант claude-cli мають контекстне
вікно 1M за замовчуванням — params.context1m: true не потрібен.
Усунення несправностей
Помилки 401 / токен раптово став недійсним
Автентифікація токеном Anthropic має строк дії та може бути відкликана. Для нових налаштувань натомість використовуйте API-ключ Anthropic.
API-ключ для провайдера "anthropic" не знайдено
Автентифікація Anthropic є окремою для кожного агента — нові агенти не успадковують ключі головного агента. Повторно запустіть онбординг для цього агента (або налаштуйте API-ключ на хості Gateway), потім перевірте за допомогою openclaw models status.
Облікові дані для профілю "anthropic:default" не знайдено
Запустіть openclaw models status, щоб побачити, який профіль автентифікації активний. Повторно запустіть онбординг або налаштуйте API-ключ для цього шляху профілю.
Немає доступного профілю автентифікації (усі в cooldown)
Перевірте auth.unusableProfiles у openclaw models status --json. Cooldown через обмеження частоти Anthropic може бути прив’язаний до моделі, тому споріднена модель Anthropic може все ще бути придатною для використання. Додайте інший профіль Anthropic або зачекайте завершення cooldown.
Пов’язане
Вибір провайдерів, посилань на моделі та поведінки відмовостійкого перемикання.
Налаштування бекенда Claude CLI та деталі виконання.
Як кешування промптів працює між провайдерами.
Деталі автентифікації та правила повторного використання облікових даних.