​

Anthropic (Claude)

​

Варіант A: API-ключ Anthropic

​

Налаштування CLI

openclaw onboard
# choose: Anthropic API key

# or non-interactive
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

​

Фрагмент конфігурації Anthropic

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

​

Типові параметри thinking (Claude 4.6)

• Для моделей Anthropic Claude 4.6 в OpenClaw типовим значенням є adaptive thinking, якщо явний рівень thinking не задано.
• Ви можете перевизначити його для окремого повідомлення (/think:<level>) або в параметрах моделі: agents.defaults.models["anthropic/<model>"].params.thinking.
• Пов’язана документація Anthropic:
  • Adaptive thinking
  • Extended thinking

​

Fast mode (Anthropic API)

• /fast on зіставляється з service_tier: "auto"
• /fast off зіставляється з service_tier: "standard_only"
• Типове значення в конфігурації:

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}

• 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)

​

Конфігурація

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}

​

Типові значення

​

Перевизначення cacheRetention для окремого агента

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" }, // baseline for most agents
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } }, // override for this agent only
    ],
  },
}

1. agents.defaults.models["provider/model"].params
2. agents.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)

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { context1m: true },
        },
      },
    },
  },
}

​

Бекенд Claude CLI

• Співробітники Anthropic повідомили нам, що таке використання знову дозволене.
• Тому OpenClaw вважає повторне використання Claude CLI та використання claude -p санкціонованими для цієї інтеграції, якщо Anthropic не опублікує нову політику.
• API-ключі Anthropic залишаються найзрозумілішим шляхом для production для постійно активних хостів gateway та явного серверного контролю виставлення рахунків.
• Докладно про налаштування та виконання див. у /gateway/cli-backends.

​

Примітки

• У публічній документації Anthropic про Claude Code усе ще описано пряме використання CLI, таке як claude -p, а співробітники Anthropic повідомили нам, що використання Claude CLI у стилі OpenClaw знову дозволене. Ми вважаємо ці вказівки остаточними, якщо Anthropic не опублікує нову зміну політики.
• Anthropic setup-token залишається доступним в OpenClaw як підтримуваний шлях автентифікації токеном, але OpenClaw тепер надає перевагу повторному використанню Claude CLI та claude -p, коли це доступно.
• Докладно про автентифікацію та правила повторного використання див. у /concepts/oauth.

​

Усунення неполадок

• Автентифікація токеном Anthropic може сплинути або бути відкликана.
• Для нових налаштувань перейдіть на API-ключ Anthropic.

• Автентифікація є для кожного агента окремо. Нові агенти не успадковують ключі головного агента.
• Повторно запустіть onboarding для цього агента або налаштуйте API-ключ на хості gateway, а потім перевірте через openclaw models status.

• Виконайте openclaw models status, щоб побачити, який профіль автентифікації активний.
• Повторно запустіть onboarding або налаштуйте API-ключ для шляху цього профілю.

• Перевірте openclaw models status --json для auth.unusableProfiles.
• Кулдауни rate-limit Anthropic можуть бути прив’язані до конкретної моделі, тож споріднена модель Anthropic усе ще може бути придатною, навіть якщо поточна перебуває в кулдауні.
• Додайте інший профіль Anthropic або дочекайтеся завершення кулдауну.