​

Anthropic (Claude)

​

옵션 A: Anthropic API 키

​

CLI 설정

openclaw onboard
# choose: Anthropic API key

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

​

Anthropic config 스니펫

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

​

Thinking 기본값 (Claude 4.6)

• Anthropic Claude 4.6 모델은 명시적인 thinking 수준이 설정되지 않은 경우 OpenClaw에서 기본적으로 adaptive thinking을 사용합니다.
• 메시지별(/think:<level>) 또는 model params의 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"에 매핑됩니다
• Config 기본값:

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

• OpenClaw는 직접 api.anthropic.com 요청에 대해서만 Anthropic service tier를 주입합니다. anthropic/*를 프록시나 gateway를 통해 라우팅하는 경우 /fast는 service_tier를 변경하지 않습니다.
• 명시적인 Anthropic serviceTier 또는 service_tier model params가 설정되면 /fast 기본값보다 우선합니다.
• Anthropic은 응답의 usage.service_tier 아래에 실제 적용된 tier를 보고합니다. Priority Tier 용량이 없는 계정에서는 service_tier: "auto"가 여전히 standard로 해석될 수 있습니다.

​

프롬프트 캐싱 (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" }, // 대부분의 agent용 기준값
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } }, // 이 agent에만 적용되는 재정의
    ],
  },
}

1. agents.defaults.models["provider/model"].params
2. agents.list[].params (id가 일치하는 항목, 키별로 재정의)

​

Bedrock Claude 참고

• Bedrock의 Anthropic Claude 모델(amazon-bedrock/*anthropic.claude*)은 구성 시 cacheRetention 전달을 허용합니다.
• Anthropic이 아닌 Bedrock 모델은 런타임에서 강제로 cacheRetention: "none"이 됩니다.
• Anthropic API 키 스마트 기본값은 명시적인 값이 설정되지 않은 경우 Claude-on-Bedrock model ref에도 cacheRetention: "short"를 기본 적용합니다.

​

1M context window (Anthropic beta)

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

​

Claude CLI backend

• Anthropic 직원이 이 사용 방식이 다시 허용된다고 알려주었습니다.
• 따라서 Anthropic이 새로운 정책을 발표하지 않는 한 OpenClaw는 Claude CLI 재사용과 claude -p 사용을 이 통합에서 허용된 것으로 간주합니다.
• Anthropic API 키는 상시 실행되는 gateway 호스트와 명시적인 서버 측 과금 제어를 위한 가장 명확한 프로덕션 경로로 남아 있습니다.
• 설정 및 런타임 세부 사항은 /gateway/cli-backends에 있습니다.

​

참고

• Anthropic의 공개 Claude Code 문서는 여전히 claude -p 같은 직접 CLI 사용을 문서화하고 있으며, Anthropic 직원도 OpenClaw 방식의 Claude CLI 사용이 다시 허용된다고 알려주었습니다. Anthropic이 새로운 정책 변경을 발표하지 않는 한 이 지침을 확정된 것으로 보고 있습니다.
• Anthropic setup-token은 OpenClaw에서 계속 지원되는 token 인증 경로로 제공되지만, 이제 OpenClaw는 가능할 때 Claude CLI 재사용과 claude -p를 우선합니다.
• 인증 세부 사항 및 재사용 규칙은 /concepts/oauth에 있습니다.

​

문제 해결

• Anthropic token 인증은 만료되거나 취소될 수 있습니다.
• 새 설정의 경우 Anthropic API 키로 마이그레이션하세요.

• 인증은 agent별입니다. 새 agent는 메인 agent의 키를 상속하지 않습니다.
• 해당 agent에 대해 onboarding을 다시 실행하거나 gateway 호스트에 API 키를 구성한 뒤 openclaw models status로 확인하세요.

• 어떤 인증 profile이 활성 상태인지 보려면 openclaw models status를 실행하세요.
• onboarding을 다시 실행하거나 해당 profile 경로에 대한 API 키를 구성하세요.

• auth.unusableProfiles를 확인하려면 openclaw models status --json을 사용하세요.
• Anthropic rate limit cooldown은 model 범위일 수 있으므로, 현재 모델이 cooldown 중이어도 다른 Anthropic 모델은 여전히 사용할 수 있습니다.
• 다른 Anthropic profile을 추가하거나 cooldown이 끝날 때까지 기다리세요.