Anthropic - OpenClaw : 다시 사용 가능해짐

• Anthropic 담당자가 OpenClaw 스타일의 Claude CLI 사용이 다시 허용된다고 통보함
• Anthropic API 키와 Claude CLI 재사용을 함께 지원하며, 기존 Anthropic 토큰 프로필도 실행 시 계속 인정됨
• Claude CLI 백엔드는 다시 허용된 통합 방식으로 처리되며, 새 정책 발표 전까지 claude -p 사용도 허용 대상
• Claude 4.6 모델은 명시적 thinking 설정이 없을 때 adaptive thinking을 기본 적용하며, /think:<level> 또는 모델 파라미터로 재정의 가능
• /fast 토글은 직접 api.anthropic.com으로 가는 요청에만 service_tier를 주입하며, 프록시나 게이트웨이를 거치면 tier 변경이 적용되지 않음
• prompt caching과 1M context window도 지원하지만, 캐싱은 API 전용이고 1M 컨텍스트는 명시적 활성화와 long-context 사용 허용이 필요하며 기존 sk-ant-oat-* 인증에서는 베타 헤더가 제외됨

Anthropic 지원 방식

• Claude 모델 계열 접근 경로로 API와 Claude CLI를 함께 지원하며, OpenClaw에서 Anthropic API 키와 Claude CLI 재사용 모두 사용 가능
  • 이미 설정된 기존 Anthropic 토큰 프로필도 실행 시 계속 인정됨

• Anthropic API 키

  • 표준 API 접근과 사용량 기반 과금에 적합한 경로
  • API 키는 Anthropic Console에서 생성 가능
  • CLI 설정 예시로 openclaw onboard에서 Anthropic API key 선택 가능
  • 비대화형 방식으로 openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY" 지원
  • 설정 스니펫 예시에서 ANTHROPIC_API_KEY 환경 변수와 기본 모델 anthropic/claude-opus-4-6 사용

Thinking 기본값

• Claude 4.6 모델은 OpenClaw에서 명시적 thinking 수준이 없을 때 기본값으로 adaptive thinking 적용
• 메시지별 /think:<level> 또는 모델 파라미터 agents.defaults.models["anthropic/<model>"].params.thinking로 재정의 가능
• 관련 문서로 Adaptive thinking과 Extended thinking 연결 제공

Fast mode

• OpenClaw의 공유 /fast 토글이 api.anthropic.com으로 보내는 직접 공개 Anthropic 트래픽도 지원
  • API 키 인증과 OAuth 인증 요청 모두 포함
• /fast on은 service_tier: "auto"로 매핑
• /fast off는 service_tier: "standard_only"로 매핑
• 설정 기본값 예시에서 anthropic/claude-sonnet-4-6 모델의 params.fastMode: true 사용

• 제한 사항

  • OpenClaw는 직접 api.anthropic.com 요청에 대해서만 Anthropic service tier 주입
  • anthropic/* 요청을 프록시나 게이트웨이로 우회하면 /fast는 service_tier를 변경하지 않음
  • 명시적 serviceTier 또는 service_tier 모델 파라미터가 있으면 /fast 기본값보다 우선 적용
  • Anthropic는 실제 적용된 tier를 응답의 usage.service_tier에 기록
  • Priority Tier capacity가 없는 계정에서는 service_tier: "auto"가 여전히 standard로 해석될 수 있음

프롬프트 캐싱

• OpenClaw가 Anthropic의 prompt caching 기능 지원
• 이 기능은 API 전용이며, 기존 Anthropic 토큰 인증은 캐시 설정을 반영하지 않음

• 설정

  • 모델 설정에서 cacheRetention 파라미터 사용
  • none은 캐싱 비활성화
  • short는 5분 캐시
  • long은 1시간 확장 캐시
  • 설정 예시에서 anthropic/claude-opus-4-6 모델에 params.cacheRetention: "long" 사용

• 기본값

  • Anthropic API 키 인증 사용 시 모든 Anthropic 모델에 cacheRetention: "short" 자동 적용
  • 명시적으로 cacheRetention을 설정하면 이 기본값 재정의 가능

• 에이전트별 재정의

  • 모델 수준 파라미터를 기본선으로 두고, 특정 에이전트는 agents.list[].params로 개별 재정의 가능
  • 예시에서 research는 기본 설정 사용, alerts는 cacheRetention: "none" 적용
  • 캐시 관련 파라미터 병합 순서는 agents.defaults.models["provider/model"].params 이후 agents.list[].params 순서
  • 같은 모델을 써도 한 에이전트는 장기 캐시 유지, 다른 에이전트는 캐시 비활성화 가능
  • 캐시 비활성화 목적 예시로 burst 성격 또는 재사용이 낮은 트래픽에서 쓰기 비용 회피 언급

• Bedrock Claude 참고

  • Bedrock의 Anthropic Claude 모델 amazon-bedrock/*anthropic.claude*는 설정된 경우 cacheRetention 전달 지원
  • 비 Anthropic Bedrock 모델은 실행 시 cacheRetention: "none"으로 강제
  • Anthropic API 키 기반 스마트 기본값은 명시값이 없을 때 Claude-on-Bedrock 모델 참조에도 cacheRetention: "short" 적용

1M 컨텍스트 창

• Anthropic의 1M context window는 베타 제한 기능이며, OpenClaw에서는 지원되는 Opus/Sonnet 모델마다 params.context1m: true로 활성화 가능
• 설정 예시에서 anthropic/claude-opus-4-6 모델의 params.context1m: true 사용
• OpenClaw는 이를 Anthropic 요청의 anthropic-beta: context-1m-2025-08-07 헤더로 매핑
• 이 기능은 해당 모델에서 params.context1m이 명시적으로 true일 때만 활성화
• 사용 조건으로 해당 인증 정보에서 Anthropic가 long-context usage를 허용해야 함
• 현재 Anthropic는 기존 Anthropic 토큰 인증 sk-ant-oat-* 사용 시 context-1m-* 베타 요청 거부
• 기존 인증 모드에서 context1m: true를 설정하면 OpenClaw는 경고 로그를 남기고, context1m 베타 헤더를 건너뛰며 표준 컨텍스트 창으로 대체
  • 필요한 OAuth 베타는 유지

Claude CLI 백엔드

• 번들된 Anthropic claude-cli 백엔드를 OpenClaw에서 지원
• Anthropic 직원이 이 사용 방식이 다시 허용됨이라고 전달
• 그에 따라 OpenClaw는 Anthropic가 새 정책을 발표하기 전까지 Claude CLI 재사용과 claude -p 사용을 허용된 통합 방식으로 처리
• 항상 켜진 게이트웨이 호스트와 명시적 서버 측 과금 제어에는 Anthropic API 키가 가장 명확한 운영 경로
• 설정 및 실행 세부 사항은 /gateway/cli-backends 경로 참조

참고 사항

• Anthropic의 공개 Claude Code 문서는 여전히 claude -p 같은 직접 CLI 사용을 문서화 중
• Anthropic 직원이 OpenClaw 방식의 Claude CLI 사용이 다시 허용된다고 전달했으며, Anthropic가 새 정책 변경을 발표하기 전까지 이를 확정된 지침으로 간주
• OpenClaw에서 Anthropic setup-token도 지원되는 토큰 인증 경로로 계속 제공
• 다만 사용 가능할 때는 OpenClaw가 Claude CLI 재사용과 claude -p를 더 우선하는 방식
• 인증 세부 사항과 재사용 규칙은 /concepts/oauth 경로 참조

문제 해결

• 401 errors / token suddenly invalid

  • Anthropic 토큰 인증은 만료되거나 취소될 수 있음
  • 새 설정에는 Anthropic API 키로 마이그레이션 권장

• No API key found for provider “anthropic”

  • 인증은 에이전트별 적용
  • 새 에이전트는 메인 에이전트의 키를 상속하지 않음
  • 해당 에이전트에 대해 onboarding을 다시 실행하거나, 게이트웨이 호스트에 API 키를 설정한 뒤 openclaw models status로 확인 필요

• No credentials found for profile anthropic:default

  • 어떤 인증 프로필이 활성인지 openclaw models status로 확인 가능
  • onboarding 재실행 또는 해당 프로필 경로에 API 키 설정 필요

• No available auth profile (all in cooldown/unavailable)

  • openclaw models status --json에서 auth.unusableProfiles 확인 가능
  • Anthropic rate limit cooldown은 모델 단위일 수 있어, 현재 모델이 cooldown 중이어도 같은 계열의 다른 Anthropic 모델은 사용 가능할 수 있음
  • 다른 Anthropic 프로필 추가 또는 cooldown 해제 대기 필요
  • 추가 경로로 /gateway/troubleshooting과 /help/faq 제공