Перейти до основного вмісту

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Anthropic створює сімейство моделей Claude. OpenClaw підтримує два способи автентифікації:
  • API-ключ — прямий доступ до Anthropic API з оплатою за використання (моделі anthropic/*)
  • Claude CLI — повторне використання наявного входу Claude CLI на тому самому хості
Співробітники Anthropic повідомили нам, що використання Claude CLI у стилі OpenClaw знову дозволене, тому OpenClaw вважає повторне використання Claude CLI і використання claude -p санкціонованими, доки Anthropic не опублікує нову політику.Для довготривалих хостів gateway Anthropic API-ключі все ще є найчіткішим і найбільш передбачуваним виробничим шляхом.Поточна публічна документація Anthropic:

Початок роботи

Найкраще для: стандартного доступу до API та оплати за використання.
1

Отримайте свій API-ключ

Створіть API-ключ у Anthropic Console.
2

Запустіть початкове налаштування

openclaw onboard
# choose: Anthropic API key
Або передайте ключ безпосередньо:
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
3

Перевірте, що модель доступна

openclaw models list --provider anthropic

Приклад конфігурації

{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

Стандартні налаштування мислення (Claude 4.6)

Моделі Claude 4.6 за замовчуванням використовують adaptive мислення в OpenClaw, якщо явний рівень мислення не задано. Перевизначайте для окремого повідомлення за допомогою /think:<level> або в параметрах моделі:
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { thinking: "adaptive" },
        },
      },
    },
  },
}
Пов’язана документація 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" } },
    ],
  },
}
Порядок злиття конфігурації:
  1. agents.defaults.models["provider/model"].params
  2. agents.list[].params (відповідний id, перевизначення за ключем)
Це дає змогу одному агенту зберігати довготривалий кеш, тоді як інший агент на тій самій моделі вимикає кешування для сплескового трафіку або трафіку з низьким повторним використанням.
  • Моделі Anthropic Claude на Bedrock (amazon-bedrock/*anthropic.claude*) приймають наскрізний cacheRetention, якщо його налаштовано.
  • Для моделей Bedrock, що не належать Anthropic, під час виконання примусово встановлюється cacheRetention: "none".
  • Розумні стандартні налаштування API-ключа також задають cacheRetention: "short" для посилань Claude-на-Bedrock, якщо явне значення не встановлено.

Розширена конфігурація

Спільний перемикач /fast в OpenClaw підтримує прямий трафік Anthropic (API-ключ і OAuth до api.anthropic.com).
КомандаВідповідає
/fast onservice_tier: "auto"
/fast offservice_tier: "standard_only"
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}
  • Додається лише для прямих запитів до api.anthropic.com. Проксі-маршрути залишають service_tier без змін.
  • Явні параметри serviceTier або service_tier перевизначають /fast, коли встановлено обидва.
  • Для облікових записів без ємності Priority Tier service_tier: "auto" може перетворитися на standard.
Вбудований Plugin Anthropic реєструє розуміння зображень і PDF. OpenClaw автоматично визначає медіаможливості з налаштованої автентифікації Anthropic — додаткова конфігурація не потрібна.
ВластивістьЗначення
Типова модельclaude-opus-4-7
Підтримуваний ввідЗображення, PDF-документи
Коли зображення або PDF додано до розмови, OpenClaw автоматично спрямовує його через провайдера розуміння медіа Anthropic.
Контекстне вікно 1M Anthropic доступне через бета-доступ. Увімкніть його для окремої моделі:
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { context1m: true },
        },
      },
    },
  },
}
OpenClaw відображає це в anthropic-beta: context-1m-2025-08-07 у запитах.params.context1m: true також застосовується до бекенда Claude CLI (claude-cli/*) для відповідних моделей Opus і Sonnet, розширюючи контекстне вікно виконання для цих CLI-сеансів, щоб воно відповідало поведінці прямого API.
Потрібен доступ до довгого контексту для ваших облікових даних Anthropic. Застаріла токенна автентифікація (sk-ant-oat-*) відхиляється для запитів контексту 1M — OpenClaw записує попередження в журнал і повертається до стандартного контекстного вікна.
anthropic/claude-opus-4.7 і його варіант claude-cli мають контекстне вікно 1M за замовчуванням — params.context1m: true не потрібен.

Усунення несправностей

Токенна автентифікація Anthropic має строк дії і може бути відкликана. Для нових налаштувань натомість використовуйте Anthropic API-ключ.
Автентифікація Anthropic є окремою для кожного агента — нові агенти не успадковують ключі основного агента. Повторно запустіть початкове налаштування для цього агента (або налаштуйте API-ключ на хості gateway), а потім перевірте за допомогою openclaw models status.
Запустіть openclaw models status, щоб побачити, який профіль автентифікації активний. Повторно запустіть початкове налаштування або налаштуйте API-ключ для цього шляху профілю.
Перевірте openclaw models status --json для auth.unusableProfiles. Періоди очікування через обмеження частоти Anthropic можуть бути прив’язані до моделі, тому споріднена модель Anthropic все ще може бути придатною до використання. Додайте інший профіль Anthropic або дочекайтеся завершення періоду очікування.
Більше допомоги: Усунення несправностей і FAQ.

Пов’язане

Вибір моделі

Вибір провайдерів, посилань на моделі та поведінки відмовостійкості.

Бекенди CLI

Налаштування бекенда Claude CLI та подробиці виконання.

Кешування промптів

Як кешування промптів працює між провайдерами.

OAuth і автентифікація

Подробиці автентифікації та правила повторного використання облікових даних.