- Ключ 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.
Початок роботи
- Ключ API
- Claude CLI
Найкраще підходить для: стандартного доступу до API та оплати за використання.Або передайте ключ безпосередньо:
1
Отримайте ключ API
Створіть ключ API у консолі Anthropic.
2
Запустіть початкове налаштування
3
Перевірте доступність моделі
Приклад конфігурації
Сеанси Claude на різних комп’ютерах
Вбудований Plugin Anthropic додає групу Claude Code до звичайної бічної панелі сеансів. Рядки відкриваються у звичайній панелі чату. Він виявляє неархівовані сеанси Claude Code на Gateway і підключених хостах Node:- Сеанси Claude CLI надходять із дійсних записів індексу проєктів і поточних файлів JSONL,
обмежений префікс метаданих яких визначає сеанс
sdk-cli, що не є бічним ланцюжком, у каталозі~/.claude/projects/. - Сеанси Claude Desktop використовують назву Desktop, час активності та стан архівування, коли його метадані вказують на той самий ідентифікатор сеансу Claude Code.
- Сеанс лише CLI не має прапорця архівування, тому залишається видимим, доки існує його стенограма.
~/.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:
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 також залишаються доступними лише для перегляду, доки застосунок не оголосить команду запуску.
Сеанси Claude на сполучених Node залишаються доступними лише для читання, якщо Node без графічного інтерфейсу явно не
оголошує
agent.cli.claude.run.v1. OpenClaw ніколи не змінює метадані Claude Desktop
і не архівує сеанси Claude. Сторінка потребує підключення оператора
з дозволом на запис, оскільки використовує автентифікований node.invoke; операції переліку й читання
залишаються доступними лише для читання навіть на Node з увімкненим продовженням.Типові налаштування мислення (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> або в параметрах моделі:
Пов’язана документація Anthropic:
Резервна модель у разі відмови з міркувань безпеки (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 також відмовляє, хід повертає відмову як помилку — так само, як до впровадження цієї функції.
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.Перевизначення кешу для окремих агентів
Перевизначення кешу для окремих агентів
Використовуйте параметри рівня моделі як базові, а потім перевизначайте їх для окремих агентів через Порядок об’єднання конфігурації:
agents.list[].params:agents.defaults.models["provider/model"].paramsagents.list[].params(відповіднийid, перевизначення за ключем)
Примітки щодо Claude у Bedrock
Примітки щодо 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.- Застосовується лише до прямих запитів
api.anthropic.com, виконаних із ключем API. Запити з OAuth/токеном підписки та маршрути через проксі ніколи не отримують полеservice_tier. - Явні параметри
serviceTierабоservice_tierперевизначають/fast, якщо задано обидва. - В облікових записах без доступної потужності Priority Tier значення
service_tier: "auto"може бути перетворено наstandard.
Розуміння медіа (зображення та PDF)
Розуміння медіа (зображення та PDF)
Вбудований Plugin Anthropic реєструє можливості розуміння зображень і PDF. OpenClaw
автоматично визначає можливості обробки медіа на основі налаштованої автентифікації Anthropic;
додаткова конфігурація не потрібна.
Коли до розмови прикріплено зображення або PDF, OpenClaw автоматично
спрямовує його через провайдера розуміння медіа Anthropic.
Контекстне вікно 1M
Контекстне вікно 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 не потрібен: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
Контекст 1M у Claude Opus 4.8
anthropic/claude-opus-4-8 і його варіант claude-cli за замовчуванням мають контекстне
вікно 1M; params.context1m: true не потрібен.Усунення несправностей
Помилки 401 / токен раптово став недійсним
Помилки 401 / токен раптово став недійсним
Автентифікаційні токени Anthropic мають термін дії та можуть бути відкликані. Для нових налаштувань натомість використовуйте ключ API Anthropic.
Ключ API для провайдера "anthropic" не знайдено
Ключ API для провайдера "anthropic" не знайдено
Автентифікація Anthropic налаштовується для кожного агента окремо; нові агенти не успадковують ключі головного агента. Повторно виконайте початкове налаштування для цього агента (або налаштуйте ключ API на хості Gateway), а потім перевірте за допомогою
openclaw models status.Облікові дані для профілю "anthropic:default" не знайдено
Облікові дані для профілю "anthropic:default" не знайдено
Виконайте
openclaw models status, щоб дізнатися, який профіль автентифікації активний. Повторно виконайте початкове налаштування або налаштуйте ключ API для шляху цього профілю.Немає доступного профілю автентифікації (усі в періоді очікування)
Немає доступного профілю автентифікації (усі в періоді очікування)
Перевірте
openclaw models status --json для auth.unusableProfiles. Періоди очікування через обмеження частоти запитів Anthropic можуть діяти лише для певної моделі, тому інша модель Anthropic усе ще може бути доступною. Додайте ще один профіль Anthropic або зачекайте, доки завершиться період очікування.Додаткова допомога: Усунення несправностей і Поширені запитання.
Пов’язане
Вибір моделі
Вибір постачальників, посилань на моделі та поведінки перемикання в разі відмови.
Серверні частини CLI
Налаштування серверної частини Claude CLI та відомості про середовище виконання.
Кешування запитів
Як кешування запитів працює з різними постачальниками.
OAuth і автентифікація
Відомості про автентифікацію та правила повторного використання облікових даних.