Antrophic이 OpenClaw Claude CLI 사용을 다시 허용

길가다주웠어·

약 6시간·

^source^{https://docs.openclaw.ai/providers/anthropic}

Anthropic은 Claude 모델군을 만들고 API와 Claude CLI로 접근 제공.
OpenClaw는 Anthropic API 키와 Claude CLI 재사용을 모두 지원하며, 이미 설정된 기존 legacy Anthropic token profile도 런타임에서 계속 인식.
Anthropic 직원이 OpenClaw 방식의 Claude CLI 사용이 다시 허용된다고 안내했기 때문에, Anthropic이 새 정책을 내기 전까지 OpenClaw는 Claude CLI 재사용과 claude -p 사용을 이 통합에서 허용된 방식으로 취급.
장기 실행 gateway host에서는 Anthropic API 키가 여전히 가장 명확하고 예측 가능한 production 경로.
호스트에서 이미 Claude CLI를 쓰고 있다면 OpenClaw가 그 로그인을 직접 재사용 가능.
Anthropic 현재 공개 문서:
결제 경로를 가장 명확하게 가져가려면 Anthropic API 키 사용.
OpenClaw는 구독형 옵션도 지원: OpenAI Codex, Qwen Cloud Coding Plan, MiniMax Coding Plan, Z.AI / GLM Coding Plan.

옵션 A: Anthropic API 키

표준 API 접근과 사용량 기반 과금에 가장 적합.
Anthropic Console에서 API 키 생성.

CLI 설정

온보딩에서 Anthropic API 키를 선택하거나, 비대화형 옵션으로 API 키를 바로 전달.

openclaw onboard
    # choose: Anthropic API key

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

Anthropic 설정 예시

ANTHROPIC_API_KEY를 환경 변수로 넣고 기본 모델을 anthropic/claude-opus-4-6으로 지정.

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

생각 모드 기본값(Claude 4.6)

Anthropic Claude 4.6 모델은 명시적인 thinking level이 없으면 OpenClaw에서 기본값이 adaptive.
메시지별로 /think:<level>을 쓰거나 model params에서 agents.defaults.models["anthropic/<model>"].params.thinking으로 override 가능.
관련 Anthropic 문서:
- Adaptive thinking
- Extended thinking

빠른 모드(Anthropic API)

OpenClaw의 공용 /fast 토글은 api.anthropic.com으로 가는 직접 public Anthropic 트래픽도 지원.
- API 키 인증 요청과 OAuth 인증 요청 모두 포함.
/fast on은 service_tier: "auto"로 매핑.
/fast off는 service_tier: "standard_only"로 매핑.
기본 설정 예시:

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

중요한 제한사항:
- OpenClaw는 api.anthropic.com으로 직접 보내는 요청에만 Anthropic service tier를 주입.
- anthropic/*을 proxy나 gateway로 라우팅하면 /fast는 service_tier를 건드리지 않음.
- 명시적인 Anthropic serviceTier 또는 service_tier model param이 있으면 /fast 기본값보다 우선.
- Anthropic은 응답의 usage.service_tier에 실제 적용 tier를 표시.
- Priority Tier 용량이 없는 계정에서는 service_tier: "auto"도 standard로 처리될 수 있음.

프롬프트 캐싱(Anthropic API)

OpenClaw는 Anthropic의 prompt caching 기능을 지원.
이 기능은 API 전용이며, legacy Anthropic token auth에서는 cache 설정이 적용되지 않음.

설정

model config에서 cacheRetention parameter 사용.

값	캐시 기간	설명
`none`	캐싱 없음	prompt caching 비활성화
`short`	5분	API Key auth 기본값
`long`	1시간	확장 캐시

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

기본값

Anthropic API Key 인증을 쓰면 OpenClaw가 모든 Anthropic 모델에 cacheRetention: "short"를 자동 적용.
config에서 cacheRetention을 명시하면 이 기본값을 override 가능.

에이전트별 cacheRetention override

model-level params를 baseline으로 두고, 특정 agent는 agents.list[].params로 override.

{
  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
    ],
  },
}

cache 관련 param의 config merge 순서:
- agents.defaults.models["provider/model"].params
- agents.list[].params: id가 일치하면 key 단위로 override
같은 모델을 쓰더라도 agent마다 cache 정책을 다르게 둘 수 있음.
- 한 agent는 long-lived cache 유지.
- 다른 agent는 bursty하거나 재사용이 적은 트래픽에서 write cost를 피하려고 caching 비활성화.

Bedrock Claude 참고

Bedrock의 Anthropic Claude 모델(amazon-bedrock/*anthropic.claude*)은 설정된 cacheRetention을 pass-through로 받음.
Anthropic이 아닌 Bedrock 모델은 런타임에서 cacheRetention: "none"으로 강제.
Anthropic API-key smart default는 명시값이 없을 때 Claude-on-Bedrock model ref에도 cacheRetention: "short"를 넣음.

1M context window(Anthropic beta)

Anthropic의 1M context window는 beta gate 뒤에 있음.
OpenClaw에서는 지원되는 Opus/Sonnet 모델에 params.context1m: true를 모델별로 설정해 활성화.

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

OpenClaw는 이 설정을 Anthropic 요청의 anthropic-beta: context-1m-2025-08-07로 매핑.
해당 모델에 params.context1m이 명시적으로 true일 때만 활성화.
Anthropic credential에서 long-context 사용이 허용되어 있어야 함.
Anthropic은 현재 legacy Anthropic token auth(sk-ant-oat-*)를 쓰는 context-1m-* beta 요청을 거부.
- 이 legacy auth mode에서 context1m: true를 설정하면 OpenClaw는 warning을 남김.
- context1m beta header를 생략해 standard context window로 fallback.
- 필요한 OAuth beta는 유지.

Claude CLI backend

OpenClaw는 bundled Anthropic claude-cli backend를 지원.
Anthropic 직원이 이 사용 방식이 다시 허용된다고 안내.
Anthropic이 새 정책을 내기 전까지 OpenClaw는 Claude CLI 재사용과 claude -p 사용을 이 통합에서 허용된 방식으로 취급.
항상 켜져 있는 gateway host와 명시적인 server-side billing 제어에는 Anthropic API 키가 가장 명확한 production 경로.
설정과 런타임 세부사항은 /gateway/cli-backends에 있음.

참고

Anthropic의 공개 Claude Code 문서는 여전히 claude -p 같은 직접 CLI 사용을 문서화하고 있고, Anthropic 직원도 OpenClaw 방식의 Claude CLI 사용이 다시 허용된다고 안내.
Anthropic이 새 정책 변경을 내기 전까지 이 안내를 확정된 기준으로 취급.
Anthropic setup-token은 OpenClaw에서 지원되는 token-auth 경로로 계속 사용 가능.
다만 OpenClaw는 사용 가능할 때 Claude CLI 재사용과 claude -p를 더 선호.
인증 세부사항과 재사용 규칙은 /concepts/oauth에 있음.

문제 해결

401 errors / token suddenly invalid
- Anthropic token auth는 만료되거나 revoke될 수 있음.
- 새 설정에서는 Anthropic API 키로 이전.
No API key found for provider "anthropic"
- 인증은 agent별로 적용.
- 새 agent는 main agent의 key를 상속하지 않음.
- 해당 agent에서 onboarding을 다시 실행하거나 gateway host에 API 키를 설정한 뒤 openclaw models status로 확인.
No credentials found for profile anthropic:default
- openclaw models status로 어떤 auth profile이 활성 상태인지 확인.
- onboarding을 다시 실행하거나 해당 profile path에 API 키 설정.
No available auth profile (all in cooldown/unavailable)
- openclaw models status --json에서 auth.unusableProfiles 확인.
- Anthropic rate-limit cooldown은 model-scoped일 수 있어, 현재 모델이 cooldown 중이어도 sibling Anthropic 모델은 사용 가능할 수 있음.
- Anthropic profile을 하나 더 추가하거나 cooldown 종료까지 대기.
추가 자료: /gateway/troubleshooting, /help/faq.