Anthropic (Claude)
Anthropic створює сімейство моделей Claude і надає доступ через API. У OpenClaw нове налаштування Anthropic має використовувати API-ключ. Наявні застарілі профілі токенів Anthropic і далі враховуються під час виконання, якщо вони вже налаштовані.Варіант A: Anthropic API key
Найкраще для: стандартного доступу до API та білінгу на основі використання. Створіть свій API-ключ у Anthropic Console.Налаштування CLI
Фрагмент конфігурації Anthropic
Типові параметри thinking (Claude 4.6)
- Для моделей Anthropic Claude 4.6 в OpenClaw за замовчуванням використовується
adaptivethinking, якщо не задано явний рівень thinking. - Ви можете перевизначити це для окремого повідомлення (
/think:<level>) або в параметрах моделі:agents.defaults.models["anthropic/<model>"].params.thinking. - Пов’язана документація Anthropic:
Швидкий режим (Anthropic API)
Спільний перемикач/fast в OpenClaw також підтримує прямий публічний трафік Anthropic, включно із запитами з auth через API-key та OAuth, надісланими до api.anthropic.com.
/fast onвідповідаєservice_tier: "auto"/fast offвідповідаєservice_tier: "standard_only"- Значення конфігурації за замовчуванням:
- OpenClaw додає рівні сервісу Anthropic лише для прямих запитів до
api.anthropic.com. Якщо ви маршрутизуєтеanthropic/*через proxy або gateway,/fastне змінюєservice_tier. - Явні параметри моделі Anthropic
serviceTierабоservice_tierмають пріоритет над типовим значенням/fast, якщо задано обидва. - Anthropic повідомляє про фактичний рівень у відповіді в полі
usage.service_tier. Для облікових записів без доступної місткості Priority Tier значенняservice_tier: "auto"усе одно може звестися доstandard.
Кешування prompt (Anthropic API)
OpenClaw підтримує можливість кешування prompt від Anthropic. Це лише для API; застаріла auth через токен Anthropic не враховує налаштування кешу.Конфігурація
Використовуйте параметрcacheRetention у конфігурації моделі:
| Значення | Тривалість кешу | Опис |
|---|---|---|
none | Без кешування | Вимкнути кешування prompt |
short | 5 хвилин | Значення за замовчуванням для auth через API Key |
long | 1 година | Розширений кеш |
Значення за замовчуванням
Під час використання автентифікації через Anthropic API Key OpenClaw автоматично застосовуєcacheRetention: "short" (кеш на 5 хвилин) для всіх моделей Anthropic. Ви можете перевизначити це, явно задавши cacheRetention у своїй конфігурації.
Перевизначення cacheRetention для окремих агентів
Використовуйте параметри на рівні моделі як базовий варіант, а потім перевизначайте конкретних агентів черезagents.list[].params.
agents.defaults.models["provider/model"].paramsagents.list[].params(відповіднийid, перевизначення за ключем)
Примітки щодо Bedrock Claude
- Моделі Anthropic Claude у Bedrock (
amazon-bedrock/*anthropic.claude*) приймають наскрізну передачуcacheRetention, якщо її налаштовано. - Для моделей Bedrock, які не є Anthropic, під час виконання примусово встановлюється
cacheRetention: "none". - Розумні типові значення Anthropic API-key також задають
cacheRetention: "short"для посилань на моделі Claude-on-Bedrock, якщо явне значення не встановлено.
Вікно контексту 1M (бета Anthropic)
Вікно контексту 1M від Anthropic є бета-можливістю з обмеженим доступом. У OpenClaw увімкніть його для окремої моделі черезparams.context1m: true для підтримуваних моделей Opus/Sonnet.
anthropic-beta: context-1m-2025-08-07 у запитах
Anthropic.
Це активується лише тоді, коли params.context1m явно встановлено в true для
цієї моделі.
Вимога: Anthropic має дозволяти використання довгого контексту для цих облікових даних
(зазвичай білінг через API key або шлях Claude-login / застарілу auth через токен в OpenClaw
з увімкненим Extra Usage). Інакше Anthropic повертає:
HTTP 429: rate_limit_error: Extra usage is required for long context requests.
Примітка: наразі Anthropic відхиляє бета-запити context-1m-* при використанні
застарілої auth через токен Anthropic (sk-ant-oat-*). Якщо ви налаштуєте
context1m: true з цим застарілим режимом auth, OpenClaw запише попередження в журнал і
повернеться до стандартного вікна контексту, пропустивши beta-заголовок context1m,
але зберігши потрібні beta-параметри OAuth.
Видалено: бекенд Claude CLI
Вбудований бекенд Anthropicclaude-cli було видалено.
- У повідомленні Anthropic від 4 квітня 2026 року сказано, що трафік Claude-login, ініційований OpenClaw, є використанням стороннього harness і вимагає Extra Usage.
- Наші локальні відтворення також показують, що прямий
claude -p --append-system-prompt ...може натрапити на ту саму перевірку, коли доданий prompt ідентифікує OpenClaw. - Та сама форма system prompt у стилі OpenClaw не викликає цю перевірку на
шляху Anthropic SDK +
ANTHROPIC_API_KEY. - Для трафіку Anthropic в OpenClaw використовуйте API-ключі Anthropic.
Примітки
- Публічна документація Anthropic для Claude Code усе ще описує пряме використання CLI, зокрема
claude -p, але окреме повідомлення Anthropic для користувачів OpenClaw каже, що шлях Claude-login у OpenClaw є використанням стороннього harness і вимагає Extra Usage (pay-as-you-go, що оплачується окремо від підписки). Наші локальні відтворення також показують, що прямийclaude -p --append-system-prompt ...може натрапити на ту саму перевірку, коли доданий prompt ідентифікує OpenClaw, тоді як та сама форма prompt не відтворює це на шляху Anthropic SDK +ANTHROPIC_API_KEY. Для production ми натомість рекомендуємо Anthropic API-ключі. - Anthropic setup-token знову доступний в OpenClaw як застарілий/ручний шлях. Повідомлення Anthropic щодо білінгу для OpenClaw усе ще застосовується, тож використовуйте його з розумінням того, що Anthropic вимагає Extra Usage для цього шляху.
- Деталі auth і правила повторного використання наведено в /concepts/oauth.
Усунення несправностей
Помилки 401 / токен раптово став недійсним- Застаріла auth через токен Anthropic може завершитися або бути відкликаною.
- Для нового налаштування перейдіть на Anthropic API key.
- Auth є для кожного агента окремо. Нові агенти не успадковують ключі головного агента.
- Повторно запустіть онбординг для цього агента або налаштуйте API key на host
gateway, а потім перевірте через
openclaw models status.
anthropic:default
- Запустіть
openclaw models status, щоб побачити, який профіль auth активний. - Повторно запустіть онбординг або налаштуйте API key для цього шляху профілю.
- Перевірте
openclaw models status --jsonдляauth.unusableProfiles. - Cooldown через обмеження швидкості Anthropic може бути прив’язаний до моделі, тож сусідня модель Anthropic все ще може бути придатною до використання, навіть якщо поточна перебуває в cooldown.
- Додайте ще один профіль Anthropic або дочекайтеся завершення cooldown.