Providers
Anthropic
Anthropic розробляє сімейство моделей Claude. OpenClaw підтримує два способи автентифікації:
- Ключ API — прямий доступ до API Anthropic з оплатою за використання (моделі
anthropic/*) - Claude CLI — повторне використання наявного входу в Claude Code на тому самому хості
Відстеження використання та витрат
OpenClaw виявляє доступні облікові дані Anthropic і вибирає відповідний інтерфейс відомостей про використання:
- Облікові дані підписки або налаштування Claude показують періоди квот і необов’язковий бюджет додаткового використання.
ANTHROPIC_ADMIN_KEYабоANTHROPIC_ADMIN_API_KEYпоказує у розділі Використання інтерфейсу керування витрати організації та використання Messages API за 30 днів за даними постачальника, зокрема щоденні витрати, загальні обсяги токенів і кешу, найпопулярніші моделі та категорії витрат.- Облікові дані
sk-ant-admin..., збережені у профілі постачальника Anthropic, автоматично визначаються як ключ Admin API.
Історія витрат Admin API надходить з API використання та витрат Anthropic. Це фактичні рахунки постачальника, окремі від оцінки витрат OpenClaw, обчисленої на основі сеансів.
Початок роботи
Ключ API
Найкраще підходить для: стандартного доступу до API та оплати за використання.
Отримайте ключ API
Створіть ключ API у консолі Anthropic.
Запустіть початкове налаштування
openclaw onboard# виберіть: ключ API AnthropicАбо передайте ключ безпосередньо:
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# виберіть: Claude CLIOpenClaw виявляє та повторно використовує наявні облікові дані Claude CLI.
Перевірте доступність моделі
openclaw models list --provider anthropicОтримання токена налаштування
Запустіть claude setup-token на будь-якому комп’ютері зі встановленим Claude Code. Команда виведе
довготривалий токен, що починається з sk-ant-oat01-.
Під час початкового налаштування вставте токен у застосунку macOS, вибравши Anthropic setup-token у розділі Connect with an API key or token, або скористайтеся командою:
openclaw models auth login --provider anthropic --method setup-tokenПриклад конфігурації
Надавайте перевагу канонічному посиланню на модель 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
Для запусків Claude CLI OpenClaw використовує неінтерактивний шлях claude -p Claude Code.
Наразі Anthropic вважає цей шлях використанням Agent SDK або програмним доступом:
- В оновленні служби підтримки Anthropic від 15 червня 2026 року призупинено раніше оголошений план окремих кредитів Agent SDK.
- Використання Claude Agent SDK у межах плану підписки,
claude -pі сторонніх застосунків усе ще враховується в межах лімітів використання підписки, у яку виконано вхід. - Раніше оголошений щомісячний кредит Agent SDK недоступний, поки Anthropic переглядає цей план.
- Для входів через консоль або ключ API застосовується оплата API за фактичне використання; такі входи не отримують кредит Agent SDK за підпискою.
Повідомлення про призупинення наведено у статті Anthropic про план Agent SDK, а поведінку підписок описано в статтях про плани Claude Code: Pro/Max і Team/Enterprise.
Anthropic може змінити тарифікацію Claude Code і поведінку обмеження частоти запитів без
випуску нової версії OpenClaw. Якщо передбачуваність тарифікації важлива, перевіряйте claude auth status, /status і
документацію Anthropic за наведеними посиланнями.
Сеанси Claude на різних комп’ютерах
Вбудований Plugin Anthropic додає групу Claude Code до звичайної бічної панелі сеансів. Рядки відкриваються у звичайній панелі чату. Він виявляє неархівовані сеанси Claude Code на Gateway і підключених хостах Node:
- Сеанси Claude CLI надходять із дійсних записів індексу проєктів і поточних файлів JSONL,
обмежений префікс метаданих яких визначає сеанс
sdk-cli, що не є бічним ланцюжком, у каталозі~/.claude/projects/. - Сеанси Claude Desktop використовують назву Desktop, час активності та стан архівування, коли його метадані вказують на той самий ідентифікатор сеансу Claude Code.
- Сеанс лише CLI не має прапорця архівування, тому залишається видимим, доки існує його стенограма.
Для виявлення не потрібна додаткова конфігурація OpenClaw. Plugin Anthropic
вбудовано й увімкнено за замовчуванням; нативний Node macOS оголошує доступні лише для читання
команди сеансів Claude, коли існує локальний каталог ~/.claude/projects/.
Схваліть оновлення сполучення Node, коли ці команди з’являться вперше.
Бічна панель групує рядки за їхнім Gateway або хостом сполученого Node, спочатку показує
найновішу обмежену сторінку з кожного хоста й оновлюється зі звичайним
30-секундним інтервалом. Скористайтеся пунктом Завантажити більше сеансів під групою каталогу, щоб додати наступну сторінку
для кожного хоста, що має більше історії; додані рядки залишаються видимими й
повторно завантажуються до тієї самої глибини під час оновлень. Клієнти каталогу використовують
sessions.catalog.list; відкриття рядка використовує sessions.catalog.read.
Під час передавання керування терміналу claude визначається з PATH оболонки входу
користувача-власника хоста перед PATH служби або демона. Завдяки цьому сеанси, запущені із застосунку, використовують
той самий Claude CLI, який оператор отримує у звичайному терміналі.
Після вибору рядка спочатку зчитується найновіша сторінка стенограми. Пункт Завантажити старіші елементи стенограми переходить за непрозорим байтовим курсором і зчитує ще одну обмежену частину файлу JSONL замість завантаження всієї історії. Звичайний вміст користувача, асистента, міркувань, викликів інструментів і результатів інструментів зберігається. Окремий елемент, розмір якого перевищує граничне безпечне значення Node або Gateway, чітко позначається як обрізаний.
Якщо ввести текст у звичайному редакторі повідомлення для локального рядка Gateway claude-cli,
буде викликано sessions.catalog.continue. OpenClaw повторно визначає локальний запис каталогу,
створює або повторно використовує нативний сеанс, закріплений за моделлю, імпортує не більше ніж 200 видимих
елементів або 512 КіБ і ініціалізує прив’язку Claude CLI. Перший хід відновлюється за допомогою
--fork-session; Claude призначає відгалуженню новий ідентифікатор сеансу, тому наступні ходи використовують
відгалуження, а вихідний сеанс залишається незмінним.
Хост Node без графічного інтерфейсу також може дозволити продовження своїх рядків Claude CLI, увімкнувши наведене нижче локальне налаштування Node й перезапустивши хост Node:
{ nodeHost: { agentRuns: { claude: { enabled: true }, }, },}Node оголошує agent.cli.claude.run.v1 лише тоді, коли налаштування ввімкнено
і його локальний виконуваний файл claude вдається знайти. OpenClaw повторно визначає запис каталогу
на цьому Node, імпортує ту саму обмежену історію та прив’язує прийнятий
сеанс до Node і робочого каталогу, вказаного каталогом. Кожен хід запускає
справжній процес claude -p цього Node, використовуючи файли Claude й обліковий запис цього Node. Політика
схвалення виконання Node продовжує діяти; Gateway не може примусово ввімкнути цю можливість.
Продовження на Node версії 1 є лише одноразовим. Воно не додає конфігурацію зворотного підключення MCP до Gateway і аргументи Plugin Skills Gateway, не виконує повторну ініціалізацію зі стенограми Gateway та відхиляє вкладення й зображення. Рядки Claude Desktop залишаються доступними лише для перегляду. Нативні Node застосунку macOS також залишаються доступними лише для перегляду, доки застосунок не оголосить команду запуску.
Докладніше про команду Node і межі безпеки див. у розділі Node: сеанси та стенограми Claude.
Типові налаштування мислення (Claude Sonnet 5, Mythos 5, Fable 5, 4.8 і 4.6)
anthropic/claude-sonnet-5 за замовчуванням використовує адаптивне мислення з рівнем зусиль high.
Використовуйте /think off, щоб вимкнути мислення, або /think xhigh|max, щоб вибрати вищі
вбудовані рівні зусиль моделі. OpenClaw не задає вручну бюджети мислення, користувацькі
параметри семплювання, попереднє заповнення відповіді асистента та Priority Tier для Sonnet 5, оскільки
Anthropic не підтримує ці функції запитів для цієї моделі.
У каталозі до 31 серпня 2026 року включно застосовується початкова ціна Anthropic $2/$10 за введення/виведення;
стандартна ціна $3/$15 починає діяти 1 вересня 2026 року.
anthropic/claude-fable-5 завжди використовує адаптивне мислення, а рівень зусиль за замовчуванням — high.
Anthropic не дає змоги вимкнути мислення для цієї моделі, тому
/think off і /think minimal натомість зіставляються з рівнем зусиль low. OpenClaw також
не передає користувацькі значення температури в запитах до Fable 5, оскільки Anthropic відхиляє
перевизначення температури в будь-якому запиті з увімкненим мисленням.
anthropic/claude-mythos-5 — модель з обмеженим доступом і таким самим контрактом
постійно ввімкненого адаптивного мислення. У OpenClaw за замовчуванням використовується high,
/think off і /think minimal зіставляються з low, а вибрані викликачем параметри семплювання не передаються.
У каталозі зазначено її контекстне вікно на 1,000,000 токенів, обмеження виведення
на 128,000 токенів, підтримку зображень на вході та ціну $10/$50 за введення/виведення.
У OpenClaw для Claude Opus 4.8 мислення за замовчуванням вимкнено. Коли адаптивне мислення
явно вмикається за допомогою /think high|xhigh|max, OpenClaw передає
значення рівня зусиль Anthropic для Opus 4.8; у моделях Claude 4.6 (Opus 4.6 і Sonnet 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: бета-заголовок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 також відмовляє, хід повертає відмову як помилку — так само, як до впровадження цієї функції.
Перемикання на резервну модель відбувається на рівні API Anthropic, тому 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.
- У разі відмови посеред потоку Anthropic додатково тарифікує вже передану потоково частину Fable; ця частина відображається в статистиці використання 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, перевизначення за ключем)
Завдяки цьому один агент може використовувати довготривалий кеш, а інший агент на тій самій моделі — вимкнути кешування для сплескового трафіку або трафіку з низьким рівнем повторного використання.
Примітки щодо Claude у Bedrock
- Моделі Anthropic Claude у Bedrock (
amazon-bedrock/*anthropic.claude*) приймають наскрізний параметрcacheRetention, якщо його налаштовано. - Для моделей Bedrock не від Anthropic у середовищі виконання примусово встановлюється
cacheRetention: "none". - Інтелектуальні значення за замовчуванням для ключа API також задають
cacheRetention: "short"для посилань на Claude у Bedrock, якщо явне значення не встановлено.
Розширена конфігурація
Швидкий режим
Спільний перемикач OpenClaw /fast задає поле Anthropic service_tier для прямого трафіку з ключем API до 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
Claude Sonnet 5, Mythos 5 і Fable 5 мають точне вхідне вікно
на 1,000,000 токенів і підтримують до 128,000 токенів виведення. Контекстне вікно 1M від Anthropic
також загальнодоступне для моделей Claude 4.x з адаптивним мисленням: Opus 4.8,
Opus 4.7, Opus 4.6 і Sonnet 4.6. OpenClaw визначає розміри цих моделей
автоматично, тому params.context1m не потрібен:
{ agents: { defaults: { models: { "anthropic/claude-sonnet-5": {}, "anthropic/claude-mythos-5": {}, "anthropic/claude-opus-4-6": {}, }, }, },}У старіших конфігураціях можна залишити params.context1m: true; для
цих моделей він нічого не робить і не шкодить, а OpenClaw більше не надсилає застарілий
бета-заголовок context-1m-2025-08-07 за жодних обставин. Старіші записи конфігурації anthropicBeta
із цим значенням вилучаються під час визначення заголовків запиту, а
непідтримувані старіші моделі Claude зберігають своє звичайне контекстне вікно.
params.context1m: true працює так само для бекенду Claude CLI
(claude-cli/*): сумісні моделі Opus і Sonnet із загальнодоступною підтримкою вже автоматично отримують
вікно 1M, тому цей параметр і там необов’язковий.
Контекст 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 для шляху цього профілю.
Немає доступного профілю автентифікації (усі в періоді очікування)
Перевірте openclaw models status --json для auth.unusableProfiles. Періоди очікування через обмеження частоти запитів Anthropic можуть діяти лише для певної моделі, тому інша модель Anthropic усе ще може бути доступною. Додайте ще один профіль Anthropic або зачекайте, доки завершиться період очікування.
Пов’язане
Вибір постачальників, посилань на моделі та поведінки перемикання в разі відмови.
Налаштування серверної частини Claude CLI та відомості про середовище виконання.
Як кешування запитів працює з різними постачальниками.
Відомості про автентифікацію та правила повторного використання облікових даних.