Anthropic

• API 키 — 사용량 기반 청구가 적용되는 Anthropic API 직접 액세스(anthropic/* 모델)
• Claude CLI — 같은 호스트의 기존 Claude Code 로그인을 재사용

​

시작하기

openclaw onboard
# choose: Anthropic API key

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 --version

openclaw onboard
# choose: Claude CLI

openclaw models list --provider anthropic

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-8" },
      models: {
        "anthropic/claude-opus-4-8": {
          agentRuntime: { id: "claude-cli" },
        },
      },
    },
  },
}

​

사고 기본값(Claude Fable 5, 4.8, 4.6)

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-8": {
          params: { thinking: "high" },
        },
      },
    },
  },
}

​

안전 거부 폴백(Claude Fable 5)

​

이 기능이 있는 이유

​

작동 방식

1. anthropic/claude-fable-5로 보내는 모든 직접 API 키 요청에 대해 OpenClaw는 Anthropic의 서버 측 폴백 옵트인을 전송합니다. 즉, server-side-fallback-2026-06-01 베타 헤더와 fallbacks: [{"model": "claude-opus-4-8"}]를 함께 보냅니다. Claude Opus 4.8은 Anthropic이 Fable 5에 허용하는 유일한 폴백 대상입니다.
2. 안전 분류기 거절만 폴백을 트리거합니다. 속도 제한, 과부하, 서버 오류는 이전과 정확히 동일하게 동작하며 OpenClaw의 일반 모델 장애 조치를 거칩니다.
3. 구조는 같은 호출 안에서 일어납니다. 출력 전에 거절되면 지연 시간 외에는 보이지 않으며 전체 답변은 Opus 4.8에서 나옵니다. 스트림 중간 거절의 경우 부분 텍스트는 폴백 모델이 이어서 계속할 접두사로 유지되고, 거절된 모델의 reasoning과 도구 호출은 Anthropic의 재생 규칙에 따라 폐기됩니다(다시 되돌려 보내거나 실행해서는 안 됩니다).
4. Claude Opus 4.8도 거절하면, 이 기능 이전과 정확히 동일하게 해당 턴은 거부를 오류로 표시합니다.

​

관측 가능성 및 청구

• 폴백으로 처리된 턴은 assistant 메시지에 fromModel과 toModel을 명명하는 provider_fallback 진단을 기록하고, 메시지의 responseModel은 claude-opus-4-8을 보고합니다.
• Anthropic은 시도별로 청구합니다. 출력 전 거절은 무료이며, 구조는 Claude Opus 4.8 요율(현재 Fable 5 요율의 절반)로 청구됩니다. OpenClaw의 턴별 비용 추정도 이에 맞춰 폴백 처리 턴을 Opus 요율로 산정합니다.
• 스트림 중간 거절은 이미 스트리밍된 Fable 부분도 Anthropic 측에서 추가로 청구합니다. 해당 부분은 API의 시도별 사용량에 보고되지만 OpenClaw의 턴별 추정에는 포함되지 않습니다.

​

범위

​

프롬프트 캐싱

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

{
  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: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}

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

​

문제 해결

​

관련 항목